---
id: autoclaw-cc/xiaohongshu-mcp-skills/xhs-search
version: "feb6b00e"
license: MIT
install: manual
updated: 2026-03-05
---

# 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.

Publisher: autoclaw-cc · Stars: 239 · Updated: 2026-03-05

Install (manual): `git clone https://github.com/autoclaw-cc/xiaohongshu-mcp-skills`

## SKILL.md

## 执行流程

### 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 登录 |
| 无搜索结果 | 建议调整关键词或筛选条件 |


[View on SkillFed](https://skillfed.io/autoclaw-cc/xiaohongshu-mcp-skills/xhs-search) · [View on GitHub](https://github.com/autoclaw-cc/xiaohongshu-mcp-skills)