抖音竞品洞察

安装指南

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

什么是

该 skill 会返回结构化 JSON，供分析和后续报告使用。它不会登录抖音、访问私密或仅限登录用户查看的数据，也不会执行发布、点赞、评论或关注等写入操作。请求会将提供的关键词或链接发送至第三方 Guaikei 数据 API，因此使用前请确认授权和数据共享要求。Openclaw Skills 用户可将结果用于内部研究，但须遵守适用的平台规则和数据使用规定。

应用场景

按关键词查找热门或近期的抖音视频和图文帖子，并按排序方式、日期范围、时长和内容类型筛选。
查看当前抖音热搜并获取相关热度数据，以追踪趋势。
使用个人资料 URL 或
sec_uid
收集创作者公开帖子，了解竞品的发布模式。
使用视频或图文帖子的 URL 或
aweme_id
获取公开评论和互动数据。
比较高互动内容，识别受众问题和痛点，为选题或内部情感分析提供参考。
构建结构化数据集，用于内容研究、竞品监测、市场调研和内部报告。

工作原理

确认所需的抖音研究任务：热榜、特定帖子的评论、创作者帖子或关键词搜索。如果目标或所需输入不明确，请提出澄清问题。
检查所需输入是否齐备：搜索需提供 2–50 个字符的关键词；获取帖子需提供创作者个人资料 URL 或 sec_uid；获取评论需提供视频/图文 URL 或 aweme_id。检索热榜无需额外参数。
确认已配置 GUAIKEI_API_TOKEN。如果缺失或无效，请停止并报告身份验证问题，不要重试。
在 skill 根目录运行相应的 Node.js 命令。可通过命令行参数设置搜索筛选条件和可选的结果数量限制。
命令会将关键词或链接发送至 Guaikei API，并返回包含状态、请求详情、元数据和结果的 JSON 信封。标准输出为 JSON；诊断日志会写入标准错误。
准确解读 success、empty 或 error。结果为空属于正常情况，并不代表命令失败。遵循文档中的错误处理指引，未经用户批准，不要更改搜索条件或重试。
展示目标、关键参数和结构化结果，然后可选择总结模式，或根据返回的数据准备比较分析或报告。

配置指南

要求：Node.js 16.14.0 或更高版本、skill 的命令文件，以及有效的 GUAIKEI_API_TOKEN。未指定其他第三方 Node.js 包依赖。请通过服务提供商 www.guaikei.com 获取 API 访问权限，并确保其使用已获准用于预期分析。
运行命令前，请在 shell 中设置令牌：
export GUAIKEI_API_TOKEN="your-token"
在 Windows 命令提示符中，使用 set GUAIKEI_API_TOKEN=your-token。请从 skill 根目录运行命令。示例：
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）。有关各命令的具体用法，请查看 skill 的 --help 输出。典型请求可能需要 10–60 秒；较大的限制值可能需要更长时间。

数据架构

该 skill 返回结构化 JSON，而非描述本地数据存储或生成文件。响应字段详情定义在随附的 schema 文件中：
Schema 文件 用途
assets/search_cli_req.schema.json 关键词搜索请求
assets/search_cli_resp.schema.json 关键词搜索响应
assets/post_cli_req.schema.json 创作者帖子请求
assets/post_cli_resp.schema.json 创作者帖子响应
assets/hot_cli_resp.schema.json 热榜响应
assets/comment_cli_req.schema.json 评论分析请求
assets/comment_cli_resp.schema.json 评论分析响应
响应使用共享信封，包含 status、error_code、message、timestamp、request、metadata 和 results。状态为 success、empty 或 error；错误响应会将 results 返回为 null。请求详情记录命令及其输入，元数据包含 skill 版本、运行时版本和执行时间。搜索请求可能同时包含原始的 keyword_raw 和用于查询的清理后 keyword。

高级特性

四个针对不同任务的 CLI，分别用于关键词搜索、热榜检索、创作者帖子采集和评论分析。
创作者检索接受个人资料 URL 或
sec_uid
；评论检索接受帖子 URL 或
aweme_id
。
响应包含状态、错误代码、请求参数、时间戳、运行时元数据和结构化结果，便于后续分析。
专为 agent 工作流设计：stdout 包含便于可靠解析的 JSON，诊断日志则发送至 stderr。
明确的输入检查、意图路由和错误处理指引有助于避免调用不明确和不恰当的重试。身份验证失败时不得重试；空结果视为正常情况。
只读范围：处理公开抖音数据，不会登录，也不会执行发布、点赞、评论或关注操作。

name: douyin-insight description: 抖音竞品洞察分析工具，实时监测竞品流量效果、快速拆解对标竞对作品、精准拆解透视竞品流量及策略、高效搭建关键词库，适用于抖音品牌方、创作者等进行竞品分析、流量优化和关键词研究。支持四大能力：(1) 关键词搜索视频/图文，可按点赞数、发布时间、视频时长、内容类型筛选排序；(2) 实时热榜查询，获取抖音热搜词条与热度数据；(3) 博主作品抓取，按主页链接或 sec_uid 获取公开作品列表；(4) 视频评论分析，按视频链接或 aweme_id 获取评论内容与互动数据。 license: MIT
version: 1.3.0