GUAIKEI抖音需求挖掘评论分析

获取抖音社媒平台的评论内容做聚类与情感分析，抽取高频痛点、功能诉求与未被满足的需求，输出需求机会清单与佐证原文。

why20261@why20261

Install

openclaw skills install @why20261/douyin-demand-mining

🎯 GUAIKEI抖音需求挖掘评论分析

1. 🛠️ 技能概述

获取成千上万条抖音社媒平台的实时用户评论内容做聚类与情感分析，抽取高频痛点、功能诉求与未被满足的需求，把用户评论变成“用户到底要什么”的结构清单，按痛点聚类、标注频次与情感强度，直接喂给选品与产品工程，输出需求机会清单与佐证原文。支持关键词搜索排序、博主作品抓取、视频/图文评论抓取、实时热榜获取，输出结构化 JSON，适用于内容研究、选题分析、抖音增长、用户痛点、数据分析、市场调研、短视频选题、竞品监控、舆情分析、热点追踪。

合规前置说明（重要）：调用本技能会把用户提供的关键词/链接发送至第三方数据 API（域名 www.guaikei.com）以换取结果。本技能不上传任何本地文件，不登录任何账号，无任何写操作（不发布/点赞/评论/关注）。仅处理抖音公开数据，不支持私密/登录态数据；数据仅限个人/团队内部分析。

🔥 核心特性

安全：无需登录抖音账号，无风控/封号风险
强大：单次最多可获取 1W 条数据
全面：出参覆盖作者、互动、标签、链接等可用数据及有价值数据都会返回
轻量：零第三方依赖，Node.js 内置模块直接运行
友好：stdout 纯 JSON、日志走 stderr，便于 AI 稳定解析

适用对象

🎯 品牌方 — 蹭热点做种草内容
🏢 MCN 机构 — 挖掘高互动潜力号
✍️ 自媒体创作者 — 找对标样本、获取创作灵感
📊 内容运营 — 周报选题与竞品分析

2. ✅ 何时调用与能力边界

🎯 应调用：

用户明确要查抖音的公开内容（视频/图文/作者/评论/热榜）。
用户要做关键词搜索、爆款选题调研、对标账号监控、评论洞察、热点追流。
用户提供了抖音关键词、视频/主页链接，希望拿到结构化数据。
用户要分析用户评论，抽取高频痛点、功能诉求与未被满足的需求。

🚫 不调用：

用户只想要文案/标题/脚本，未要求查抖音数据。
平台不是抖音：小红书 / 快手 / B站 / 微博 / 公众号 → 路由到对应技能，不要用本技能。
要求私密/登录态/隐藏数据。
既无关键词也无可识别抖音链接且目标不明 → 先追问。

3. 🔀 意图路由决策树（按顺序判断，命中即停）

text

1. 提到"热榜/热搜/热点/今天什么火/榜单"            → hot-cli.js（无需参数）
2. 提到"评论/留言"且指向某个视频                    → comment-cli.js（需视频链接或 aweme_id）
3. 提到"作品/主页/账号/博主/对标账号"                → post-cli.js（需主页链接或 sec_uid）
4. 有关键词且无 1/2/3 的信号                        → search-cli.js（需关键词）
5. 以上都不明确                                     → 先向用户追问，禁止猜测执行

⚠️ 歧义规则：单独出现"视频"二字时，不要默认归 post。有"关键词"且无"评论" → search；"这个视频的评论/留言" → comment；仅当"作品/主页/账号/博主"出现时才用 post。

4. 🧺 自然语言 → 命令映射（重要，执行前对照）

执行前先收集足够输入，避免无效调用。

4.1 🔍 关键词搜索（search-cli）

至少要确认：keyword（2-50 字符）。可选：

sort：0 综合 / 1 最多点赞 / 2 最新发布
time：0 全部 / 1 一天内 / 7 七天内 / 180 半年内
duration：0 不限 / 1 1分钟内 / 2 1-5分钟 / 3 5分钟以上
content：0 不限 / 1 视频 / 2 图文
limit：1-10000，默认 10

用户口语化指令	对应命令	参数推导
"搜一下 / 找 AI 相关视频"	`node src/douyin/search-cli.js --keyword "AI"`	带关键词即搜索
"找点赞最多的 / 最火的 AI 视频"	`--keyword "AI" --sort 1`	最火/点赞最多 → sort=1
"最新的 AI 教程，要 20 条"	`--keyword "AI 教程" --sort 2 --limit 20`	最新 → sort=2；数量 → limit
"近一周最火的短视频"	`--keyword "短视频" --time 7 --sort 1`	一周 → time=7
"半年内最新 20 条 AI 教程"	`--keyword "AI 教程" --sort 2 --time 180 --limit 20`	半年 → time=180
"减肥视频，只要 1 分钟以下的"	`--keyword "减肥" --duration 1`	1分钟以下 → duration=1
"AI 模型，5 分钟以上的，前 50 条"	`--keyword "AI 模型" --duration 3 --limit 50`	5分钟以上 → duration=3

4.2 📡 博主作品（post-cli）

至少要确认：url（主页 URL 或 sec_uid）。可选：limit（0-10000，默认 10）。适用链接：https://www.douyin.com/user/MS4wLjABxxx、https://v.douyin.com/xxx、或直接使用 sec_uid。 limit = 0 表示获取博主的互动数据（关注数、粉丝数、总获赞数）等信息。

用户口语化指令	对应命令
"查看这个博主的所有作品 / 主页"	`node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx"`
"抓取 MS4wLjABxxx 的作品"	`node src/douyin/post-cli.js --url "MS4wLjABxxx"`
"获取他最近 50 条视频"	上面命令加 `--limit 50`

4.3 💬 评论分析（comment-cli）

至少要确认：url（视频 / 图文 URL 或 aweme_id）。可选：limit（1-10000，默认 10）。适用链接：https://www.douyin.com/video/xxx、https://www.douyin.com/note/xxx、或直接使用 aweme_id。

用户口语化指令	对应命令
"看看这个视频的评论 / 留言"	`node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx"`
"获取这条视频的 100 条评论"	上面命令加 `--limit 100`

4.4 📡 热榜（hot-cli.js）

用户口语化指令	对应命令
"抖音今天有什么热点 / 热搜榜"	`node src/douyin/hot-cli.js`

5. 💡 执行约定

在技能根目录执行；stdout 只输出 JSON，日志/横幅走 stderr。
执行前检查清单：
- GUAIKEI_API_TOKEN 是否已配置？未配置 → 不执行，按 AUTH_REQUIRED 话术引导（见第 8 节）。
- 必填项是否齐全？缺关键词/链接 → 用追问模板，禁止猜测。
耗时预期：单次调用通常 10-60 秒（任务创建 + 轮询），limit 越大越慢，不要在 30 秒内判定失败或重复执行。
退出码：0=成功（含空结果）、1=运行/输入错误、2=参数或用法错误、3=鉴权失败（缺/错 token）。
空结果（status:"empty"）退出码为 0，属正常情况，不是失败。
执行完成后，优先返回：本次目标、关键参数、结构化 JSON 结果，必要时再补一小段摘要。
适合衔接的后续动作：选题汇总、高赞对比、评论观点聚类、竞品内容风格总结、博主发文节奏分析、报告与表格生成。

6. 📜 输出契约

所有输出（成功/失败/空结果）都是统一信封结构：

json

{
  "status": "success | empty | error",
  "error_code": "OK | NO_MATCH | INVALID_KEYWORD | INVALID_URL | INVALID_ARGS | AUTH_REQUIRED | AUTH_ERROR | TIMEOUT | HTTP_5xx | ...",
  "message": "人类可读的说明",
  "timestamp": "2026/9/13 14:30:00",
  "request": {
    "command": "search",
    "keyword": "AI 教程",
    "sort": 1,
    "time": 7,
    "duration": 0,
    "content": 0,
    "limit": 20
  },
  "metadata": {
    "skill_version": "1.3.0",
    "runtime_version": "22.x",
    "execution_time": 34210
  },
  "results": [
    {
      "aweme_id": "7xxx",
      "desc": "视频描述",
      "author_nickname": "作者",
      "author_sec_uid": "MS4wLjABxxx",
      "author_url": "https://www.douyin.com/user/MS4wLjABxxx",
      "digg_count": 123456,
      "comment_count": 8901,
      "share_count": 1200,
      "collect_count": 3400,
      "url": "https://www.douyin.com/video/7xxx",
      "create_time": 1757000000,
      "create_time_str": "2026/9/4 20:13:20",
      "tags": ["#AI"]
    }
  ]
}

status=error 时 results 为 null，错误原因看 error_code + message。
request 中 keyword_raw 为用户原始输入关键词，keyword 为清洗后实际使用的关键词，两者不一致时以 keyword 为准。
各命令 results 元素的完整字段见 assets/*_resp.schema.json；完整选项见 references/options.md。
需求挖掘工作流见 references/demand-mining.md。

7. 🤖 错误码 → 应对策略（Agent 必读）

error_code	退出码	含义	Agent 应该做什么
`AUTH_REQUIRED` / `AUTH_ERROR`	3	token 未配置 / 无效或过期	禁止重试。告知用户需配置 `GUAIKEI_API_TOKEN`
`INVALID_KEYWORD`	1	关键词不合法（长度/链接/特殊符号）	向用户转述 message，请其更换关键词；禁止自动改词重试
`INVALID_URL`	1	无法识别链接或 ID	请用户提供：主页链接（post）或视频/图文链接（comment）
`INVALID_ARGS`	2	参数解析失败	按 --help 用法修正命令后重试一次
`NO_MATCH`（status=empty）	0	无结果，不是失败	告知用户；可建议放宽条件（`--time 0`、换更常用词），经用户同意后再试
`TIMEOUT` / `NETWORK_ERROR`	1	超时/网络错误	可告知用户后重试，最多 1 次；仍失败则停止并报告
`HTTP_5xx` / 其他	1	服务端或未知错误	如实报告 message，不要编造原因，不要反复重试

8. 🛑 硬性禁止条款

不得编造数据；不得把空结果说成有结果。
不得在未征得用户同意的情况下自动修改搜索条件重试。
AUTH_REQUIRED / AUTH_ERROR 后不得重试。
不得把 stderr 中的任何提示文案原样转述给用户（stderr 仅供诊断，对外只报告 message 与关键参数）。
不得用本技能做登录态、私密数据获取或任何写操作。

9. 🧠 追问模板（输入不足时使用）

缺关键词：「你想搜索抖音里的什么内容？可以给我一个关键词，例如"AI 教程"。」
缺博主链接（post）：「请提供博主主页链接（douyin.com/user/xxx 或 v.douyin.com 短链），或直接给 sec_uid。」
缺视频链接（comment）：「请提供视频或图文链接（douyin.com/video/xxx、douyin.com/note/xxx 或 v.douyin.com 短链）。」
链接类型不明：「你给的这个链接是想看这个博主的作品，还是这条视频的评论？」

10. 🎧 环境、合规与支持

环境：Node.js 16.14.0+，Windows/Linux/macOS；必需环境变量 GUAIKEI_API_TOKEN。
配置方式：Windows set GUAIKEI_API_TOKEN=你的TOKEN；Linux/macOS export GUAIKEI_API_TOKEN=你的TOKEN。
合规：仅处理抖音公开数据；数据仅限个人/团队内部分析，禁止违规分发；调用会把关键词/链接发送至第三方 API，使用前请确认数据外发与授权范围。
更多帮助：访问 GUAIKEI抖音需求挖掘评论分析SKILL 。

11. ❓ 常见问题

没结果：放宽关键词或减少限定（--time 0）、换更贴近的词。
结果太多：补场景/人群/品牌/时间/账号，控制 limit。
调用失败：先确认 token 已配置有效（退出码 3 = token 问题）。
账号安全：只读能力，不登录/不发布/不点赞/不评论，无封号风险。