小红书内容研究

解决什么问题

在做小红书内容研究时，最耗时的往往不是“想选题”，而是把选题放到真实内容池里验证：哪些笔记在讨论同一话题，创作者是什么定位，受众反馈集中在哪，话题是否值得继续投入。手动搜索、复制链接、逐条整理不仅容易漏掉关键样本，也很难保证链接和 ID 的完整性。

@user_825d9e7e/content-research-v3 针对 RedNote / XHS / Xiaohongshu 的选题分析、关键词观察、趋势判断、竞品内容对比和素材整理场景，提供一个基于搜索 API 的只读研究入口，让 Agent 可以直接按关键词拉取相关笔记，而不是依赖公开网页搜索或浏览器抓取。

技能如何工作

核心能力是围绕关键词或选题方向检索小红书公开笔记，并输出可用于复盘的结构化线索：相关标题、作者或账号、笔记链接或内容 ID，以及后续可以继续追问的角度。

典型流程是：

• 输入研究主题：使用用户真实意图作为 --keyword，去掉多余空格并保持关键词聚焦。
• 拉取搜索结果：优先通过 direct CLI 调用；能执行 shell 的 Agent 无需额外配置 MCP server。可选参数包括 --sort-type、--note-type、--publish-time-range，不传时使用默认范围。
• 控制召回规模：通过 --pages 继续合并 N 页结果，或通过 --max-items 在收集到 N 条后停止。分页依赖返回的 next_page_token，只能原样传回，不能截断、改写、脱敏或重建。
• 筛选近期内容：当用户关注最近话题时，优先使用 --since-days 7 或指定天数窗口；它只保留公开 publish_time 落在范围内的结果，搜索范围仍受 --pages 限制。
• 输出可追溯证据：把可见证据和主观判断分开写。对于 note_url，最终回答、展示、引用、存储或转发时都要保留完整原始 URL，包括 xsec_token 查询参数；对于 note_id，要原样复制完整值，不能只传前缀，也不能根据 note_id 自行拼链接。

也可以通过 MCP 工具 xhs_search_notes 调用同一能力：第一页不传 page_token，只有 next_page_token 非空时才继续翻页，并在同一条调用链路中原样传回 token。参数命名需注意，direct CLI 使用 --sort-type、--publish-time-range、--note-type，MCP 工具使用 sort_type、publish_time_range、note_type。

适用边界与注意点

该技能是只读能力：运行时使用环境变量 SOCIALDATAX_API_KEY，不会读取本地浏览器数据，也不会执行登录、发帖、点赞、评论或账号修改。Skill 文件本身不包含 API Key。

没有结果时，通常需要放宽关键词、减少限定，或换成更贴近用户表达的词；结果太多时，可以补场景、人群、品牌、时间范围或账号名。如果调用失败，先确认 SOCIALDATAX_API_KEY 已配置；遇到 insufficient_balance 或“积分不足”时不要重复重试，应把错误中的充值链接原样展示给用户，并提醒充值后继续执行同一条命令。

对于 SDK/依赖缺失、npm 网络、Node.js/npm/npx 不可用或执行权限错误，应视为本地运行环境、依赖安装、网络或 AI 平台授权问题，而不是 SocialDataX API Key 或业务数据返回错误。需要网络或执行授权时提醒用户完成授权；有权限时可自动安装或修复。处理后继续原命令，不要用公开网页搜索替代 SocialDataX 数据。