社媒内容研究

它解决什么问题

在小红书定选题时，拍脑袋容易写出没人看的笔记。靠谱的做法是先看样本再定方向：这个话题谁在写、标题用了什么钩子、受众反馈如何。这个技能针对的就是「从零调研一个选题」的冷启动问题：输入一个关键词或选题方向，拿回带作者、链接和可追问角度的结果列表。

核心能力

• 必填输入只有 --keyword，即研究主题，按用户真实意图填写
• 返回结果包含相关标题、作者/账号、链接或内容 ID
• 支持 --sort-type（排序）、--note-type（内容类型）、--publish-time-range（发布时间）三类过滤
• 分页用 --pages 或 --page-token：返回的 next_page_token 必须原样完整传回，不能截断、改写或重建
• 时间窗口用 --since-days，例如 --since-days 7 只保留最近一周公开发布的结果
• 用量控制用 --max-items，收集到 N 条后停止
• 两种调用方式：能跑 shell 的 Agent 走 direct CLI；否则用对应的 MCP 工具 xhs_search_notes
• 注意参数命名差异：CLI 用 --sort-type，MCP 用 sort_type，不要传 sortType 这类写法

输出约定

输出按可直接复盘的结构组织：样本（标题/作者/链接或 ID）与判断分开写，再列出下一步可继续追问的问题。要看最近话题时优先 --since-days 7，且不要把返回的几页描述为全平台完整覆盖。涉及 note_url 和 note_id 时保持原始值完整，尤其不要丢掉 URL 里的 xsec_token 参数。

适用边界

• 只读技能：不登录、不发帖、不点赞、不评论，不读取本地浏览器数据
• 需要环境变量 SOCIALDATAX_API_KEY，通过 SocialDataX 官网申请管理
• 返回 insufficient_balance 时按错误里的充值链接充值，然后重跑原命令，不要反复重试
• 依赖缺失、npm 网络、执行权限等报错属于本地运行环境问题，不是 API Key 或数据返回错误，不要用公开网页搜索替代 SocialDataX 数据