前言¶
做抖音选题或竞品观察时，常见做法是打开 App 或第三方看板手工翻榜、记链接，再让 AI 帮忙写总结。榜单和样本若不在同一条链路里，对话里容易缺可追溯的 ID、链接和指标，结论也难复盘。下面介绍 SkillHub 上的社区 Skill「抖音趋势洞察」，它把抖音热榜查询和关键词搜索接到 Agent 工作流里，由模型按 SKILL 约定调用 CLI 或 MCP，输出带证据的结构化结果。
这是什么¶
「抖音趋势洞察」是面向 Agent 的 Skill，坐标为 @user_825d9e7e/douyin-trend-insights，当前版本 1.0.9，来源为 community，分类为 data-analysis，由发布者 user_825d9e7e 维护。Skill 数据能力来自 SocialDataX（socialdatax-skills），需在环境中配置 SOCIALDATAX_API_KEY；SkillHub 页面标注 requires_api_key=true。
当用户需要做抖音趋势洞察、热点观察、内容方向判断、趋势线索归纳或营销灵感整理时，Agent 会按 SKILL 说明选用本 Skill，主要服务对象是内容运营、品牌调研和创作者。
核心功能¶
以下能力均来自该 Skill 的 SKILL.md 说明，为只读数据查询，不涉及登录、发帖或互动操作。
抖音热榜¶
通过 douyin hot-search（或 MCP 工具 douyin_get_hot_search_list）获取当前热榜。该命令无必填参数，适合「先看平台在推什么话题」的场景。
关键词搜索视频/图文¶
通过 douyin search --keyword <text>（或 MCP douyin_search_videos）按关键词检索内容，并可选用：
- 排序：
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
支持 --pages、--max-items 与 next_page_token 分页；命令返回 JSON，字段包含 platform、tool、arguments、data，多页时结果合并到 data.items。
输出与协作方式¶
Skill 建议 Agent 把热榜信号与关键词搜索结果分开呈现，保留排名、标题、作者、链接或内容 ID、指标与发布时间，便于用户继续追问或缩小范围。本地需具备 Node.js、npm、npx，并安装 npm 包 socialdatax-skills（Skill 元数据中的 install 依赖）。
安装与启用¶
方式一：让 AI 按 SkillHub 文档安装¶
在 Cursor、Claude Code 等支持 Skills 的客户端中，可将官方页面给出的提示交给 Agent，让其阅读安装说明并安装指定坐标：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_825d9e7e/douyin-trend-insights`。
方式二：使用 skillhub CLI¶
若本机已有 skillhub，安装时需用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。Cursor 常用路径为 ~/.cursor/skills/；Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/（完整列表见 SkillHub 安装文档）。
skillhub install douyin-trend-insights --namespace user_825d9e7e --dir ~/.cursor/skills/
未安装 CLI 时，可按同一文档通过官方安装脚本安装。
API Key 与环境变量¶
在 SocialDataX AI 页面 申请或管理 API Key，并在运行环境中设置：
export SOCIALDATAX_API_KEY="你的密钥"
Skill 不会在生成的文件里写入 Key；调用时使用用户环境中的变量。
典型用法¶
能执行 shell 的 Agent 可优先走 direct CLI，无需单独配置 MCP Server。下面两条命令来自 Skill 官方示例，来源标记参数请保持与 Skill 一致。
查询当前抖音热榜：
npx -y socialdatax-skills@latest douyin hot-search \
--pretty --source-client socialdatax-skills --source-platform skillhub \
--source-skill douyin-trend-insights
按关键词搜索（将 <keyword> 换成真实检索词）：
npx -y socialdatax-skills@latest douyin search \
--keyword "<keyword>" --pretty --source-client socialdatax-skills \
--source-platform skillhub --source-skill douyin-trend-insights
在对话中的典型流程可以是：先说明要看热榜还是搜某个选题；若只想看样本，先取 1 页；需要更多结果时再按参数加 --pages 或 --max-items。若 Agent 已接入对应 MCP，也可调用 douyin_get_hot_search_list 或 douyin_search_videos，参数语义与 CLI 一致。
适用场景与注意¶
适合谁： 需要把抖音热榜、关键词搜索结果纳入 Agent 对话的内容运营、品牌调研和创作者；希望输出带链接、ID 和指标、便于复盘的场景。
依赖与限制：
- 必须配置有效的
SOCIALDATAX_API_KEY；余额不足（insufficient_balance）时不应反复重试，应按错误信息中的充值指引处理。 - 依赖 Node/npm 与网络；SDK 或 npx 拉包失败属于本地环境问题，Skill 说明不建议改用公开网页搜索替代 SocialDataX 数据源。
- 只读能力，不读取本地浏览器数据，也不执行账号写操作。
- 分页续查时须原样传递完整的
next_page_token，不可截断或改写。
SkillHub 统计（以社区页面抓取为准）：评分 100000，下载 5002 次；安装后若 Agent 未加载新 Skill，需按所用客户端说明刷新或重启。
结尾¶
「抖音趋势洞察」把抖音热榜与可筛选的关键词搜索封装成 Agent Skill，在统一对话里完成趋势观察与样本收集，并强调可追溯字段与只读安全边界。安装与详情见 SkillHub 官方页：https://www.skillhub.cn/skills/user_825d9e7e/douyin-trend-insights；API 资源页：https://api.skillhub.cn/user_825d9e7e/douyin-trend-insights。
