前言¶

做抖音内容时，选题往往卡在「不知道搜什么、结果散在网页里、难和 AI 一起往下拆」。常见做法是手动刷热榜、复制标题到文档，再让模型凭记忆发挥——样本不可追溯，角度也容易偏。下面介绍 SkillHub 上的 抖音选题分析（@user_825d9e7e/douyin-topic-analysis）：把选题策划、爆款角度拆解和素材整理写成 Agent 可执行的 Skill，通过 SocialDataX 的只读接口拉取抖音搜索与热榜数据，输出可复盘的标题、作者、链接或内容 ID。

这是什么¶

抖音选题分析 是社区来源（community）的内容创作类 Skill，当前版本 1.0.9，坐标 @user_825d9e7e/douyin-topic-analysis，由发布者 user_825d9e7e 维护；底层能力来自 socialdatax-skills，在 SkillHub 分类为 content-creation，并标注 requires_api_key=true。

当用户需要做抖音选题、短视频选题策划、爆款角度拆解、内容方向规划或选题素材整理时，Agent 会按 SKILL.md 引导：先确认关键词或选题方向，再调用 CLI 或 MCP 取数，最后按 Skill 要求整理样本与可追问角度。面向内容运营、品牌调研和创作者。

核心功能¶

以下能力均来自已安装的 Skill 包（v1.0.9）中的 SKILL.md：

1. 关键词搜索：douyin search --keyword <text>，支持排序、发布时间、时长、内容类型等筛选，并可分页（--pages、--page-token、--max-items）。
2. 热榜：douyin hot-search，无需关键词，用于查看当前热榜排名与热度信号。
3. 结构化返回：命令输出 JSON，含 platform、tool、arguments、data；多页搜索会合并到 data.items，并附带 page_count、item_count 及下一页标记。
4. 输出规范：Skill 要求把「可见证据」与「判断」分开写，保留标题、作者、链接或 ID、指标与发布时间；图文结果使用返回的 images 字段。
5. MCP 可选路径：与 CLI 对应的工具包括 douyin_search_videos；热榜对应 douyin_get_hot_search_list（调用时不传关键词参数）。
6. 安全边界：只读；使用环境变量 SOCIALDATAX_API_KEY，不登录、不发帖、不点赞、不评论，也不读取本地浏览器数据。

运行依赖 Node.js、npm/npx，以及已配置的 SOCIALDATAX_API_KEY。API Key 在 SocialDataX AI 页面 申请与管理。

安装与启用¶

方式一：让 Agent 按官方指引安装¶

将下面提示词发给支持 Skill 的 AI（安装步骤以 SkillHub 文档为准）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_825d9e7e/douyin-topic-analysis`。

方式二：SkillHub CLI¶

先确认本机已安装 skillhub（未安装时可参考 SkillHub 安装文档 执行 curl 安装脚本）。安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。

command -v skillhub && skillhub --version

skillhub install @user_825d9e7e/douyin-topic-analysis --dir ~/.cursor/skills/

常用路径（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装后配置 API Key（变量名固定为 SOCIALDATAX_API_KEY）：

export SOCIALDATAX_API_KEY="你的密钥"

Skill 元数据会通过 npm 包 socialdatax-skills 拉取 CLI 能力；具体依赖以 Skill 内 metadata.openclaw.install 为准。

典型用法¶

1. 按关键词搜样本（先看一页）¶

适合「有一个方向，想先看相关标题和账号」。在能执行 shell 的 Agent 环境中，优先使用 direct CLI：

npx -y socialdatax-skills@latest douyin search \
  --keyword "职场穿搭" --pretty \
  --source-client socialdatax-skills \
  --source-platform skillhub \
  --source-skill douyin-topic-analysis

Skill 建议：若只想先看样本，先取 1 页；需要扩大范围时再使用 --pages 或 --max-items。

2. 带筛选的搜索¶

例如按点赞排序、只看一周内发布的视频：

npx -y socialdatax-skills@latest douyin search \
  --keyword "减脂餐" \
  --sort-type like_count_descending \
  --publish-time-range week \
  --content-type video \
  --pretty \
  --source-client socialdatax-skills \
  --source-platform skillhub \
  --source-skill douyin-topic-analysis

排序可选：general、time_descending、like_count_descending。发布时间：all、day、week、half_year。时长：all、under_1_minute、one_to_five_minutes、over_5_minutes。内容类型：all、video、image。

3. 查看热榜¶

用户要看当前抖音热榜时，使用热榜命令（不需要 --keyword）：

npx -y socialdatax-skills@latest douyin hot-search \
  --pretty \
  --source-client socialdatax-skills \
  --source-platform skillhub \
  --source-skill douyin-topic-analysis

4. 在对话里怎么用¶

向 Agent 描述真实意图即可，例如：「帮我做抖音选题，关键词是『新手化妆』，先看 20 条高赞视频标题和账号。」Agent 在启用本 Skill 后应配置 SOCIALDATAX_API_KEY，按 Skill 调用搜索或热榜，并输出可复盘列表与下一步可追问的问题（如收窄人群、补品牌或时间范围）。

适用场景与注意¶

适合谁：需要把抖音选题调研嵌进 AI 工作流的内容运营、品牌调研和创作者；希望结果带链接、内容 ID 和指标，而不是纯模型臆测。

限制与注意：

• 必须自备 SocialDataX API Key；余额不足（insufficient_balance）时 Skill 要求展示充值链接并勿反复重试。
• 搜索不支持「一次取全量」的 --all；翻页需原样传递完整的 next_page_token，不能截断或改写。
• CLI 退出码为 1 且 partial: true 时，表示结果不完整，应按 Skill 中的续页规则恢复，而非盲目从第一页重跑。
• 本地需可用的 Node.js/npm；SDK 或网络问题属于运行环境问题，Skill 说明不应改用公开网页搜索替代 SocialDataX 数据。
• SkillHub 页面统计（截至资料抓取）：评分 100000，下载 8431；标签标明需要 API Key。实际计费与配额以 SocialDataX 官网为准。

结尾¶

抖音选题分析 把「搜什么、怎么筛、怎么留证据」写进 Agent Skill，用 douyin search 与 douyin hot-search 对接只读数据，适合短视频选题策划和爆款角度拆解前的样本收集。安装与详情见 SkillHub：

• 页面：https://www.skillhub.cn/skills/user_825d9e7e/douyin-topic-analysis
• 坐标链接：https://api.skillhub.cn/user_825d9e7e/douyin-topic-analysis