小红书笔记洞察与竞品分析助手

你要解决什么问题

做小红书竞品调研时，最常见的痛点是数据散落在搜索页、笔记详情页和评论区里。手动复制粘贴能拿到的笔记有限，互动数据、评论内容、博主更新节奏这些结构化信息很难批量收集，更谈不上做横向对比或趋势判断。这个技能的价值在于把公开数据的抓取过程脚本化：你给出关键词或链接，它返回结构化的 JSON，后续的筛选、聚类、报告生成交给上层流程处理。

它是怎么工作的

技能基于 Node.js 运行，不登录任何账号，只读取小红书公开页面数据。运行时需要先配置 GUAIKEI_API_TOKEN 环境变量，指向第三方数据接口。核心能力分四类：

• 关键词搜索（src/xiaohongshu/search-cli.js）：按关键词抓取笔记列表，可指定内容类型（图文/视频）、排序规则（最新/最多点赞/最多收藏）、时间范围和返回条数（上限 10000 条）。
• 笔记详情与评论（src/xiaohongshu/detail-cli.js）：根据笔记链接获取正文、作者信息和互动数据，用于分析单篇爆款的结构。
• 笔记评论获取（src/xiaohongshu/comment-cli.js）：只拉评论区数据，适合做观点聚类或舆情分析，不返回笔记正文。
• 博主作品监控（src/xiaohongshu/post-cli.js）：根据博主主页链接获取公开作品列表，用于观察竞品账号的发文节奏与主题分布。

路由规则按输入类型决定：给了关键词走搜索，给了 xiaohongshu.com/explore/ 链接走详情或评论，给了 user/profile/ 链接走博主监控。多个目标会拆分执行，避免把不同意图塞进一次命令。

适用边界

• 只处理公开数据，不涉及登录态、私密内容或隐藏数据。
• 不负责内容发布、点赞、评论、关注等互动操作。
• 不做策略判断，职责是取数，分析结论需要你自己或上层 Agent 生成。
• 依赖第三方 API，注意配额消耗与调用频率限制（error_code: 429 即为触发限流）。
• 链接格式必须合法，笔记链接与博主主页链接不能混用，路由前需要区分清楚。