技能介绍

小红书数据采集的痛点

做小红书运营或竞品分析的人都知道，拿数据有多麻烦：在 App 里按关键词翻笔记、逐篇点开复制互动数据、手动记录博主最近的发文节奏、再滚动评论区一条条整理观点。一次调研动辄几小时，结果散落在截图和复制粘贴里，没法直接交给脚本做聚合和报告。

这个技能要解决的问题很明确：把采集从“人肉操作”变成可重复的结构化输出。

四类能力与调用方式

技能只覆盖小红书公开数据，内部拆成四个脚本：

关键词搜索（src/xiaohongshu/search-cli.js）：按关键词拉笔记列表，配合筛选参数可细化笔记类型、排序规则和发布时间范围，一次最多拉 1 万条
笔记详情（src/xiaohongshu/detail-cli.js）：根据笔记链接返回标题、正文、作者与互动信息
博主作品监控（src/xiaohongshu/post-cli.js）：根据博主主页链接返回其公开作品列表，用于观察发文节奏与选题分布
笔记评论获取（src/xiaohongshu/comment-cli.js）：单独拉一篇笔记的评论内容与评论者信息，适合做观点聚类和情绪分析

调用前需在官网开通 token 并配置环境变量 GUAIKEI_API_TOKEN。技能按输入信号自动路由：给关键词走搜索，给笔记链接走详情或评论，给主页链接走博主监控。输出统一为 JSON，带 status 字段（success / empty / error），下游程序应先按 status 分支，再参考 error_code 决定重试还是换输入。

适用边界与注意事项

只处理公开数据：不涉及登录态、私密或隐藏内容，也不支持发帖、点赞、评论、关注等互动动作
不做营销决策判断：技能只负责把数据拿回来，分析、对比和结论交给上层流程
链接类型必须匹配：笔记链接传给博主脚本、主页链接传给评论脚本都会返回业务错误；xhslink.com / xhslink.cn 短链不透明，无法仅凭短链判断类型，结果异常时要让用户补全链接
limit 超过 10000 会被静默降到 10，而不是报错；emoji 或纯符号关键词会被清洗为空并触发拦截

遇到 429、5xx 或 ERRCODE_xxx 时按 SKILL.md 的排查建议分别处理：降频、等待重试或换输入；失败时不要编造数据。