TikTok 记录整理器

安装指南

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

什么是

TikTok 记录整理器是 Openclaw Skills 中基于命令的工具，用于收集公开 TikTok 视频、创作者帖子、互动指标、话题标签、链接和评论。它会将自然语言研究目标转换为针对关键词搜索、创作者帖子获取或视频评论收集的 CLI 请求。
此技能可帮助品牌、MCN、创作者、营销人员和内容团队支持网红发现、热门话题研究、竞品监控、受众情绪分析、内容规划和市场研究，无需手动浏览 TikTok。它仅提供读取功能，不会登录用户账号，也不会执行发布、点赞、评论、关注或发送消息等操作。

应用场景

按关键词、相关性、热度或互动情况发现表现出色的 TikTok 视频。
研究热门内容、话题趋势、话题标签、形式、标题和视频时长规律。
获取创作者或网红的公开帖子，并按最新或最热门内容排序。
建立网红、KOL、创作者和竞品筛选候选名单。
监控竞品发布频率、互动水平和爆款内容比例。
收集评论、评论作者、点赞和回复，用于受众洞察或情绪分析流程。
为报告、电子表格、排名、聚类和后续 AI 分析生成结构化输入。
通过自动生成的执行日志保留可重复的研究记录。
不要将此技能用于私密、需要登录、隐藏或非 TikTok 数据，也不要在用户只需要文案创作时使用。

工作原理

判断用户的 TikTok 意图：使用 search-cli.js 发现关键词，使用 post-cli.js 获取创作者的公开作品，使用 comment-cli.js 获取指定视频的评论。
确定关键词、URL 或视频 ID、排序方式、时间范围和结果限制等请求参数。搜索排序区分相关性或热度，创作者帖子排序区分最新或最热门。
验证请求并要求提供 GUAIKEI_API_TOKEN。缺少或无效的身份验证会返回 AUTH_REQUIRED，退出代码为 3；代理必须停止，不得通过更改参数重试。
从技能根目录执行相应的 Node.js CLI。机器可读的 JSON 写入 stdout，横幅、诊断信息和日志位置写入 stderr。
返回统一的响应封装，其中包含状态、错误代码、消息、时间戳、请求参数、运行时元数据、结果和警告。
将 success 视为有可用数据，empty 视为请求有效但没有匹配数据，error 视为请求失败。绝不要编造、补全或悄悄扩大缺失的结果。
参数被规范化时传递警告，然后根据用户的原始目标，将返回记录整理为排名、比较、内容模式、创作者候选名单或评论洞察。
将执行日志保存到系统临时目录，并通过 stderr 报告其位置。

配置指南

在 Windows、macOS 或 Linux 上安装 Node.js 16.14.0 或更新版本。
从 GUAIKEI 获取 TikTok 数据访问令牌，网址为 https://www.guaikei.com。
运行命令前导出必需的令牌：
export GUAIKEI_API_TOKEN="your_token_here"
在 Windows PowerShell 中使用：
$env:GUAIKEI_API_TOKEN="your_token_here"
从技能根目录运行所有命令，以确保 scripts/tiktok/ 和 assets/ 路径正确解析。
使用以下命令搜索公开 TikTok 内容：
node scripts/tiktok/search-cli.js --keyword "AI" --sort 1 --limit 20
node scripts/tiktok/search-cli.js --keyword "AI model" --time 7 --limit 20
使用以下命令获取创作者的公开帖子：
node scripts/tiktok/post-cli.js --url "https://www.tiktok.com/@username" --limit 30
node scripts/tiktok/post-cli.js --url "https://www.tiktok.com/@username" --sort 1 --limit 30
使用以下命令获取公开视频的评论：
node scripts/tiktok/comment-cli.js --url "https://www.tiktok.com/@username/video/1234567890123456789" --limit 40
尽可能将 --limit 保持在 1000 或以下。如果结果为空，应先报告该状态，再由用户决定是否更改关键词或时间范围。此技能没有 npm 依赖，并使用 Node.js 内置模块。

数据架构

三个 CLI 入口都返回相同的顶层 JSON 封装。
字段 用途
status success、empty 或 error，用于描述请求状态
error_code 机器可读的结果，例如 OK、NO_MATCH、AUTH_REQUIRED 或 INVALID_KEYWORD
message 面向用户的说明
timestamp 处理请求的时间
request 原始命令类型及实际采用的关键词、URL、排序、时间和限制值
metadata 技能名称和版本、运行时版本及执行时间
results 结构化 TikTok 记录；空结果或错误响应时为 null
warnings 参数回退或规范化详情，必须向用户展示
受支持的 schema 资源使用 JSON Schema draft-07：
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 定义视频评论的输入和输出。
每次运行还会按照 tiktok-guaikei/logs// 模式在系统临时目录下写入日志。确切的保存路径会输出到 stderr，不会混入 JSON 数据流。stdout 应保持纯 JSON，以便可靠地进行机器解析。

高级特性

意图路由，并对评论请求、创作者帖子请求和关键词搜索设置明确的优先级。
搜索热度或相关性与创作者帖子最新或最热门排序采用不同的排序规则。
支持一天、七天、30 天、90 天和 180 天的时间范围筛选。
统一的成功、空结果和错误状态，并提供适用于自动化的已记录退出代码。
当无效值回退到默认值时，通过
warnings
明确报告，避免参数被悄悄更改。
内置网络和超时重试处理，并提供保守的手动重试建议。
GUAIKEI_API_TOKEN
安全处理令牌；凭据不会出现在 stdout、日志或错误消息中。
采用只读和最小权限方式，在不登录账号或执行写入操作的情况下收集公开 TikTok 数据。
没有 npm 依赖、远程脚本加载、
eval
child_process
；实现依赖 Node.js 内置模块。
结构化输出专为后续 Openclaw Skills 工作流设计，例如排名、汇总、报告、情绪分析和竞品监控。
遵循合规边界，不收集电话号码、位置数据、私信、隐藏数据或其他私人字段。

name: tiktok-record-organizer description: 实时获取TikTok平台的记录及数据整理为结构化的成果：作品描述、发布时间、点赞数、评论数、分享数、收藏数、评论内容等互动数据，可根据数据获取时间进行横向对比分析，帮助用户记录TikTok社媒平台作品的表现，便于后续分析和决策。提供3个能力①关键词搜索（可按点赞/相关度排序、发布时间筛选）②博主作品获取，按主页链接或用户名批量获取公开作品列表，支持最新/最热排序 ③视频评论抓取，按视频链接或作品 ID 获取评论内容、评论者与互动数据，输出结构化 JSON（含作者、互动数据、标签、链接）。 license: MIT
version: 1.0.0