| name | xhs-search |
| description | 搜索小红书 (Xiaohongshu) 笔记。**只要用户消息里出现「小红书」/「xhs」/「xiaohongshu」（任何形式、任何上下文）就必须触发本 skill 去搜**，不需要等 '搜/查/看看' 之类的动词。包括但不限于：'搜小红书 X' / '小红书搜 X' / '小红书查 X' / '小红书看看 X' / 'xhs 搜 X' / 'xhs search X' / '小红书上有没有 X' / '小红书怎么说' / 'xhs 上 X 怎么样' / '小红书有人说 X' / 用户随口提到 '小红书' 这三个字。从用户消息里推断查询词（去掉 '小红书'/'xhs' 这些触发词本身），然后调本地 Spider_XHS 项目搜出 title/author/likes/URL（必要时 desc/comments）。 |
搜小红书 (xhs-search)
调用本地 ~/Desktop/claude-skills/Spider_XHS 项目搜索小红书笔记并把结果整理给用户看。
触发（重要）
只要用户消息里出现以下任何一个词，立即触发本 skill 去搜，不要先反问用户：
- 「小红书」（任何位置、任何上下文）
- 「xhs」（大小写都算）
- 「xiaohongshu」（大小写都算）
- 「rednote」/「red note」（小红书海外名）
包括但不限于这些说法：
- "搜小红书 <关键词>" / "小红书搜<关键词>" / "小红书搜一下 <关键词>"
- "小红书查 <关键词>" / "小红书看看 <关键词>"
- "xhs 搜 <关键词>" / "xhs search <关键词>"
- "小红书上有没有 X" / "小红书有人讲 X 吗" / "小红书怎么说 X"
- "xhs 上 X 怎么样" / "X 在小红书上口碑如何"
- 用户只是随口提到「小红书」三个字 → 也触发，按上下文推断 query
查询词怎么从消息里提取
去掉触发词本身（「小红书」「xhs」「xiaohongshu」「搜」「查」「看看」「搜一下」），剩下的就是 query。如果上下文里有具体话题（比如刚在讨论"伦敦签证"），用那个话题做 query。不确定就用最显著的名词短语，先搜再说，不要反问。
如何执行
固定用项目的 venv 跑 cli/search.py。一行命令（必须包含 source .venv/bin/activate）：
cd ~/Desktop/claude-skills/Spider_XHS && source .venv/bin/activate && python cli/search.py "<关键词>" -n <数量> [其它参数]
参数
| 参数 | 默认 | 何时改 |
|---|
-n N | 10 | 用户没指定数量 → 用 5；说"多一点" → 10；说"很多" → 20 |
--sort 0|1|2|3|4 | 0 综合 | 用户说"最新" → 1；"最火/最多赞" → 2；"评论最多" → 3 |
--type 0|1|2 | 0 不限 | "只看视频" → 1；"只看图文" → 2 |
--time 0|1|2|3 | 0 不限 | "最近一天" → 1；"这周" → 2；"半年" → 3 |
--detail | off | 用户明确说要正文 / 简介 / 评论数 / 收藏数 时加；否则不加（每条会多一次详情请求，慢且容易触发风控） |
输出格式
stdout 是 JSON 数组，每条形如：
{
"id": "6a01a5b300000000360015fa",
"title": "🇬🇧英国签证建议：别太相信xhs的攻略",
"author": "签证百事通",
"likes": "214",
"type": "normal",
"url": "https://www.xiaohongshu.com/explore/...?xsec_token=..."
}
加 --detail 还会有 desc / comments / collects。
stderr 出错时输出 {"error": "..."} 并 exit 非 0。
怎么把结果展示给用户
默认呈现格式（简洁版）：
搜到 N 条「<关键词>」相关笔记：
1. [214 赞] 🇬🇧英国签证建议：别太相信xhs的攻略
作者：签证百事通
https://www.xiaohongshu.com/explore/...
2. ...
要点：
likes 字段是字符串，可能是 "214" 也可能是 "1.2w"，原样展示- URL 整行单独一行（带 xsec_token，xsec_token 24h 内有效，超时要重搜）
- 用户问"哪个最值得看"——按 likes 数（注意 "1.2w" 这种）排序挑前 1-2 条扼要解释
- 用户问"这条说了啥"——再调一次
--detail 或对单条调 get_note_info
常见错误处理
| 错误信号 | 含义 | 怎么办 |
|---|
| stderr 含 "登录" / "权限" / "461" / "401" | cookie 过期 | 提示用户重新登录小红书取 cookie 写入 ~/Desktop/claude-skills/Spider_XHS/.env |
| stderr 含 "COOKIES not set" | 没配 cookie | 同上 |
| stderr 含 "请求过于频繁" / "300031" | 触发风控 | 提示用户等几分钟再试，或挂代理 |
| 长时间不返回（>60s） | 网络/JS 引擎卡 | 杀掉重试，多次仍然 → 提示用户检查网络 |
不要做的事
- ❌ 不要用
python -m spider.spider（它会下载图片视频到 datas/）
- ❌ 不要直接装 pip 包到系统（这个项目必须用
~/Desktop/claude-skills/Spider_XHS/.venv）
- ❌ 不要把搜出来的 URL 当作永久链接保存——xsec_token 会过期
- ❌ 不要给用户大段贴 JSON，按上面"呈现格式"组织输出
