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
Decision gist · record as of 2026-03-05
xhs-search lets you find Xiaohongshu notes by keyword with multi-dimensional filtering options. 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.
Use it when
- xhs-search supports multiple filter dimensions to refine your search.
- Yes, xhs-search allows you to sort and filter search results by both engagement metrics and recency.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
autoclaw-cc/xiaohongshu-mcp-skills/xhs-search
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently 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 登录 |
| 无搜索结果 | 建议调整关键词或筛选条件 |
File tree — 1 file
skills/xhs-search/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Search for notes and content on Xiaohongshu by keyword”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
xhs-interact lets you automate engagement on Xiaohongshu notes—liking, favoriting, posting comments, and replying to existing ones. The skill routes your intent to the right action, handles confirmation for comments and replies (which can't be undone), and executes reversible operations like likes and favorites directly.
xhs-profile fetches a Xiaohongshu user's profile page, including basic details, follower and engagement metrics, and their recent published posts. Use it to explore any creator's account information and content history.
Post-to-xhs automates publishing to Xiaohongshu by handling both image and video notes. The skill collects your title, content, and media, validates against platform constraints, shows a preview for confirmation, then publishes directly.
xhs-explore lets you browse Xiaohongshu's recommendation feed and access individual note details with full comment threads. Retrieve recommended notes from your home feed, then drill into specific posts to see content, images, author info, and engagement metrics.
This skill helps you research and plan Xiaohongshu content by searching for trending posts, analyzing high-performing competitors, and identifying popular topics in your niche. It pulls detailed insights from viral posts—including title techniques, content structure, hashtag strategies, and audience engagement patterns—then synthesizes those findings into actionable recommendations for your own content direction.
xhs-login handles Xiaohongshu account access by checking login status, generating QR codes for mobile app authentication, and resetting sessions to switch accounts. The skill guides users through each step and handles timeouts by regenerating codes when needed.
More skills setup-xhs-mcp (MIT) · Xiaohongshu Mcp Skill (unlicensed) · xiaohongshu-skills (MIT) · Openclaw Xhs (NOASSERTION)