前言¶
做抖音竞品或同赛道调研时，常见做法是手动翻 App、截图或零散复制链接，很难在 Agent 对话里一次性拿到可对比的结构化结果。下面介绍 SkillHub 社区 Skill「抖音数据洞察」（坐标 @user_fb71c45d/douyin-data-insight）：在配置好数据接口 Token 后，由 Agent 按 SKILL.md 调用内置 Node.js CLI，完成关键词搜索、账号作品、视频评论与实时热榜等查询，并把结果写入技能目录下的 JSON 日志，便于后续分析。
这是什么¶
「抖音数据洞察」是面向品牌、MCN、内容运营与创作者的 data-analysis 类 Agent Skill，版本 1.0.0，来源为 SkillHub community，发布者为 user_fb71c45d。官方页面：SkillHub - 抖音数据洞察；API 入口：https://api.skillhub.cn/user_fb71c45d/douyin-data-insight。
Skill 的触发描述写明：当用户需要做抖音竞品研究、竞品分析、同赛道观察、内容角度对比、内容策略对比或品牌内容调研时使用。运行依赖 Node.js 16.14.0+，并需环境变量 GUAIKEI_API_TOKEN（SkillHub 标签 requires_api_key=true）。Token 需在 guaikei.com 开通，与抖音账号登录无关，仅用于调用背后数据 API。
核心功能¶
Skill 通过四条 CLI 封装公开数据能力（入参、出参在 assets/*.schema.json 中按 JSON Schema draft-07 定义）：
- 关键词搜索（
scripts/douyin/search-cli.js）：按关键词检索视频，支持综合排序、最多点赞、最新发布，以及时间范围、时长、条数上限（单次最多 10000 条）。 - 抖人作品（
scripts/douyin/post-cli.js）：传入用户主页 URL 或sec_uid，批量拉取已发布公开作品。 - 作品评论（
scripts/douyin/comment-cli.js）：传入视频 URL 或aweme_id，获取评论详情。 - 实时热榜（
scripts/douyin/hot-cli.js）：无参数，获取抖音热搜榜单。
执行成功后，结果默认归档到技能目录下的 logs 文件夹（文件名含时间戳与任务类型），便于导出或二次分析。Skill 说明中强调：仅抓取公开数据，不支持私密或隐藏内容；数据限个人或团队内部使用，禁止违规分发。
安装与启用¶
安装 SkillHub CLI¶
若本机尚未安装 skillhub，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档 执行完整安装：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能无法被识别。在 Cursor 中常用路径为 ~/.cursor/skills/。
skillhub install douyin-data-insight --namespace user_fb71c45d --dir ~/.cursor/skills/
也可让 AI 按官方提示安装：参阅 https://skillhub.cn/install/skillhub.md，安装 @user_fb71c45d/douyin-data-insight。
配置 API Token¶
在技能根目录执行 CLI 前，先设置 GUAIKEI_API_TOKEN：
export GUAIKEI_API_TOKEN=你的TOKEN
Windows 可使用 set GUAIKEI_API_TOKEN=你的TOKEN。Token 在 guaikei.com 申请，请勿泄露。
典型用法¶
以下示例均来自 Skill 自带的 SKILL.md 与 references/options.md，需在已安装技能的目录下执行。
关键词搜索（默认综合排序，默认返回 10 条）：
node scripts/douyin/search-cli.js --keyword "AI"
按最多点赞排序，用于对标高赞内容：
node scripts/douyin/search-cli.js --keyword "AI" --sort 1
限定半年内、按最新发布，并拉取 20 条：
node scripts/douyin/search-cli.js --keyword "AI 教程" --sort 2 --time 180 --limit 20
（--time 取值：0 全部、1 一天内、7 七天内、180 半年内；--sort：0 综合、1 最多点赞、2 最新发布。）
抓取指定抖人主页作品：
node scripts/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx"
获取单条视频评论：
node scripts/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx"
获取实时热榜：
node scripts/douyin/hot-cli.js
在 Cursor 等支持 Skills 的客户端里，用自然语言描述「竞品账号」「关键词」「时间范围」等意图即可；Agent 应读取本 Skill 后选择对应脚本与参数。更完整的选项表见技能内 references/options.md。
适用场景与注意¶
适合： 需要结构化抖音公开数据的选题调研、竞品作品对比、评论舆情粗读、热榜跟题，以及需要 JSON 日志落盘再做报表的团队。
限制与注意：
- 无有效
GUAIKEI_API_TOKEN时会报权限类错误，必须先完成开通与配置。 - 搜索无结果时可换更常见的关键词，或将
--time设为0（全部时间）。 - 依赖第三方 API 与网络，配额、计费与稳定性以 guaikei 服务条款为准；Skill 本身不替代合规审查，对外发布内容仍需遵守平台与数据使用规范。
- SkillHub 页面统计（截至资料抓取）：评分 100000，下载 2688 次；安装后若 CLI 未出现在 Agent 技能列表，请确认
--dir路径并重启或重新加载客户端。
结尾¶
「抖音数据洞察」把抖音公开侧的搜索、账号作品、评论与热榜查询收敛成一套可复用的 Skill 与 Node CLI，适合在 Agent 工作流里做竞品与同赛道分析。需要安装或更新时，以上文坐标在 SkillHub 检索即可。
官方地址：https://www.skillhub.cn/skills/user_fb71c45d/douyin-data-insight
