前言¶

做抖音相关的数据分析、内容归档或竞品调研时，常见做法是手写爬虫或对接零散接口：要处理登录态、反爬和字段变更，维护成本高。若你只需要在对话里按抖音名称或抖音 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 简介，已核实能力如下：

1. 账号基础信息：根据名称或 ID 解析目标抖音账号，返回基础画像类字段（具体字段以接口返回为准）。
2. 近期作品列表：输出该账号近期作品内容列表，支持分页；单页上限为 50 条。
3. 意图触发：面向「列作品、看视频、采集内容」类自然语言需求，由 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