xhs-search

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，按上面"呈现格式"组织输出