GUAIKEI 抖音记录整理器

安装指南

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

什么是

对于创作者、品牌、代理机构和分析师，这项技能有助于比较内容表现、监测竞争对手、发现趋势并了解受众反馈。作为 Openclaw Skills 中用于社交内容研究的一项技能，它是只读的：不会登录抖音，也不会发布、点赞、评论或关注内容。请求会将提供的关键词或链接发送至 GUAIKEI 第三方 API；请仅将其用于公开数据，并事先确认您拥有相应授权且符合数据共享要求。

应用场景

查看当前抖音热搜词及其热度数据，以追踪趋势并及时研究话题。
使用个人资料 URL 或
sec_uid
收集创作者的公开帖子，以查看发布规律和互动情况。
使用公开视频或图文帖子的 URL 或
aweme_id
获取评论，研究受众反馈和内容主题。
比较公开内容的表现，用于竞争对手研究、营销活动规划、创作者发掘和定期报告。
构建后续分析所需的结构化输入，例如话题摘要、互动对比、评论聚类和内容风格评估。

工作原理

确定请求类型：查询热榜、查看特定帖子的评论、获取创作者帖子或进行关键词搜索。如果请求不明确或缺少必需输入，请询问用户，不要自行猜测。
检查必需输入是否齐全：搜索需要长度为 2–50 个字符的关键词；获取创作者帖子需要个人资料 URL 或 sec_uid；获取评论需要视频/图文 URL 或 aweme_id。查询热榜无需参数。
确认已配置 GUAIKEI_API_TOKEN，然后在技能根目录运行相应 CLI：hot-cli.js、comment-cli.js、post-cli.js 或 search-cli.js。
CLI 会将提供的关键词或链接发送至 GUAIKEI API，并获取公开的抖音数据。请求通常需要 10–60 秒；较大的数量限制可能需要更长时间。
读取标准输出中的 JSON 信封，并分别处理 success、empty 和 error；空结果是正常情况，并不代表请求失败。
准确报告请求参数和返回数据，然后根据约定使用结构化结果进行后续分析或编写报告。

配置指南

要求：Node.js 16.14.0 或更高版本，以及 GUAIKEI API token。该技能可在 Windows、Linux 和 macOS 上运行。请通过 www.guaikei.com 上的 GUAIKEI 服务获取或激活 token；调用 API 时必须提供 token。请从技能根目录运行命令。技能文档未规定单独的软件包安装步骤。
在 Linux 或 macOS 上配置 token：
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
搜索选项包括 --sort（0 表示相关度，1 表示点赞数最多，2 表示最新）、--time（0 表示全部，1 表示一天内，7 表示七天内，180 表示六个月内）、--duration（0 表示不限，1 表示一分钟以内，2 表示一至五分钟，3 表示五分钟以上）、--content（0 表示不限，1 表示视频，2 表示图文）和 --limit（1–10,000；默认值为 10）。帖子收集支持 0–10,000 的数量限制；评论收集支持 1–10,000。帖子数量限制设为 0 时会请求创作者互动数据。
运行前，请检查必需输入和 token 配置。不要自动重试身份验证失败，也不要悄悄更改搜索查询。该技能会将提供的关键词或链接发送至第三方 API，因此使用前请确认数据授权和共享要求。
GUAIKEI 抖音记录整理器 数据架构与分类体系
该技能会将结果以 JSON 格式输出到 stdout；诊断日志会写入 stderr。文档未说明会生成本地数据文件。请求和响应的 schema 定义位于技能的 assets/ 目录中：
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（success、empty 或 error）、error_code、便于人类阅读的 message、timestamp、提交的 request、metadata 和 results。metadata 包含技能版本、运行时版本和执行时间。错误响应中的 results 为 null；空响应也是有效的结果状态。

高级特性

四个专用 CLI 命令分别支持关键词搜索、热榜查询、创作者帖子收集和评论检索。
搜索可按点赞数或新近程度排序，并按时间范围、时长和内容类型筛选；在支持的情况下，收集数量上限可达 10,000。
明确的意图路由顺序有助于选择正确命令，并会在目标或必需输入不清楚时要求澄清。
机器可读的 JSON 输出与 stderr 诊断信息分离，便于 AI 代理和脚本解析结果。
标准状态和错误代码可区分空结果、无效输入、身份验证问题、超时和服务器错误；不得重试身份验证错误。
该技能为只读模式，且仅限公开的抖音数据。它不会访问私人数据或登录状态数据，也不会执行发布、点赞、评论或关注操作。

name: douyin-record-organizer description: 实时获取抖音平台的记录及数据整理为结构化的成果：作品描述、发布时间、点赞数、评论数、分享数、收藏数、评论内容等互动数据，可根据数据获取时间进行横向对比分析，帮助用户记录抖音社媒平台作品的表现，便于后续分析和决策。支持四大能力：(1) 关键词搜索视频/图文，可按点赞数、发布时间、视频时长、内容类型筛选排序；(2) 实时热榜查询，获取抖音热搜词条与热度数据；(3) 博主作品抓取，按主页链接或 sec_uid 获取公开作品列表；(4) 视频评论分析，按视频链接或 aweme_id 获取评论内容与互动数据。 license: MIT
version: 1.3.0