前言¶
做抖音相关的数据分析、内容归档或竞品调研时，常见做法是手写爬虫或对接零散接口：要处理登录态、反爬和字段变更，维护成本高。若你只需要在对话里按抖音名称或抖音 ID 拿到账号基础信息和近期作品列表，并把结果交给 Agent 继续分析，可以把「查账号 + 列作品」封装成 Skill，由模型在合适意图下自动调用。
下面介绍 SkillHub 上的 抖音作品洞察（@redfox-data/douyin-crawler），说明它做什么、如何安装，以及使用时的边界。
这是什么¶
抖音作品洞察 是红狐数据（enterprise 来源）发布的数据分析类 Skill，当前版本 1.0.6。定位可以概括为：输入 抖音名称 或 抖音 ID，通过 红狐 API 广域库 返回该账号的基础信息与近期作品内容列表；列表支持分页，每页最多 50 条。
Skill 页标注 requires_api_key=true，即实际拉数需要配置红狐侧 API 密钥，具体字段名与申请方式以 Skill 包内说明及红狐数据文档为准（本文不展开未在公开页出现的配置项）。
- SkillHub 页面：https://www.skillhub.cn/skills/redfox-data/douyin-crawler
- 安装坐标：
@redfox-data/douyin-crawler - 分类：
data-analysis
当用户提到「爬取抖音作品」「抖音作品列表」「查看抖音视频」「抖音内容采集」「抓取抖音作品」等表述时，Agent 会倾向于启用该 Skill。
核心功能¶
依据 SkillHub 简介，已核实能力如下：
- 账号基础信息：根据名称或 ID 解析目标抖音账号，返回基础画像类字段（具体字段以接口返回为准）。
- 近期作品列表：输出该账号近期作品内容列表，支持分页；单页上限为 50 条。
- 意图触发：面向「列作品、看视频、采集内容」类自然语言需求，由 Skill 描述引导模型选用本工具，而不是每次手写爬取脚本。
数据经红狐 API 广域库获取，不属于本地浏览器模拟登录方案；是否满足你的合规与数据授权要求，需结合业务自行评估。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：
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
说明与完整策略见：https://skillhub.cn/install/skillhub.md
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前环境会被识别的 skills 目录；默认装到 ./skills/ 时，部分 Agent 不会加载。
skillhub install @redfox-data/douyin-crawler --dir <skills 目录>
常用路径示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下列提示词发给 AI，由其按官方安装说明完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@redfox-data/douyin-crawler`。
3、API Key¶
Skill 标签标明需要 API Key。安装后请在 Skill 包内的 SKILL.md 或红狐数据提供的说明中完成密钥配置，否则无法通过广域库拉取数据。
典型用法¶
公开 SkillHub 页未给出独立 REST 示例；典型交互方式是在已启用该 Skill 的 Agent 中，用自然语言说明目标账号与需求，例如：
- 提供 抖音名称 或 抖音 ID，要求查看近期作品列表；
- 说明是否需要翻页（记住单页最多 50 条，更多内容需分页多次获取）；
- 在返回列表基础上，让 Agent 做汇总、选题对比或导出整理。
模型会根据 Skill 描述中的触发语（如「抖音作品列表」「抓取抖音作品」等）选择本 Skill，再调用背后红狐 API。具体请求参数与返回 JSON 结构以 Skill 实现与 API 文档为准，此处不臆造字段示例。
适用场景与注意¶
适合：
- 需要在对话里快速查看某抖音号的公开侧账号信息与近期作品列表；
- 希望把「查账号 + 列作品」交给 Agent，减少临时写爬虫；
- 已具备或愿意申请红狐 API 密钥，并接受 enterprise 数据源方案。
注意：
- 密钥与费用：
requires_api_key=true，使用前需完成 API Key 配置；调用量、配额与计费以红狐数据为准。 - 数量上限：作品列表分页，每页最多 50 条；全量历史需多次分页，不宜默认一次拿全站。
- 合规：广域库数据的使用范围需符合平台规则与你的业务授权；Skill 不替代法务或合规审查。
- 环境：SkillHub 页面统计（截至资料抓取）为评分 100000、下载 2079；安装后若 Agent 未识别，检查
--dir是否指向正确 skills 目录并按各客户端要求重载配置。
结尾¶
抖音作品洞察 把「按名称或 ID 查抖音账号 + 拉近期作品列表（分页、每页至多 50 条）」封装成可复用的 Agent Skill，适合内容调研与数据分析前的数据获取环节。安装与优先源策略以 SkillHub 官方文档为准；Skill 详情与安装入口：https://www.skillhub.cn/skills/redfox-data/douyin-crawler
