name: tiktok-demand-mining
description: 获取成千上万条TikTok社媒平台的实时用户评论内容做聚类与情感分析，抽取高频痛点、功能诉求与未被满足的需求，把用户评论变成“用户到底要什么”的结构清单，按痛点聚类、标注频次与情感强度，直接喂给选品与产品工程，输出需求机会清单与佐证原文。提供3个能力①关键词搜索（可按点赞/相关度排序、发布时间筛选）②博主作品获取，按主页链接或用户名批量获取公开作品列表，支持最新/最热排序 ③视频评论抓取，按视频链接或作品 ID 获取评论内容、评论者与互动数据，输出结构化 JSON（含作者、互动数据、标签、链接）。
license: MIT
version: "1.1.0"
metadata:
openclaw:
emoji: "🎵"
primaryEnv: GUAIKEI_API_TOKEN
requires:
bins:
- node
env:
- GUAIKEI_API_TOKEN
enabled: true
type: command
runtime: "nodejs@16.14.0+"
requires:
bins: ["node"]
env: ["GUAIKEI_API_TOKEN"]
env_desc:
GUAIKEI_API_TOKEN: "TikTok 数据 API 访问令牌。未配置时无法调用接口；可通过 https://www.guaikei.com 开通，或联系开发者（微信 13395823479，备注：TikTok 技能）。"
keywords:
- "TikTok"
- "tiktok"
- "抖音国际版"
- "TikTok搜索"
- "TikTok评论"
- "TikTok博主"
- "爆款选题"
- "竞品分析"
- "评论舆情"
category:
- "Integrations"
- "Research"
- "数据分析"
- "内容创作"
- "商业运营"
tags:
- "TikTok"
- "抖音国际版"
- "关键词搜索"
- "视频评论"
- "博主作品"
- "竞品分析"
- "选题调研"
- "舆情分析"
- "爆款挖掘"
- "KOL筛选"
- "海外短视频"
- "TikTok数据"
- "TikTok搜索"
- "TikTok评论"
- "TikTok舆情监测"
- "TikTok作品"
- "TikTok达人"
- "TikTok达人数据"
- "TikTok达人作品"
- "TikTokKOL"
- "TikTokKOL作品"
- "TikTok博主"
- "TikTok博主作品"
- "TikTok网红"
- "TikTok竞品分析"
- "TikTok数据分析"
- "TikTok选题"
- "TikTok爆款"
- "TikTok舆情监控"
- "TikTok视频下载"
- "TikTok运营工具"
- "TikTok关键词挖掘"
- "TikTok舆情"
- "TikTok内容分析"
- "评论区洞察"
- "短视频运营"
- "短视频数据"
- "跨境营销"
- "海外社媒"
- "红人营销"
- "网红筛选"
- "营销分析"
- "舆情数据获取"
- "content-analysis"
- "competitor-analysis"
- "influencer-tracking"
- "social-listening"
- "social-media-analytics"
- "short-video"
- "short-video-marketing"
- "content-discovery"
- "video-search"
- "viral-content"
- "market-research"
- "data-scraping"
- "api-wrapper"
schemas:
- name: "输出信封"
file: "assets/output_envelope.schema.json"
- name: "搜索入参"
file: "assets/search_cli_req.schema.json"
- name: "搜索出参"
file: "assets/search_cli_resp.schema.json"
- name: "作品入参"
file: "assets/post_cli_req.schema.json"
- name: "作品出参"
file: "assets/post_cli_resp.schema.json"
- name: "评论入参"
file: "assets/comment_cli_req.schema.json"
- name: "评论出参"
file: "assets/comment_cli_resp.schema.json"
examples:
- "帮我搜 TikTok 上 AI 点赞最多的视频 → node scripts/tiktok/search-cli.js --keyword \"AI\" --sort 1 --limit 20"
- "最近一周 TikTok 的 AI model，要 20 条 → node scripts/tiktok/search-cli.js --keyword \"AI model\" --time 7 --limit 20"
- "这个 TikTok 博主最近 30 条作品 → node scripts/tiktok/post-cli.js --url \"https://www.tiktok.com/@username\" --sort 0 --limit 30"
- "这个 TikTok 博主什么最火 → node scripts/tiktok/post-cli.js --url \"https://www.tiktok.com/@username\" --sort 1 --limit 30"
- "这条 TikTok 视频评论区在说什么，帮我归纳舆情 → node scripts/tiktok/comment-cli.js --url \"https://www.tiktok.com/@username/video/1234567890123456789\" --limit 40"
- "盯一下这个竞品账号最近发了什么 → node scripts/tiktok/post-cli.js --url \"https://www.tiktok.com/@competitor\" --limit 10"

🎯 GUAIKEI TikTok需求挖掘评论分析

获取成千上万条TikTok社媒平台的实时用户评论内容做聚类与情感分析，抽取高频痛点、功能诉求与未被满足的需求，把用户评论变成“用户到底要什么”的结构清单，按痛点聚类、标注频次与情感强度，直接喂给选品与产品工程，输出需求机会清单与佐证原文。给一个关键词或一条链接，拿回 TikTok 公开视频和评论。不登录，不发布。结果是一份 JSON。

三个命令成功时 results 都是数组。空字符串和数字 0 可能不返回，缺失不一定是没有这个字段。

本技能没有视频详情命令，也不下载视频。视频链接只能拉评论。播放地址可能过期。

0. 🧭 每次按这个顺序执行

1. 确认环境变量 GUAIKEI_API_TOKEN 已配置。没有配置时直接告诉用户去 GUAIKEI TikTok需求挖掘评论分析 开通，不要先跑一遍试探。
2. 在本技能根目录执行 node scripts/tiktok/<命令>.js。
3. stderr 出现「处理中」表示任务还在跑。等进程自己退出，再读 stdout 的最后一份 JSON。不要把 stderr 或整份 JSON 念给用户。
4. 按「4. 📦 读结果」的退出码表决定：改参数再试、告诉用户，或停止。

查询最多 20 次。间隔从 2 秒起按 2、4、8、16、32 秒增加，之后每次 60 秒，只算等待大约 15 分钟。每次请求本身还有最多 20 秒超时。宿主如果更早结束进程，按超时处理，不要立刻用同一组参数连打。

同一组参数再次执行时，服务端会复用还没过期的任务：搜索大约 9 分钟内，作品和评论大约 20 分钟内，不会另开一条。搜索如果已经等到 TIMEOUT，9 分钟的复用窗口通常已经过去，立刻重跑可能新建一条任务。

• 没有关键词或链接就先问，不要编造
• 搜索不传 --limit 是 10 条。用户说「全部」再加大，不要自行抓 10000 条
• status=empty 且退出码 0 是「接口已经完成，没有结果」，不是命令失败
• 搜索若一直处理中直到 TIMEOUT，可能是没有可保存的结果。告诉用户换关键词或稍后再试，不要立刻连打

1. 🎯 什么时候调用

满足任一条件即调用：用户提到 TikTok、tiktok 或抖音国际版，并要求搜索、看评论、看博主作品或做选题、竞品、舆情。

不要调用：只让写文案；平台是抖音、小红书、快手、B 站、微博、公众号；要求登录、发布、点赞、下载文件或私密数据；没有关键词也没有可识别链接。

2. 🔀 路由

按这个顺序判断，命中即停：

1. 要评论、留言、舆情，且对象是一条视频 → comment-cli.js
2. 要作品、主页、账号、博主、达人 → post-cli.js
3. 有关键词，且没有上面两类信号 → search-cli.js
4. 以上都不明确 → 先追问

链接和 id：

• tiktok.com/@用户名 只能给 post-cli.js。http、缺 www、m.tiktok.com 会在本地改成 https://www.tiktok.com/@用户名
• 整段 MS4w 开头的 sec_uid 只能给 post-cli.js。搜索结果用 author_sec_uid，或 author_url
• tiktok.com/@用户名/video/数字 和纯数字 aweme_id 只能给 comment-cli.js。搜索或作品结果用 aweme_id
• author_id、user_id 是数字 uid，不要交给作品命令
• vm.tiktok.com、vt.tiktok.com、tiktok.com/t/ 短链两个命令都不接受。请用户换成标准链接，不要两个命令都试
• /photo/ 图文链接不支持
• 只拿到一串数字、又没说明是视频 id 还是别的，按评论用；若用户说的是主页，先问

搜索的 --sort 1 是最多点赞。作品的 --sort 1 是最热，--sort 0 才是最新。

--time 2 不是两天，也不是一周。非法值会直接失败。

3. 🎛️ 参数

枚举和数量不在允许范围内时，命令直接失败（退出码 2，INVALID_ARGS），不会改成默认值再请求。三个命令都支持 --help / -h：帮助打在 stderr，退出码 0，stdout 为空。短参数大小写都可以。含空格的关键词用双引号包成一个参数。关键词以 - 开头时写成 --keyword=-AI，或 node scripts/tiktok/search-cli.js -- -AI。完整字段见 assets/*_cli_req.schema.json 与 references/options.md。

3.1 🔍 关键词搜索

3.2 🦸 博主作品

3.3 💬 视频评论

4. 📦 读结果

成功、空结果、失败都是同一份信封。只读 stdout 的最后一份 JSON。--help 时 stdout 为空，帮助在 stderr。字段以 assets/output_envelope.schema.json 和 assets/*_cli_resp.schema.json 为准。

{
  "status": "success",
  "error_code": "OK",
  "message": "搜索任务完成",
  "timestamp": "2026/10/26 16:20:00",
  "request": { "command": "search", "keyword": "AI", "sort": 1, "time": 0, "limit": 20 },
  "metadata": { "skill_version": "1.1.0", "runtime_version": "22.22.2", "execution_time": 8421 },
  "results": [{ "aweme_id": "123", "desc": "...", "digg_count": 100 }]
}

空结果仍是退出码 0：status 为 empty，error_code 为 NO_MATCH，results 为 null。失败时 status 为 error，results 为 null，message 是给人读的原因。

• 搜索、作品、评论成功时 results 都是数组
• 搜索作者有三套标识：aweme_id 给评论，author_sec_uid 或 author_url 给作品，author_id 是数字 uid
• 评论者同样：user_sec_uid 或 user_url 给作品，user_id 不要交给作品命令
• 作品列表没有粉丝数字段。粉丝在搜索结果的 author_follower_count
• 搜索播放地址是字符串 play_addr。作品播放地址是字符串数组 video_url
• 视频时长用户文档没写单位，按采集端原样的 TikTok 字段理解：视频时长一般为毫秒，音乐时长一般为秒

error_code 是字符串。查询还在处理、次数用尽时是 TIMEOUT，不是空结果。

5. 🔒 合规

只处理 TikTok 公开数据。调用时会把关键词或链接发到 www.guaikei.com。不上传本地文件，不登录，不发布，不下载视频文件。

成功结果默认不写文件。需要留底时设置 TT_GUAIKEI_ENABLE_LOG=1，文件写到系统临时目录的 tiktok-guaikei/logs/。POSIX 上权限是仅当前用户可读写；Windows 不使用这组权限位，靠临时目录本身的用户隔离。

开通 token 或人工支持：GUAIKEI TikTok需求挖掘评论分析官网 ，微信 13395823479（备注：TikTok 技能）。