前言¶
做内容调研或竞品观察时，常见做法是在抖音 App 里手动搜关键词、翻推荐页，再逐条抄标题、链接和互动数据。数据散在界面里，很难按时间范围筛一批结果，也不方便交给 Agent 做二次整理。
下面介绍 SkillHub 上的「抖音作品查询」：在支持 Skills 的 AI 客户端里，用自然语言触发搜索，把热门作品以结构化表格返回，并支持按日期范围筛选。
这是什么¶
「抖音作品查询」是社区来源（community）的 Agent Skill，坐标为 @user_5f9c21aa/douyin-search-pro，当前版本 1.0.3，SkillHub 分类为 data-analysis。页面标注作者为 to the moon（红狐数据）。
它面向「查抖音热门/爆款作品数据」这一类任务：按关键词检索抖音热门内容，可选日期范围，结果以表格形式展示，便于对照、摘录或继续分析。
- SkillHub 页面：https://www.skillhub.cn/skills/user_5f9c21aa/douyin-search-pro
- API 入口（Skill 元数据）：https://api.skillhub.cn/user_5f9c21aa/douyin-search-pro
SkillHub 标签包含 requires_api_key=true，使用前需按 Skill 内说明配置 API Key；具体环境变量或配置项以安装后目录中的 SKILL.md 为准。
核心功能¶
以下能力均来自官方简介与 SkillHub 页面描述，未单独列出的细节不作延伸。
- 关键词搜索：根据用户给出的关键词，检索抖音侧的热门、爆款类作品。
- 日期范围筛选：可在查询时限定时间区间，缩小样本范围。
- 结构化表格输出：将命中作品整理为表格，而不是零散段落，方便复制或下游处理。
- 自然语言触发：在对话中使用官方列出的触发词即可唤起 Skill，例如「抖音作品查询」「抖音爆款」「抖音热门」「抖音热榜」「抖音搜索」「爆款视频」「热门视频」。
安装与启用¶
SkillHub 推荐通过 CLI 安装到当前 Agent 的 skills 目录；也可把安装提示词发给 AI，让其按官方安装文档执行。
1. 检查 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装或仅安装 CLI（文档地址：https://skillhub.cn/install/skillhub.md）。
2. 安装本 Skill¶
安装时必须用 --dir 指向当前客户端的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。
skillhub install @user_5f9c21aa/douyin-search-pro --dir <你的 skills 目录>
常见路径示例（以 SkillHub 安装文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
若通过对话安装，可将下面一句发给 AI，并指明你的 skills 目录：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_5f9c21aa/douyin-search-pro`。
安装完成后，按客户端要求重启或刷新 Skills，并依照 SKILL.md 完成 API Key 等配置（requires_api_key=true）。
典型用法¶
官方未提供独立 CLI 示例子命令；典型路径是在已启用该 Skill 的对话里说明意图。下面示例仅复述官方能力描述，实际字段以 Skill 返回表格为准。
- 直接说明关键词与需求，例如：「用抖音作品查询搜关键词『减脂餐』，看最近热门爆款。」
- 需要缩小时间窗口时，在同一句里带上日期范围，例如：「抖音搜索『露营装备』，只看 2026-09-01 到 2026-09-30 的作品，用表格列出来。」
- 使用触发词降低歧义，例如：「抖音热榜相关：帮我查『AI 绘画』的爆款视频数据。」
Agent 应调用 Skill 背后的查询能力，并将结果以表格呈现；若 Key 未配置或权限不足，需先按 SKILL.md 排查。
适用场景与注意¶
适合谁
- 需要在桌面工作流里快速扫一批抖音热门选题、对标账号或爆款样本的运营、产品、数据分析相关角色。
- 已在使用 Cursor、Claude Code、Codex 等支持 SkillHub Skills 的客户端，希望少切换 App、多留在对话里完成检索。
使用注意
- 数据来自 Skill 对接的查询服务，时效、字段完整度与平台规则以实际返回为准；不宜把单次表格结果当作唯一事实来源。
- 社区 Skill（community），升级与维护节奏取决于发布者；SkillHub 页面显示版本 1.0.3，安装前可用
skillhub查看是否有更新。 - SkillHub 统计（以抓取资料为准）：评分 100000，下载 2725；安装量等指标会变动，以页面实时数据为准。
- 涉及平台内容与账号数据时，请遵守抖音及相关服务的使用条款与合规要求。
结尾¶
「抖音作品查询」把「搜关键词 → 按日期筛 → 表格化结果」收进一个 Skill，适合在 Agent 对话里做抖音热门与爆款内容的快速摸底。安装与优先源配置见 https://skillhub.cn/install/skillhub.md ；Skill 详情见 https://www.skillhub.cn/skills/user_5f9c21aa/douyin-search-pro 。
