guaikei-xhs-search-results

小红书搜索结果

guaikei 出品，专注小红书公开数据采集。无需登录账号，不触发风控；一次最多获取 10000 条结构化数据，返回 JSON 供后续分析、汇总或报告生成。

---

1. 四大能力

详情 vs 评论的区别：detail-cli.js 返回笔记正文 + 评论（适合看全貌）；comment-cli.js 只返回评论数据（适合专注评论洞察、观点聚类、舆情分析）。

---

2. 触发规则

应该调用

• 用户明确提到小红书 / 红笔记 / xhs / rednote，想搜内容、看笔记、查评论、监控博主。
• 用户给出 xiaohongshu.com 或 xhslink.com 链接，想获取笔记或博主数据。
• 用户要做爆款挖掘、竞品分析、KOL 筛选、评论洞察、趋势调研等小红书相关任务。
• 用户没明说"小红书"但提到"红笔记/xhs/rednote"或给出上述链接并想拿内容数据。

不应调用

• 用户只想写文案、改标题、生成脚本，但没要求查小红书数据。
• 用户查询的平台是抖音、B 站、微博、公众号等非小红书平台。
• 用户要求登录账号、发布内容、点赞、评论、关注或获取私密数据。
• 用户既没给关键词也没给链接，且任务目标不明确——先追问，别盲目执行。

---

3. 调用路由

根据用户输入判断走哪个脚本：

路由细则：

• 短链 xhslink.com/m/xxx 无法仅凭 URL 判断指向笔记还是博主主页。若结果异常，优先请用户提供完整链接。
• 把博主主页链接传给 detail-cli.js / comment-cli.js，或把笔记链接传给 post-cli.js，都会触发业务错误。
• 用户同时有多个目标时，拆分执行，不要把不同意图塞进一次命令。

---

4. 参数说明

4.1 关键词搜索（search-cli.js）

4.2 笔记详情 / 博主作品 / 笔记评论（detail / post / comment）

---

5. 输入收集

执行前确认输入齐备，缺关键参数时先追问：

链接格式要求：以 https:// 开头，无前后空格，属于以下之一：

• https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy（笔记）
• https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy（博主主页）
• https://xhslink.com/m/xxx 或 xhslink.cn/m/xxx（短链，指向不明确）

---

6. 执行与输出

执行

# 搜索
node src/xiaohongshu/search-cli.js --keyword "夏季穿搭" --type 2 --sort 2 --time 2 --limit 20

# 笔记详情
node src/xiaohongshu/detail-cli.js --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy"

# 博主作品
node src/xiaohongshu/post-cli.js --url "https://www.xiaohongshu.com/user/profile/xxx?xsec_token=yyy" --limit 20

# 笔记评论
node src/xiaohongshu/comment-cli.js --url "https://www.xiaohongshu.com/explore/xxx?xsec_token=yyy" --limit 100

输出

返回结构化 JSON，包含 status（success / empty / error）、results（数据或 null）、skill_metadata（执行信息）。输出后可衔接：

• 选题汇总 / 高赞笔记对比
• 评论观点聚类 / 情绪分析
• 竞品内容风格总结 / 博主发文节奏分析
• 报告与表格生成

失败处理

失败时不编造数据，不把空结果当成功。向用户说明原因并给出下一步建议：

---

7. 能力边界

能做：

• 按关键词搜索小红书公开笔记
• 查看单篇笔记详情与评论
• 获取博主公开作品列表
• 单独拉取笔记评论数据

不能做：

• 登录小红书账号
• 发布内容、点赞、评论、关注
• 获取私密、隐藏或需登录态的数据
• 代替用户做营销策略判断

职责定位：先把数据拿回来，交给上层流程分析、整理或生成结论。

---

8. 反模式与 FAQ

反模式（以下做法都会导致失败或错误数据）

• 链接类型错配：博主主页传给 detail/comment，笔记链接传给 post。
• 误信短链类型：短链指向不明确，结果异常时优先要完整链接。
• 缺关键输入硬跑：没 keyword / url 就执行命令。
• 传脏链接：带空格、用 http:// 非 https:// 的链接被拒。
• limit 超限被静默降级：超过 10000 会降到默认 10，不是"没返回"。
• 空结果当成功：search 无结果时退出码 1，不要编造结论。
• 关键词喂纯符号：emoji / 纯符号被清洗成空串，触发"关键词无效"。
• 假设失败也输出成功字段：失败时 status 是 error/empty，results 为 null。

FAQ 自助排查

---

9. 环境与依赖

• 运行环境：Node.js 16.14.0+
• 系统兼容：Windows / Linux / macOS
• 必需环境变量：GUAIKEI_API_TOKEN
• 官方入口：https://www.guaikei.com
• 参数详细说明：见 references/options.md
• 更新记录：见 references/changelog.md

---

10. 合规与使用限制

• 仅处理小红书公开数据，不支持私密、隐藏或需登录态的数据。
• 不应将返回数据用于违规分发或违法用途。
• 本技能依赖第三方 API 服务（guaikei.com），使用前请确认数据外发与授权范围。

---

11. 支持信息

• 官网：guaikei.com
• 开发者微信：13395823479（备注：小红书技能）