前言¶
做抖音相关的数据分析或运营辅助时，常见做法是零散记几个接口文档、每次让模型「猜」该调哪个端点、参数怎么拼。接口一多，意图对不上、字段漏填、失败时没有降级路径，输出也不统一。
下面介绍 SkillHub 上的 Douyin Data Method（@efficient-technology/douyin-data-method）。它把通过 MaxHub API 查询抖音数据写成一套可复用的 Agent 流程，从自然语言意图到格式化结果，由 Skill 文档约束 Agent 的执行顺序，而不是临时拼凑提示词。
这是什么¶
Douyin Data Method 是面向大模型 Agent 的「抖音数据查询方法」Skill，当前版本 1.0.1，分类为 data-analysis，来源标注为 enterprise，由 效享网络 发布。
一句话定位：用 MaxHub API 系统化查询抖音全域数据，并在 Skill 内覆盖 意图解析 → 端点匹配 → 参数构造 → API 调用 → 降级切换 → 数据格式化输出 的全流程。官方页面同时给出 Skill 资源地址与 SkillHub 展示页：
- API 资源：
https://api.skillhub.cn/efficient-technology/douyin-data-method - SkillHub：
https://www.skillhub.cn/skills/efficient-technology/douyin-data-method
页面标签标明 requires_api_key=true，使用前需准备 MaxHub 侧可用的 API 密钥（具体字段名以安装后的 Skill 文档为准）。
核心功能¶
依据官方简介，Skill 围绕 7 大查询域 组织能力：
- 视频
- 用户
- 搜索
- 热榜
- 星图
- 指数
- 直播
每个查询域在 Skill 中提供 参数清单 与 1 个完整实战范本，便于 Agent 按同一套模板构造请求并解析响应。
流程层面的能力（均来自官方描述，不展开未公开的端点细节）：
- 意图解析：从用户问题判断属于哪一类抖音数据需求。
- 端点匹配与参数构造：按域选择对应 MaxHub API 路径与必填/可选参数。
- API 调用与降级切换：主路径失败时按 Skill 约定切换备用策略。
- 格式化输出：将原始响应整理为便于继续分析或展示的文本/结构化结果。
适合用自然语言触发的关键词包括：抖音数据、抖音查询、抖音分析、douyin API 等（官方简介中「抖…」为页面截断，以 SkillHub 全文为准）。
安装与启用¶
SkillHub 推荐两种方式：让 Agent 按安装文档执行，或本地用 skillhub CLI 安装到当前 Agent 的 skills 目录（装错目录 Agent 不会加载）。
方式一：提示词安装¶
将下面意图发给已支持 Skill 的 AI 客户端即可：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@efficient-technology/douyin-data-method`。
方式二：skillhub CLI¶
若尚未安装 CLI，可先检查版本：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行（完整安装示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时 必须 使用 --dir 指向当前环境的 skills 目录，例如 Cursor 常用路径为 ~/.cursor/skills/：
skillhub install efficient-technology/douyin-data-method --dir ~/.cursor/skills/
坐标写法亦可带 @ 前缀，与 SkillHub 页面一致：@efficient-technology/douyin-data-method。
其他客户端常见 skills 路径（摘自 SkillHub 安装文档）：Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/。安装后按各客户端要求刷新或重启，使 Skill 被加载。
启用前请配置 MaxHub API 密钥；Skill 标记为需要 API Key，无密钥时查询步骤无法完成。
典型用法¶
官方未在 SkillHub 摘要页展开完整 SKILL.md 正文，典型用法分两层理解：
对话层（安装并配置密钥后）
用触发词描述需求，例如「查一下某关键词的抖音搜索相关数据」或「拉取热榜/指数类数据并整理成表」。Agent 应读取 Douyin Data Method 中的域划分与范本，自动完成端点选择与参数填充，而不是手写 curl。
文档层（Skill 自带）
对 7 大查询域，每种查询都有参数清单与一个完整实战范本。需要核对字段含义或复现某类查询时，以安装包内的 Skill 文档为准，按范本改参数即可复现同类请求。
若需确认 Skill 是否已加载，可在支持 Skills 的客户端中查看 ~/.cursor/skills/（或你指定的 --dir）下是否出现 douyin-data-method 相关目录。
适用场景与注意¶
适合谁
- 需要在 Agent 对话里反复查抖音视频、用户、搜索、热榜、星图、指数、直播等数据的数据分析或运营研发人员。
- 希望统一「怎么问 → 调哪个 API → 失败怎么办 → 怎么呈现」的团队，避免每人一套口头规范。
限制与注意
- 企业来源 Skill（
enterprise），使用条款与 MaxHub API 配额、计费以服务商说明为准。 - 必须 API Key；密钥不要写进公开仓库或聊天记录。
- SkillHub 页面统计（截至资料抓取）：评分 100000，下载 785，安装计数 0；热度以 SkillHub 实时页为准。
- 本文未列出具体 REST 路径与响应字段，避免与 Skill 版本脱节；以 v1.0.1 安装包内文档为唯一参数来源。
结尾¶
Douyin Data Method 把抖音全域查询收成一条 Agent 可执行的流水线，并给 7 类查询配上参数表与实战范本，适合作为「抖音数据 / douyin API」类问题的默认 Skill。
安装与详情见 SkillHub：
https://www.skillhub.cn/skills/efficient-technology/douyin-data-method
资源坐标：https://api.skillhub.cn/efficient-technology/douyin-data-method
