前言¶
做抖音内容运营或品牌调研时，常见做法是手动刷热榜、逐条点开对标账号、把互动数据抄进表格。公开页面上能看到的视频、作者作品、评论和热榜，其实可以结构化拉取，但自建爬虫要处理接口、限流和合规边界，成本不低。下面介绍 SkillHub 社区 Skill「抖音竞品智析器」（坐标 @user_fb71c45d/douyin-jingpinzhixiqi，v1.0.0），把关键词搜索、账号作品、视频评论和实时热榜封装成 Node.js 命令行脚本，供 Cursor 等 Agent 在对话中按场景调用。
这是什么¶
「抖音竞品智析器」是面向抖音公开数据的获取与分析 Skill，由社区发布者 user_fb71c45d 维护，在 SkillHub 上归类为 data-analysis，来源为 community。官方简介将其定位为：在用户需要做抖音内容研究、选题、热点观察、竞品内容对比、趋势判断或素材整理时使用，主要面向内容运营、品牌调研和创作者。
运行依赖 Node.js（Skill 元数据要求 nodejs@16.14.0+），并通过环境变量 GUAIKEI_API_TOKEN 调用怪客（guaikei.com）提供的 API；SkillHub 标签 requires_api_key=true 与此一致。SkillHub 页面统计（截至资料抓取）：评分 100000，下载 2229 次，安装计数 0。
核心功能¶
Skill 在 SKILL.md 中声明四类能力，均通过 scripts/douyin/ 下 CLI 暴露：
- 关键词搜索（
search-cli.js）：按关键词检索公开视频，支持综合排序、最多点赞、最新发布，以及时间范围、视频时长、条数上限（单次最多 10000 条）。 - 抖人作品列表（
post-cli.js）：根据用户主页 URL、sec_uid或搜索结果中的author_sec_uid批量拉取已发布作品。 - 作品评论（
comment-cli.js）：根据视频 URL 或aweme_id获取评论详情，用于舆情与反馈分析。 - 实时热榜（
hot-cli.js）：无参数调用，获取平台热搜榜单，便于跟踪热点。
出参结构在 Skill 的 assets/*.schema.json 中按 JSON Schema draft-07 描述；执行结果会写入技能目录下的 logs 文件夹（文件名含时间戳及任务类型），便于二次分析或交给 Agent 汇总。
安装与启用¶
通过 SkillHub CLI 安装¶
先确认本机已安装 skillhub（安装方式见 SkillHub 安装文档）。安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且 Agent 可能无法加载。
在 Cursor 中，skills 目录一般为 ~/.cursor/skills/。安装命令示例：
skillhub install douyin-jingpinzhixiqi --namespace user_fb71c45d --dir ~/.cursor/skills/
也可将下面提示词发给支持 SkillHub 的 AI，由其按官方安装说明完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_fb71c45d/douyin-jingpinzhixiqi`。
配置 API Token¶
在 怪客官网 开通 TOKEN 后，配置环境变量（未配置时运行会报无权限类错误）：
# Linux / macOS
export GUAIKEI_API_TOKEN=你的TOKEN
REM Windows
set GUAIKEI_API_TOKEN=你的TOKEN
安装完成后，在 Skill 根目录（例如 ~/.cursor/skills/@user_fb71c45d/douyin-jingpinzhixiqi）执行下文命令；若 Agent 已加载该 Skill，也可在对话中描述任务，由 Agent 代为选择对应 CLI 与参数。
典型用法¶
以下示例均来自 Skill 官方文档，需在 Skill 安装目录下执行。
按关键词搜索：
node scripts/douyin/search-cli.js --keyword "AI"
按点赞排序找高互动内容：
node scripts/douyin/search-cli.js --keyword "AI" --sort 1
--sort 取值：0 综合、1 最多点赞、2 最新发布；--time 可取 0（全部）、1（一天内）、7（七天内）、180（半年内）；--limit 默认 10，最大 10000。
抓取对标账号公开作品：
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
在 Agent 侧，可将需求表述为自然语言任务，例如「搜索近 7 天关键词『AI 模型』的抖音视频并按最新排序」「拉取该用户主页最近 20 条作品」「导出某视频评论用于舆情归纳」，由 Agent 映射到上述脚本及 --time、--limit 等参数。更完整的参数表见 Skill 内 references/options.md。
适用场景与注意¶
适合谁： 需要基于公开数据做选题、竞品账号对比、评论舆情归纳、热榜跟进的运营与调研人员；希望把重复抓取交给 Agent 编排、自己专注解读与策略的团队。
限制与注意：
- 仅支持抖音公开内容，不包含私密或隐藏作品。
- 必须配置
GUAIKEI_API_TOKEN；TOKEN 需自行保管，避免泄露。 - 官方说明要求数据仅限个人或团队内部使用，禁止违规分发。
- 搜索结果为空时，可更换更常见的关键词，或将
--time设为0（全部时间）。 - 依赖第三方 API 与平台规则，调用频率、字段可用性以服务商与抖音侧为准。
结尾¶
「抖音竞品智析器」把搜索、账号作品、评论和热榜四类公开数据能力收敛到同一套 Skill 与 CLI，适合挂在 Cursor 等 Agent 上做抖音内容研究与竞品对比。安装与坐标以 SkillHub 为准：
