前言¶
做抖音方向的内容调研时，常见做法是手动刷 App、截图或抄链接，再整理成表格。关键词一换、时间范围一缩，就要重复一轮。若希望把「查热榜、按词搜作品、区分视频与图文」交给 coding Agent 在对话里完成，需要一套可读写的 Skill 约定，以及能返回结构化结果的接口。
下面介绍 SkillHub 上的 抖音数据分析 SocialDataX 视频搜索（坐标 @user_825d9e7e/socialdatax-douyin-search，当前版本 1.0.3）。它由社区发布者 user_825d9e7e 维护，数据能力来自 SocialDataX 社媒数据助手，分类为 data-analysis，页面标注 requires_api_key=true。
这是什么¶
一句话定位：在 Agent 中通过 SocialDataX 读取抖音主站热榜，并按关键词检索作品（含图文），用于数据分析、内容调研与趋势观察。
与「只教模型泛泛谈抖音运营」不同，该 Skill 在 SKILL.md 中写明优先走 socialdatax-skills 命令行或已配置的 MCP 工具，输出 JSON，便于后续汇总与对比。Skill 声明为只读：不读本地浏览器数据、不保存 API Key、不执行登录或互动类操作。
核心功能¶
以下能力均来自官方简介与包内 SKILL.md，仅覆盖本 Skill 声明的范围。
- 抖音热榜：调用主站热榜列表，无需查询参数。
- 作品 / 关键词搜索：按
--keyword检索作品，支持分页与多种筛选。 - 图文搜索：通过
--content-type image等参数限定内容类型；结果中的images字段用于图文类条目。 - 检索维度（可选）：排序（综合 / 最新 / 点赞）、发布时间范围、时长区间、内容类型（全部 / 视频 / 图文）。
若 Agent 环境已接入 SocialDataX MCP，Skill 还指向对应工具名：douyin_get_hot_search_list（热榜）、douyin_search_videos（关键词搜索，含分页与筛选字段）。
安装与启用¶
前置条件¶
- 本机需有 Node.js 与 npm（Skill 元数据
requires.bins要求）。 - 数据调用需环境变量
SOCIALDATAX_API_KEY。申请与管理入口以官网为准：https://socialdatax.com/?from=skillhub。
通过 SkillHub 安装¶
官方页面给出的安装提示为：让 AI 参照 SkillHub 安装文档，安装指定坐标。
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_825d9e7e/socialdatax-douyin-search`。
若已安装 skillhub CLI，可将 Skill 装到当前 Agent 的 skills 目录（须使用 --dir，否则默认落在 ./skills/ 且可能不被识别）。SkillHub 文档中的常见路径示例：
- Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/ - Claude Code：
~/.claude/skills/
示例命令（将 <skills 目录> 替换为上述路径之一）：
skillhub install @user_825d9e7e/socialdatax-douyin-search --dir <skills 目录>
CLI 未安装时，可按 https://skillhub.cn/install/skillhub.md 中的脚本安装 skillhub。
运行时依赖¶
Skill 元数据声明通过 npm 包 socialdatax-skills 提供直连 CLI；日常调用可用 npx 拉取最新版，无需单独全局安装该包。
典型用法¶
Skill 建议优先使用直连 CLI（无需单独配 MCP）。先配置 API Key，再执行查询。
export SOCIALDATAX_API_KEY="<你的密钥>"
热榜（无额外参数）：
npx -y socialdatax-skills@latest douyin hot-search --pretty
关键词作品搜索（将关键词换成你的调研主题）：
npx -y socialdatax-skills@latest douyin search --keyword "露营" --pretty
带筛选的搜索（示例：近一周、按点赞排序、仅视频；参数名与取值以 Skill 文档为准）：
npx -y socialdatax-skills@latest douyin search \
--keyword "露营" \
--publish-time-range week \
--sort-type like_count_descending \
--content-type video \
--pretty
翻页时把上一页返回的 next_page_token 传给 --page-token；Skill 说明在 token 非空时应继续请求，不要仅因单页 items 为空就停止。
在 Cursor 等客户端中，安装 Skill 后可直接用自然语言描述意图，例如「拉取抖音热榜并列出前十条关键词」或「搜索关键词 X，要近 7 天发布的视频，按点赞排序」。Agent 会按 SKILL.md 选择 CLI 或 MCP，并按要求区分事实字段与解读。
输出整理时，热榜侧重排名、关键词、热度及关联内容；搜索侧重可溯源字段（内容 ID、URL、标题/描述、作者、互动与发布时间、content_type 等）。
适用场景与注意¶
适合谁
- 需要在对话里快速看抖音热榜、做关键词扫盘的内容运营与研究员。
- 做竞品样本收集、趋势扫描，希望结果可结构化落表或进下游分析脚本的同学。
- 已在用 SocialDataX 其他抖音类 Skill（如作品详情），希望与搜索、热榜能力组合使用的团队。
限制与注意
- 调用消耗 SocialDataX 账户额度，需自行在官网管理 Key 与计费；本文不描述具体价格。
- 依赖外网与
npx拉包；沙箱或离线环境需提前放行。 - SkillHub 页面统计（截至资料抓取）：评分 100000，下载 2364；安装后若 Agent 未加载新 Skill，需按各客户端说明刷新或重启。
- 仅覆盖 Skill 声明的 hot search 与 work search；用户主页、评论、转写等属于同生态其他能力，不在本 Skill 正文范围内。
结尾¶
抖音数据分析 SocialDataX 视频搜索把抖音热榜与关键词作品检索封装成 Agent 可执行的 Skill：配置 SOCIALDATAX_API_KEY，经 SkillHub 安装 @user_825d9e7e/socialdatax-douyin-search，即可在对话或终端用 douyin hot-search / douyin search 拿到可整理的 JSON 结果。
官方入口：
