前言¶
做内容调研或竞品观察时，往往要在抖音里按关键词翻作品，再手工记下标题、链接和发布时间。浏览器里一页页点，很难一次性按时间范围收口，也不方便把结果交给表格或后续分析。下面介绍 SkillHub 上的 抖音关键词作品查询（@redfox-data/douyin-search-v2），让 Agent 在对话里按关键词拉取作品，并按日期筛选后以结构化表格呈现。
这是什么¶
抖音关键词作品查询 是红狐数据在 SkillHub 发布的 enterprise 来源 Skill，当前版本 1.0.4，分类为 data-analysis。官方定位是抖音作品查询工具：根据关键词搜索抖音热门、爆款类作品，支持按日期范围筛选，结果以结构化表格展示。
- Skill 坐标：
@redfox-data/douyin-search-v2 - SkillHub 页面：https://www.skillhub.cn/skills/redfox-data/douyin-search-v2
- 技能包地址：https://api.skillhub.cn/redfox-data/douyin-search-v2
页面标注 requires_api_key=true，使用前需按 Skill 说明配置 API Key（具体字段以安装后的 SKILL.md 为准）。
核心功能¶
以下能力均来自官方简介，未在资料中出现的接口或字段不写。
- 关键词搜索：输入搜索词，检索与之相关的抖音作品，侧重热门、爆款方向的内容发现。
- 日期范围筛选：在关键词结果上按时间窗口收窄，便于看某一阶段的上榜或爆发内容。
- 结构化表格输出：查询结果以表格形式展示，便于复制、对比或接入后续数据处理。
- 对话触发：当用户表达「查抖音热门」「搜爆款视频」等意图时，Agent 可挂载本 Skill 执行。官方列出的触发词包括：抖音作品查询、抖音爆款、抖音热门、抖音热榜、抖音搜索、爆款视频、热门视频。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。安装方式以 SkillHub 页面与安装文档为准。
方式一：让 Agent 按官方指引安装¶
在支持 Skill 的客户端里，可将下面意图发给 AI（SkillHub 页面提供的安装提示）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@redfox-data/douyin-search-v2`。
Agent 会按 SkillHub 安装与优先源配置 检查 CLI、选择 skills 目录并完成安装。
方式二：使用 skillhub CLI¶
若本机已有 skillhub，可直接安装到当前 Agent 的 skills 目录（必须使用 --dir，否则默认落在 ./skills/ 且可能不被识别）：
command -v skillhub && skillhub --version
未安装 CLI 时，安装文档给出的完整安装命令为：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装 Skill（将 <skills 目录> 换成当前环境路径）：
skillhub install @redfox-data/douyin-search-v2 --dir <skills 目录>
常见客户端 skills 目录（摘自安装文档）：
| 客户端 | 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装后按客户端要求刷新或重启，使 Skill 被加载；若 Skill 要求 API Key，在对应配置或环境变量中补齐后再查询。
典型用法¶
官方未单独给出命令行示例，用法以对话为主：在已启用本 Skill 的 Agent 中说明关键词，必要时补充起止日期，并说明需要表格化结果。
示例表述（意图与官方触发词一致，可按需改写）：
- 「用抖音作品查询，关键词
露营装备，最近 7 天的热门作品，表格列标题和链接。」 - 「抖音搜索
减脂餐，日期范围 2026-10-01 到 2026-10-15，爆款视频列表。」 - 「查抖音热榜相关词
双十一预售的作品数据，按日期筛一下。」
经过上面的步骤，Agent 应调用 Skill 内定义的能力返回结构化表格；若因未配置 API Key 或网络限制失败，以 Skill 文档与 SkillHub 页面说明为准排查。
适用场景与注意¶
适合谁
- 需要按词做抖音内容样本采集、热点观察的运营、分析或研发同学。
- 希望在 IDE / 对话环境里完成查询，而不是单独开脚本或第三方面板的人。
使用注意
- 本 Skill 标记 requires_api_key=true，未配置密钥时通常无法完成查询。
- 来源为 enterprise，使用条款、配额与数据范围以红狐数据及 SkillHub 公示为准。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 5688，安装 1；仅作商店热度参考，不代表查询结果实时性或覆盖全站。
- 抖音内容与平台规则会变化，日期筛选与「热门」「爆款」口径以 Skill 实际返回字段为准，不宜直接当作官方榜单唯一依据。
结尾¶
抖音关键词作品查询 把「关键词 + 可选日期 + 表格结果」收进一个 data-analysis 类 Skill，适合在 Agent 对话里快速拉一批抖音作品做对照。安装与坐标见 SkillHub：https://www.skillhub.cn/skills/redfox-data/douyin-search-v2 ，技能包：https://api.skillhub.cn/redfox-data/douyin-search-v2 。
