前言¶

做抖音内容运营或品牌调研时，常见做法是手动刷 App、截图或零散复制链接，再整理成表格。热点一过，对照账号作品和评论的成本很高，也不利于在 Agent 对话里直接出结论。

下面介绍 SkillHub 社区 Skill「抖音竞品智析」（坐标 @user_fb71c45d/douyin-jingpin-zhixi）。它把关键词搜索、达人作品、视频评论和实时热榜封装成可执行命令，由 Agent 按 SKILL.md 调用，适合需要结构化公开数据、而不是只靠肉眼扫榜的场景。

这是什么¶

「抖音竞品智析」是面向抖音公开数据的获取与分析 Skill，版本 1.0.0，来源为 community，发布者为 user_fb71c45d，在 SkillHub 上归类为 data-analysis。

官方简介：抖音公开数据智能获取工具；适用于抖音内容研究、选题、热点观察、竞品内容对比、趋势判断或素材整理，面向内容运营、品牌调研和创作者。

SkillHub 页面标注 requires_api_key=true，运行前需配置第三方 API 凭证（见下文 GUAIKEI_API_TOKEN）。

核心功能¶

以下能力来自该 Skill 包内 SKILL.md 与配套脚本说明，经 skillhub install 安装 @user_fb71c45d/douyin-jingpin-zhixi 后可核对。

1. 关键词搜索：按 --keyword 检索视频，支持综合 / 最多点赞 / 最新发布排序（--sort 0/1/2），时间范围（--time 0/1/7/180）、时长筛选（--duration）及 --limit（1–10000，默认 10）。
2. 达人作品列表：通过抖人主页 URL 或 sec_uid（post-cli.js --url）批量拉取公开作品，用于对标账号内容策略。
3. 作品评论：对视频或图文 URL / aweme_id 拉取评论（comment-cli.js），用于舆情与反馈方向梳理。
4. 实时热榜：无参数运行 hot-cli.js，获取平台热搜榜单，对应 Skill 侧栏文案「实时掌握平台热点，快速响应热门话题」。
5. 结果落盘：执行结果以 JSON 写入技能目录下 logs，便于二次分析或交给 Agent 汇总。

运行环境要求：本机已安装 node（Skill 元数据标明 nodejs@16.14.0+），无需登录个人抖音账号即可拉取公开数据（Skill 文档中的说明）。

安装与启用¶

安装 SkillHub CLI¶

若尚未安装 CLI，可先检查版本；未安装时按 SkillHub 安装文档执行完整安装或仅 CLI：

command -v skillhub && skillhub --version

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-jingpin-zhixi --namespace user_fb71c45d --dir ~/.cursor/skills/

也可在对话中让 AI 按官方提示安装：参阅 https://skillhub.cn/install/skillhub.md，安装 @user_fb71c45d/douyin-jingpin-zhixi。

配置 API Token¶

在 https://www.guaikei.com 开通 TOKEN 后，设置环境变量 GUAIKEI_API_TOKEN，否则脚本会报无权限类错误。示例：

export GUAIKEI_API_TOKEN=你的TOKEN

Windows 可使用 set GUAIKEI_API_TOKEN=你的TOKEN。安装 Skill 后，在技能目录内执行下列命令（路径以你本机 ~/.cursor/skills/@user_fb71c45d/douyin-jingpin-zhixi 为准）。

典型用法¶

进入已安装的 Skill 根目录后，Agent 或直接在本机可复现以下官方示例（占位 URL 需换成真实链接）。

关键词搜索（基础）：

node scripts/douyin/search-cli.js --keyword "AI"

按点赞排序找高互动内容：

node scripts/douyin/search-cli.js --keyword "AI" --sort 1

近 7 天内的关键词结果：

node scripts/douyin/search-cli.js --keyword "AI 模型" --time 7

拉取对标账号公开作品：

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 等客户端中，更常见的用法是用自然语言描述任务（例如「搜近一周 AI 教程高赞视频并对比某账号作品」），由 Agent 读取 SKILL.md 后选择对应 CLI 与参数。入参、出参还可对照技能内 assets/*_cli_*.schema.json（JSON Schema draft-07）。

适用场景与注意¶

适合谁

• 需要系统化做抖音选题、竞品账号对比、热点跟踪或评论舆情梳理的运营与调研人员。
• 希望在 Agent 工作流里直接调用命令、导出 JSON 再生成报告的团队。

限制与注意

• 仅支持公开数据，不包含私密或隐藏内容。
• 依赖 GUAIKEI_API_TOKEN 与 Guaikei 服务；Token 勿泄露，Skill 文档要求数据限个人或团队内部使用，禁止违规分发。
• 搜索结果为空时，可换更常见的关键词或将 --time 设为 0（全部时间）；日志文件名规则见 SKILL.md 常见问题一节。
• SkillHub 抓取信息（截至页面展示）：评分 100000，下载 2217，安装计数 0；以 SkillHub 实时页面为准。

结尾¶

「抖音竞品智析」把抖音公开侧的搜索、账号作品、评论与热榜收敛到同一套 Node 命令，便于在 Agent 里做内容研究与竞品观察，而不必完全依赖手工刷榜。

官方入口：

• SkillHub：https://www.skillhub.cn/skills/user_fb71c45d/douyin-jingpin-zhixi
• API 坐标页：https://api.skillhub.cn/user_fb71c45d/douyin-jingpin-zhixi