抖音竞品雷达

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install douyin-competitor-radar
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 douyin-competitor-radar。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

抖音竞品雷达是一款 Openclaw Skills 工具，用于研究抖音上的公开内容和竞争动态。它可按关键词搜索视频和图文帖子，获取创作者发布的帖子，查看实时热榜，并收集评论进行分析。结果可帮助团队比较内容表现、发现趋势、研究受众反馈，并为品牌和内容策略提供依据。
此技能会返回结构化 JSON，便于后续分析和报告。它无需登录抖音账号，也不会发布、点赞、评论或关注。请求会将提供的关键词或链接发送至第三方 Guaikei 数据 API；仅支持公开数据，结果仅供个人或内部团队分析使用。

应用场景

按关键词查找热门或最新的抖音视频和图文帖子，并按排名、日期范围、时长和内容类型筛选。
通过主页 URL 或 sec_uid 获取公开帖子，以监控竞争对手或创作者。
查看视频评论和互动数据，了解受众的问题、反应和情绪倾向。
查看抖音热搜词及热度数据，发掘时效性内容和营销活动机会。
比较竞争对手内容，识别表现出色的话题，制定关键词库，并支持定期内容报告。
使用关键词、创作者主页或特定视频链接，调查公开受众反馈或市场趋势。

工作原理

确认所需的抖音数据任务：热榜、特定内容的评论、创作者帖子或关键词搜索。如果缺少必需的关键词或链接，或其含义不明确，请先提出澄清问题。
验证输入和配置。搜索需要 2–50 个字符的关键词；获取创作者帖子需要主页 URL 或 sec_uid；获取评论需要视频或图文帖子 URL，或 aweme_id。必须配置 GUAIKEI_API_TOKEN。
运行相应的 Node.js CLI：hot-cli.js、comment-cli.js、post-cli.js 或 search-cli.js。根据需要应用可选筛选条件或结果数量限制。
CLI 会将关键词或链接发送至 Guaikei API，并返回一个 JSON 封装，其中包含状态、请求详情、元数据和结果。日志会发送至 stderr，因此 stdout 可用于解析 JSON。
准确解读响应。结果为空属于正常情况；不得重试身份验证错误，也不得在未经用户批准的情况下更改搜索条件。
呈现所请求的数据，并在适当时总结发现，或将其用于后续分析，例如互动对比、评论主题归类、内容风格评估或报告编写。

配置指南

要求：Node.js 16.14.0 或更高版本、可访问 Guaikei API 的网络连接，以及有效的 GUAIKEI_API_TOKEN。此技能使用 Node.js 内置模块，无需额外的第三方软件包。
确保技能文件位于技能根目录中。
通过 www.guaikei.com 获取 API 令牌，并在环境中进行配置。请勿将令牌放入命令、提示词或共享日志中。
export GUAIKEI_API_TOKEN="YOUR_TOKEN"
node --version
在 Windows 命令提示符中，使用 set GUAIKEI_API_TOKEN=YOUR_TOKEN 配置变量。从技能根目录运行 CLI 命令：
node src/douyin/search-cli.js --keyword "AI 教程" --sort 1
node src/douyin/search-cli.js --keyword "AI 模型" --sort 2 --time 7 --limit 20
node src/douyin/hot-cli.js
node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 30
node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 40
搜索选项包括 --sort（0 综合排序，1 最多点赞，2 最新）、--time（0 全部，1 天、7 天或 180 天）、--duration（0 不限时长，1 不满一分钟，2 一至五分钟，3 超过五分钟）、--content（0 全部，1 视频，2 图文）和 --limit（1–10,000；默认值为 10）。帖子和评论命令也接受 --limit 选项。请求通常需要约 10–60 秒；较大的数量限制可能需要更长时间。
使用前，请确认允许将提供的关键词或链接发送至第三方 API。此技能仅访问抖音公开数据，供内部分析使用；它不会访问私人数据或已登录账号的数据，也不会执行账号操作。

数据架构

成功、结果为空和出错时，此技能都会在 stdout 上返回 JSON。每个响应都使用一致的封装结构：
字段 用途
status success、empty 或 error
error_code 机器可读的结果或错误分类，例如 OK、NO_MATCH、AUTH_REQUIRED 或 TIMEOUT
message 人类可读的状态或错误说明
timestamp 响应时间戳
request 命令名称和实际输入，例如关键词、筛选条件、URL 和数量限制
metadata 技能版本、运行时版本和执行时间
results 返回记录的数组；出错时为 null
架构文件位于 assets/ 下：
search_cli_req.schema.json 和 search_cli_resp.schema.json：关键词搜索请求和响应。
post_cli_req.schema.json 和 post_cli_resp.schema.json：创作者帖子请求和响应。
hot_cli_resp.schema.json：热榜响应。
comment_cli_req.schema.json 和 comment_cli_resp.schema.json：评论分析请求和响应。
references/options.md：其他支持的选项。
status 为 empty 且 NO_MATCH 是有效的无结果响应，并非运行时故障。错误响应中的 results: null；面向用户说明时，请参考 error_code 和 message，而不是 stderr。

高级特性

四种专用 CLI 工作流程分别用于关键词搜索、实时热榜、创作者帖子，以及视频或图文帖子的评论。
获取创作者内容时，可使用抖音主页 URL、短链接或 sec_uid；如技能说明所述，可使用 --limit 0 请求创作者级别的互动指标。
获取评论时，可使用视频或图文帖子 URL 或 aweme_id，并支持配置结果数量限制。
结构化 JSON 输出和仅写入 stderr 的日志，便于可靠解析并与 AI 工作流和报告工具集成。
响应包含请求参数、时间戳、执行元数据，以及标准化状态和错误代码，便于追踪分析。
此技能定义了明确的任务路由和输入验证规则，说明何时应向用户询问缺失的关键词或链接，以及应使用哪个命令。
错误处理旨在避免不安全的重试：身份验证失败时不得重试，不得编造结果，也不得在未经用户批准的情况下更改搜索条件。
Openclaw Skills 用户可以利用返回的数据构建后续工作流，用于话题对比、评论主题归类、创作者发帖频率分析和报告生成。

name: douyin-competitor-radar description: 对比品牌在抖音社媒上的内容表现、互动数据和讨论趋势，可结合历史数据进行分析，输出差异、证据与可执行机会，用于竞品分析、品牌对比、阶段性变化判断、品牌传播复盘和品牌策略优化。支持四大能力：(1) 关键词搜索视频/图文，可按点赞数、发布时间、视频时长、内容类型筛选排序；(2) 实时热榜查询，获取抖音热搜词条与热度数据；(3) 博主作品抓取，按主页链接或 sec_uid 获取公开作品列表；(4) 视频评论分析，按视频链接或 aweme_id 获取评论内容与互动数据。 license: MIT
version: 1.3.0