xhs-search
xhs-search enables keyword-based discovery across Xiaohongshu's note library with flexible filtering by sort order, content format, publish date, and geographic scope. Results display engagement metrics and author details, with direct access to note exploration and interaction features.
xhs-search lets you find Xiaohongshu notes by keyword with multi-dimensional filtering options.
AI-generated summary based on this skill's SKILL.md
Install
autoclaw-cc/xiaohongshu-mcp-skills/xhs-search
git clone https://github.com/autoclaw-cc/xiaohongshu-mcp-skills
cp -r xiaohongshu-mcp-skills/skills/xhs-search ~/.claude/skills/xhs-searchnpx skillfed install autoclaw-cc/xiaohongshu-mcp-skills/xhs-searchFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I search for notes and content on Xiaohongshu by keyword?
xhs-search lets you search notes across Xiaohongshu using keyword queries. Enter your search term to discover relevant content from the platform's note library. The skill displays results with engagement metrics and author information, giving you quick access to explore notes and interact with them directly.
What filtering options does xhs-search provide for search results?
xhs-search supports multiple filter dimensions to refine your search. You can sort results by engagement level or recency, filter by content format (video or image-based notes), narrow results by publish date, and scope content to specific geographic locations. These flexible filters help you find exactly what you're looking for.
Can I sort and filter search results by engagement or recency?
Yes, xhs-search allows you to sort and filter search results by both engagement metrics and recency. This means you can view the most popular or most recent notes matching your keywords, making it easy to discover trending content or the latest posts on your topic of interest.
Does xhs-search support location-based or time-scoped content discovery?
xhs-search enables you to discover location-based and time-scoped content. You can filter results by geographic scope to find notes from specific regions, and narrow results by publish date to see content from particular time periods. This helps you find locally relevant or timely information.
Can I browse video or image-based notes with custom criteria?
xhs-search supports browsing video and image-based notes with custom filtering criteria. You can specify content format preferences alongside other filters like sort order, date range, and location to find visual content that matches your exact needs on Xiaohongshu.
What information does xhs-search display about search results?
xhs-search displays comprehensive result information including engagement metrics (likes, comments, shares) and author details for each note. This context helps you evaluate content quality and credibility before deciding which notes to explore further on Xiaohongshu.
SKILL.md
rendered from the published skill — quoted content, verbatim
执行流程
1. 确认搜索条件
从用户输入中提取：
- keyword（必填）— 搜索关键词
- filters（可选）— 筛选条件
2. 调用搜索
调用 search_feeds：
- keyword（string，必填）
- filters（object，可选）：
- sort_by：综合 | 最新 | 最多点赞 | 最多评论 | 最多收藏
- note_type：不限 | 视频 | 图文
- publish_time：不限 | 一天内 | 一周内 | 半年内
- search_scope：不限 | 已看过 | 未看过 | 已关注
- location：不限 | 同城 | 附近
3. 展示结果
将搜索结果整理为列表展示，每条包含：
- 标题、作者
- 点赞数、评论数、收藏数
- feed_id 和 xsec_token（后续操作需要）
提示用户可以： - 查看某条笔记详情（使用 xhs-explore） - 对笔记进行互动（使用 xhs-interact）
失败处理
| 场景 | 处理 |
|---|---|
| 未登录 | 引导使用 xhs-login 登录 |
| 无搜索结果 | 建议调整关键词或筛选条件 |
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/xhs-search/SKILL.md