GUAIKEI 抖音需求挖掘

安装指南

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

什么是

GUAIKEI 抖音需求挖掘是一项 Node.js 命令行技能，可通过 GUAIKEI 数据 API 获取公开的抖音视频和图文帖子、热榜数据、创作者发布内容以及视频评论。其结构化结果可用于内容研究、竞争对手监测、情感分析，以及发现反复出现的痛点和未满足的需求。
对于探索用于社交聆听和短视频研究的 Openclaw Skills 团队，这项技能提供四个专用命令，并以便于 AI 智能体处理的 JSON 格式输出。它不会登录抖音，也不会执行写入操作；请求会将提供的关键词或链接发送至第三方 API，因此使用前请确认数据共享和授权要求。

应用场景

查找某个关键词对应的热门或近期发布的抖音视频和图文帖子。
跟踪当前抖音热搜词及其热度数据。
查看创作者的公开帖子，并用于竞争对手或发布频率分析。
获取公开视频或图文帖子的评论，以支持受众情感和需求研究。
收集内容规划、产品研究、网红筛选和内部市场报告所需的证据。
仅在用户明确请求公开抖音数据时使用 Openclaw Skills 工作流；不要将此技能用于其他平台或需要登录才能访问的私有数据。

工作原理

确定用户请求的任务：热榜查询、指定帖子的评论、创作者发布内容或关键词搜索。如果缺少任务说明或所需关键词、链接，请提出澄清问题。
检查是否已配置 GUAIKEI_API_TOKEN，并确认请求涉及公开的抖音数据。若无法进行身份验证，请勿继续。
将请求映射到相应的 CLI 命令，并验证所需输入：搜索关键词长度为 2–50 个字符；帖子查询需要创作者 URL 或 sec_uid；评论查询需要视频／图文 URL 或 aweme_id。热榜查询无需输入参数。
在技能根目录中运行命令。CLI 会将关键词或链接发送至 GUAIKEI API、获取结果并将 JSON 写入 stdout；诊断日志会写入 stderr。
解读响应封装和结果。将 status: "empty" 视为有效的无结果状态，而非失败；报告错误时使用返回的消息和错误代码。
提供用户要求的结构化数据，并在有帮助时总结内容创意、反复出现的评论主题或竞争对手研究的证据，不要编造发现。

配置指南

要求：Node.js 16.14.0 或更高版本、可访问 GUAIKEI API 的网络，以及有效的 GUAIKEI_API_TOKEN。技能文档未指定软件包安装命令；请从技能根目录运行提供的脚本。
在 macOS／Linux 上配置令牌：
export GUAIKEI_API_TOKEN="your_token"
在 Windows 命令提示符中：
set GUAIKEI_API_TOKEN=your_token
可通过 GUAIKEI 服务 www.guaikei.com 获取令牌。请妥善保密，避免将其放入共享日志或源代码管理中。命令示例：
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
单次请求可能需要约 10–60 秒，尤其是在结果数量上限较大时。不要因请求较慢就认定它已失败，也不要立即再次运行。
GUAIKEI 抖音需求挖掘 数据架构与分类体系
每个命令都会返回一致的 JSON 封装：
字段 用途
status success、empty 或 error
error_code 机器可读的结果，例如 OK、NO_MATCH、AUTH_REQUIRED 或 INVALID_ARGS
message 人类可读的状态或错误详情
timestamp 与响应关联的时间
request 命令和输入参数；搜索可能包含原始关键词和清理后的关键词
metadata 技能版本、运行时版本和执行时间
results 返回的记录；出错时为 null
搜索结果记录可能包含标识符、描述、创作者详情、互动次数、URL、时间戳和标签。具体字段取决于命令，并在响应架构中定义。架构文件位于 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/ 下。该技能提供结构化 JSON 输出；未指定单独生成文件或本地数据存储流程。

高级特性

四个专用 CLI 命令涵盖关键词搜索、实时热榜、创作者帖子和帖子评论。
帖子和评论命令接受受支持的抖音链接或平台标识符；使用 --limit 0 时，帖子检索还支持创作者互动数据。
仅输出 JSON 的 stdout 和 stderr 诊断信息，使结果更便于在智能体和 shell 工作流中解析。
响应会区分成功、无结果和错误状态，并包含请求详情和执行元数据。
错误处理规则明确：不要重试身份验证失败，不要悄悄更改搜索词；网络超时最多重试一次。
只读范围：该技能仅访问公开数据，不会登录、发布、点赞、评论或关注。关键词或链接输入会发送至第三方 GUAIKEI API；仅在获得适当授权且用于允许的内部分析时使用。

name: douyin-demand-mining description: 获取抖音社媒平台的评论内容做聚类与情感分析，抽取高频痛点、功能诉求与未被满足的需求，输出需求机会清单与佐证原文。支持四大能力：(1) 关键词搜索视频/图文，可按点赞数、发布时间、视频时长、内容类型筛选排序；(2) 实时热榜查询，获取抖音热搜词条与热度数据；(3) 博主作品抓取，按主页链接或 sec_uid 获取公开作品列表；(4) 视频评论分析，按视频链接或 aweme_id 获取评论内容与互动数据。 license: MIT
version: 1.3.0