xhs-viral-note-researchlisted

<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. --> # 小红书爆款笔记研究 ## 适用场景 当用户给出小红书关键词、赛道、人群或产品方向，想看热门高互动笔记样本，并拆解标题结构、内容角度、互动信号、创作灵感和选题参考时使用。 ## 快速开始 - 先给出当前 skill 支持的输入：关键词或选题方向。 - 默认取 2 页、最多 20 条样本；如果只是试跑，可以把 `--pages` 改成 1 或降低 `--max-items`。 - 你通常会得到：热门高互动样本、标题钩子、内容角度、互动信号和可复用选题。 ## API Key 获取 获取或管理 API Key：访问 <https://socialdatax.com/ai?from=modelscope>，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。 ## 直接调用命令 优先使用 direct CLI；能运行 shell 命令的 Agent 不需要额外配置 MCP server： ```bash npx -y socialdatax-skills@latest xhs search \ --keyword "<keyword>" --sort-type like_count_descending --pages 2 --max-items 20 \ --pretty --source-client socialdatax-skills --source-platform modelscope \ --source-skill xhs-viral-note-research ``` ## 参数说明 搜索： - 必填：`--keyword <text>`：内容研究主题；使用用户真实意图，去掉多余空格，并保持关键词聚焦。 - 可选：`--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`：可选排序参数；不传就使用默认排序。 - 可选：`--note-type <all|image|video>`：可选内容类型筛选；默认是 `all`。 - 可选：`--publish-time-range <all|day|week|half_year>`：可选发布时间筛选；默认是 `all`。 - 可选：`--pages <n>`：从当前起点继续获取并合并 N 页搜索结果；如果返回了 `next_page_token`，可继续续页。 - 可选：`--max-items <n>`：收集到 N 条搜索结果后停止。 - 可选：`--since-days <1-365>`：只保留最近 N 天内公开 `publish_time` 落在范围内的搜索结果；搜索范围仍受 `--pages` 限制。 通用： - 可选：`--page-token <next_page_token>`：这是不透明的分页 token；第一页不要传。继续同一条搜索链路时，只能原样传回完整返回的 `next_page_token`，不能截断、改写、脱敏、重建，或用省略号替