安装指南

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

什么是

TikTok 评论消费者洞察是一款 Openclaw Skills 工具，用于收集公开 TikTok 数据并整理以供分析。它提供三种命令行工作流：按关键词搜索视频、获取创作者的公开帖子，或收集指定视频的评论和互动详情。
使用返回的数据调查受众疑问、购买顾虑、产品反馈、内容趋势和创作者表现。此技能为只读模式：不会登录 TikTok，也不会发布内容、点赞、评论、关注或发送消息。请求使用 GuaiKei API，因此 API token 以及查询关键词或目标 URL/ID 会发送至 guaikei.com。

应用场景

使用关键词搜索、相关性或热度排序以及时间筛选，研究热门 TikTok 话题并寻找潜在视频创意。
查看创作者近期或最受欢迎的公开帖子，为网红筛选和竞争对手监测提供支持。
收集视频中的评论、评论者姓名、点赞数和回复数，以总结受众反应和产品反馈。
根据公开数据准备社交聆听报告、客户支持要点、内容风格评估和市场研究。
构建结构化数据集，以便后续进行比较、排名或聚类；此技能负责获取数据，解读和业务决策仍由用户负责。

工作原理

将请求匹配到相应工作流：关键词或趋势发现使用 search-cli.js，创作者主页和帖子研究使用 post-cli.js，指定视频的评论使用 comment-cli.js。
执行命令前先厘清含糊的请求。尤其要区分用户是想查找视频，还是想获取某个视频的评论。
传入必需的关键词或公开 TikTok URL/ID，然后设置可选的排序、时间范围和结果数量参数。默认值为 sort 0、time 0 和 limit 10；建议单次 limit 不超过 1,000。
在技能根目录运行 Node.js 脚本。命令会将一致的 JSON 响应输出到 stdout；横幅、进度、错误和已保存日志的位置会输出到 stderr。
分析结果前检查 status、error_code 和 warnings。将 empty 视为请求成功但没有匹配数据；说明参数回退情况；如果 token 缺失或无效，则停止而不要重试。
围绕用户目标整理获取的结果，例如按点赞数排列帖子、总结高互动评论主题，或比较创作者的发帖活动；不得编造缺失数据。

配置指南

要求：Node.js 16.14.0 或更高版本、能够访问 GuaiKei 服务的网络，以及有效的 GUAIKEI_API_TOKEN。通过 www.guaikei.com 获取 token 并在环境中配置。从技能根目录运行命令。

为当前 shell 会话设置 token（替换为你的 token）

export GUAIKEI_API_TOKEN="your_token_here"

按关键词搜索 TikTok 视频

node scripts/tiktok/search-cli.js --keyword "AI" --sort 1 --limit 20

获取创作者的公开帖子

node scripts/tiktok/post-cli.js --url "https://www.tiktok.com/@username" --limit 30

获取公开视频的评论

node scripts/tiktok/comment-cli.js --url "https://www.tiktok.com/@username/video/1234567890123456789" --limit 40
在 Windows 上，使用 shell 或操作系统的环境变量设置来配置 GUAIKEI_API_TOKEN。如果命令返回退出代码 3 或 AUTH_REQUIRED，请停止并配置或修正 token；不要使用不同参数重试。此技能使用 Node.js 内置模块，不需要 npm 包。
TikTok 评论消费者洞察 数据架构与分类体系
此技能为成功、空结果和失败请求返回统一的 JSON 信封。信封包含 status、error_code、可读的 message、timestamp、原始 request、metadata、results 和 warnings。
数据区域 内容
request 工作流和参数，例如 command、keyword、sort、time、URL 和 limit。
metadata 技能名称和版本、运行时版本及执行时间。
results 各工作流对应的公开 TikTok 记录。搜索结果可包含创作者详情、互动数量、标签和视频链接；评论结果包含评论文本、评论者、点赞数和回复数。
warnings 必须向用户说明的参数修正或回退信息。
status 有数据返回时为 success，请求成功但无匹配项时为 empty，请求失败时为 error。
六个 Draft-07 JSON Schema 文件记录了 search、post 和 comment 命令的请求与响应结构：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。其他命令选项记录在 references/options.md 中。执行日志保存在系统临时目录下的 tiktok-guaikei/logs//；确切路径会输出到 stderr。

高级特性

搜索控制项包括相关性或热度排序、时间范围筛选和可配置的结果数量。搜索结果和创作者帖子排序的含义不同，因此请使用相应工作流的选项。
创作者帖子获取支持个人资料 URL、TikTok 用户名 URL 或作者标识符；视频评论获取支持视频 URL、短链接或视频 ID。
响应会区分成功结果、有效的空结果和错误；无效参数恢复为默认值时，也会附带警告详情。
运行保护措施包括有上限的结果数量建议、针对网络和超时错误的内置重试处理，以及明确的退出代码行为。身份验证失败需要用户立即处理，且不得重试。
隐私和安全边界明确：此技能仅读取公开数据，不访问私人或仅登录后可见的信息，也不执行 TikTok 写入操作。API token 从环境中读取，不会写入输出或日志。
此实现使用 Node.js 内置模块，不依赖 npm，不会远程加载脚本，也不使用
eval
child_process
；支持 Windows、macOS 和 Linux。

name: tiktok-comment-consumer-insights description: 从TikTok评论和相关内容中归纳用户问题、消费者问题、购买顾虑、使用反馈、需求词和情绪证据，用于评论区洞察、用户反馈总结、产品改进和客服话术准备。提供3个能力①关键词搜索（可按点赞/相关度排序、发布时间筛选）②博主作品获取，按主页链接或用户名批量获取公开作品列表，支持最新/最热排序 ③视频评论抓取，按视频链接或作品 ID 获取评论内容、评论者与互动数据，输出结构化 JSON（含作者、互动数据、标签、链接）。 license: MIT
version: 1.0.0