技能介绍

这篇博客要解决的问题

内容团队和市场分析师在做小红书调研时，最耗时间的往往不是「看几条笔记」，而是把散落在搜索列表、笔记详情页、评论区和博主主页里的公开信息汇总成可分析的结构。手动复制会带来两个具体麻烦：一是数据口径不一致（这次取到的是点赞数，下次忘记取收藏数），二是难以批量化（想监控某个竞品博主最近 20 条作品，逐页翻很容易漏）。@user_fb71c45d/guaikei-rednote-intel 就是为了把这一层重复劳动自动化。

它具体覆盖什么能力

SKILL.md 明确列出四类脚本，每类都有固定入口：

关键词搜索：src/xiaohongshu/search-cli.js，输入关键词，返回笔记列表、作者信息与互动数据。可选 --type（全部/视频/图文）、--sort（综合/最新/点赞最多等）、--time（一天内/一周内/半年内）和 --limit（1–10000）。
笔记详情：src/xiaohongshu/detail-cli.js，输入笔记 URL，返回标题、正文与作者信息。
博主作品监控：src/xiaohongshu/post-cli.js，输入 user/profile/... 主页链接，拉取公开作品列表。
笔记评论获取：src/xiaohongshu/comment-cli.js，输入笔记 URL 单独拉评论，适合做观点聚类或情绪分析，不返回笔记正文。

上手前需要知道的几件事

调用前先补 GUAIKEI_API_TOKEN 环境变量，这是运行前提；同时确认输入类型匹配：笔记链接走 detail/comment，主页链接走 post，反向使用会返回业务错误。短链 xhslink.com/m/... 是不透明跳转，无法从短链外观判断指向笔记还是主页，结果异常时优先索要完整 URL。

几个容易踩的坑：--limit 超过 10000 会被静默降到 10，不是没返回；emoji 或纯符号关键词会被清洗成空串；search-cli.js 搜不到结果按失败处理（退出码 1），而 detail/comment 返回空数组算成功，下游解析时先盯 status 字段。