抖音评论与消费者洞察

安装指南

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

什么是

抖音评论与消费者洞察是一项只读数据研究技能，用于查找公开抖音内容并收集其背后的信号。可按关键词搜索视频和图文帖子、查看热榜、获取创作者公开发布的帖子，并收集视频或帖子的评论和互动指标。结果以结构化 JSON 返回，可用于评论分析、用户反馈总结、产品改进、竞品研究和客服准备。
对于品牌、创作者、MCN 和内容团队，这款 Openclaw Skills 工具可以帮助识别受众问题、购买顾虑、使用反馈、需求表达和情绪信号。它通过 GuaiKei API 访问公开数据；不会登录抖音、访问私有或登录后才能查看的数据，也不会执行发布、点赞、评论或关注操作。关键词和链接会发送至第三方 API，因此使用前请确认授权和数据共享要求。

应用场景

围绕某个主题、关键词或内容创意，研究公开的抖音视频和图文帖子。
查找热门或近期内容，为选题、趋势跟踪和内容规划提供支持。
查看创作者的公开帖子和互动信号，用于竞品或创作者研究。
收集特定视频或图文帖子的评论，以识别问题、顾虑和反馈。
查看当前抖音热榜词条和热度数据，以监测趋势。
为产品改进、受众研究、客服沟通要点或内部报告收集依据。

工作原理

确定所需的抖音数据任务：热榜、特定帖子的评论、创作者帖子或关键词搜索。如果缺少必需的关键词或链接，或请求含糊不清，请先提出澄清问题。
确认已安装 Node.js 16.14.0 或更高版本，并且存在 GUAIKEI_API_TOKEN 环境变量。未配置令牌时不要发送请求。
将请求对应到相关 CLI：使用 hot-cli.js 查询热门话题，使用 comment-cli.js 获取帖子评论，使用 post-cli.js 获取创作者公开帖子，或使用 search-cli.js 按关键词发现内容。
应用所需筛选条件和结果数量上限，然后将关键词或链接发送至 GuaiKei 第三方数据 API。
等待请求完成。调用通常需要 10–60 秒；较大的结果数量上限可能需要更长时间，因此不要将慢速请求视为失败，也不要过早重复请求。
返回 JSON 结果，包括请求详情和状态。将 empty 视为有效的无结果情况，而不是执行失败。
使用收集的数据开展后续工作，例如评论主题归类、高互动内容比较、创作者发布模式分析或报告准备；不得编造结果中不存在的发现。

配置指南

前提条件：Windows、Linux 或 macOS 上安装 Node.js 16.14.0 或更高版本，并拥有 GuaiKei API 令牌。此技能使用 Node.js 内置模块，不需要额外的第三方 Node 软件包。
通过 www.guaikei.com 获取抖音数据 API 令牌。
在环境中设置令牌。在 Linux 或 macOS 上：
export GUAIKEI_API_TOKEN="YOUR_TOKEN"
在 Windows 命令提示符中：
set GUAIKEI_API_TOKEN=YOUR_TOKEN
在技能根目录中运行命令。示例：
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
搜索关键词长度必须为 2–50 个字符。可选筛选条件包括排序方式、时间范围、视频时长、内容类型和结果数量上限。创作者帖子和评论命令需要受支持的 URL 或 ID。使用此技能前请配置并保护令牌；令牌缺失或无效会导致 API 调用无法进行。

数据架构

此技能会为成功、无结果和错误情况返回一致的 JSON 信封。结果以 JSON 格式写入 stdout；诊断日志写入 stderr。
字段 用途
status success、empty 或 error
error_code 机器可读的结果代码，例如 OK、NO_MATCH、AUTH_REQUIRED 或 TIMEOUT
message 面向用户的状态或错误说明
timestamp 生成响应的时间
request 命令及提供或规范化后的参数，例如关键词、URL、筛选条件和数量上限
metadata 技能版本、运行时版本和执行时间
results 返回记录的数组；当状态为 error 时为 null
搜索记录可能包括帖子 ID、描述、创作者名称和 ID、URL、互动次数、时间戳及标签。具体字段因命令而异，并由响应架构定义。此技能包含以下架构文件：
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/comment_cli_req.schema.json 和 assets/comment_cli_resp.schema.json
assets/hot_cli_resp.schema.json
此技能在 references/options.md 中记录了命令选项。它未说明如何在本地保存结果文件；CLI 输出为 stdout 上的 JSON。空结果属于正常情况，退出代码为 0；错误响应使用 results: null。

高级特性

四种专用 CLI 工作流：
关键词搜索、实时热榜查询、创作者帖子获取，以及视频或图文帖评论收集。
搜索筛选：
创作者和帖子标识符：
使用个人主页 URL 或
sec_uid
获取创作者帖子；使用视频或图文帖子 URL 或
aweme_id
获取评论。
适合智能体的结构化输出：
stdout 仅输出 JSON、诊断信息写入 stderr、统一的响应信封、元数据以及针对各命令的架构文件。
明确的错误处理：
区分无结果与失败；使用错误代码和文档记录的退出代码指导恢复。不得重试身份验证错误；未经用户批准不得更改搜索条件。
仅限公开数据：
不登录账户、不访问私有或登录后才能查看的数据，也不执行发布、点赞、评论或关注等写入操作。
运行保障：
为 10–60 秒的调用留出时间，避免过早重试，并明确告知关键词和链接会发送至第三方 API。

name: douyin-comment-consumer-insights description: 从抖音评论和相关内容中归纳用户问题、消费者问题、购买顾虑、使用反馈、需求词和情绪证据，用于评论区洞察、用户反馈总结、产品改进和客服话术准备。支持四大能力：(1) 关键词搜索视频/图文，可按点赞数、发布时间、视频时长、内容类型筛选排序；(2) 实时热榜查询，获取抖音热搜词条与热度数据；(3) 博主作品抓取，按主页链接或 sec_uid 获取公开作品列表；(4) 视频评论分析，按视频链接或 aweme_id 获取评论内容与互动数据。 license: MIT
version: 1.3.0