Skip to content
Back to search

comment-lead-mining

当用户想从公域评论区找客户、挖线索、截流竞品粉丝、做私域引流时使用本技能。即使用户未明确说"获客"或"线索挖掘",只要表达了"我需要更多客户""怎么拓展销售""怎么找到有需求的人",也应触发本技能。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/engheng-art--comment-lead-mining/badge.svg)](/listings/engheng-art--comment-lead-mining)

HTML

<a href="/listings/engheng-art--comment-lead-mining"><img src="/api/listings/engheng-art--comment-lead-mining/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 219 lines
  1. ---
  2. name: comment-lead-mining
  3. slug: comment-lead-mining
  4. displayName: 🚀评论区线索挖掘
  5. summary: 看实时热点,选话题关键词回去做搜索+评论
  6. description: 当用户想从公域评论区找客户、挖线索、截流竞品粉丝、做私域引流时使用本技能。即使用户未明确说"获客"或"线索挖掘",只要表达了"我需要更多客户""怎么拓展销售""怎么找到有需求的人",也应触发本技能。
  7. license: MIT
  8. version: 1.5.0
  9. metadata:
  10. openclaw:
  11. emoji: "🎬"
  12. primaryEnv: GUAIKEI_API_TOKEN
  13. requires:
  14. bins:
  15. - node
  16. env:
  17. - GUAIKEI_API_TOKEN
  18. enabled: true
  19. runtime: "nodejs@16.14.0+"
  20. env_desc:
  21. GUAIKEI_API_TOKEN: "抖音数据 API 访问令牌。未配置时无法调用接口;可通过 https://www.guaikei.com 开通并获取支持。"
  22. keywords:
  23. - "抖音"
  24. - "抖音搜索"
  25. - "抖音用户搜索"
  26. - "抖音热搜"
  27. - "抖音热榜"
  28. - "抖音评论"
  29. - "需求挖掘"
  30. - "痛点分析"
  31. - "评论挖掘"
  32. - "作品详情"
  33. - "博主作品"
  34. - "对标账号"
  35. - "获客"
  36. - "线索"
  37. - "竞品截流"
  38. - "短视频数据分析"
  39. - "douyin"
  40. - "douyin search"
  41. - "douyin user search"
  42. - "douyin hot"
  43. - "douyin comments"
  44. - "douyin detail"
  45. category:
  46. - "数据分析"
  47. - "内容创作"
  48. - "Data&APIs"
  49. tags:
  50. - "抖音"
  51. - "抖音搜索"
  52. - "抖音用户搜索"
  53. - "抖音热搜"
  54. - "抖音热榜"
  55. - "抖音评论"
  56. - "需求挖掘"
  57. - "痛点分析"
  58. - "视频数据"
  59. - "抖音作品"
  60. - "作品详情"
  61. - "博主主页"
  62. - "对标账号"
  63. - "获客"
  64. - "线索"
  65. - "竞品截流"
  66. - "选题"
  67. - "竞品分析"
  68. - "舆情监控"
  69. - "douyin"
  70. - "douyin-search"
  71. - "douyin-user-search"
  72. - "douyin-hot"
  73. - "douyin-comments"
  74. - "douyin-detail"
  75. examples:
  76. - '抖音上"AI 教程"最火的视频 → node src/douyin/search-cli.js --keyword "AI 教程" --sort 1'
  77. - '最近一周关于"AI 模型"的最新内容,要 20 条 → node src/douyin/search-cli.js --keyword "AI 模型" --sort 2 --time 7 --limit 20'
  78. - '找做 AI 的对标账号 / 搜达人 → node src/douyin/user-search-cli.js --keyword "AI" --limit 20'
  79. - "今天抖音有什么热点 / 热搜榜 → node src/douyin/hot-cli.js"
  80. - '这个博主最近 30 条作品 → node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 30'
  81. - '看看这个对标账号多少粉丝、多少获赞 → node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 0'
  82. - '这条视频的评论区都在说什么 → node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 40'
  83. - '这条视频的评论里有什么痛点 → 先确认至少取 50 条,同意后 node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 50,再读 references/demand-mining.md'
  84. - '按关键词在评论区找高意向客户 → node src/douyin/search-cli.js --keyword "装修" --sort 1 --limit 20,再用 aweme_id 跑 comment-cli,结束后读 references/customer-acquisition.md'
  85. - '这条视频多少播放、点赞和文案 → node src/douyin/detail-cli.js --url "https://www.douyin.com/video/xxx"'
  86. - '搜索结果里第 3 条不错,展开看看 → node src/douyin/detail-cli.js --url <上一条搜索结果里的 url>'
  87. - '用户搜索结果里这个账号不错,看主页作品 → node src/douyin/post-cli.js --url <上一条用户结果里的 author_url 或 sec_uid>'
  88. - '帮我找 1 分钟以内的减肥短视频,先来 30 条 → node src/douyin/search-cli.js --keyword "减肥" --duration 1 --limit 30'
  89. - '半年内最火的 AI 教程图文 → node src/douyin/search-cli.js --keyword "AI 教程" --sort 1 --time 180 --content 2'
  90. ---
  91. # 🚀评论区线索挖掘|抖音关键词搜索、竞品分析、舆情监控与热榜跟踪工具 (Douyin Search & Analytics)
  92. 抖音公开数据只读:关键词搜视频/图文、用户/达人搜索、博主作品、作品详情、评论、热榜;输出结构化 JSON。适用于选题、对标账号、竞品、舆情、热点、需求挖掘、公域获客。
  93. ## 1. ⚠️ 执行前置(每次必过)
  94. 1. **先 `cd` 到本 SKILL.md 所在目录**,再执行 `node src/douyin/*.js`。
  95. 2. **确认 `GUAIKEI_API_TOKEN` 已配置**。未配置 → 不执行,走 `AUTH_REQUIRED`(见 §7 / [errors.md](references/errors.md)),禁止先跑「试试看」。
  96. 3. **一次只跑一条命令,等进程自己结束**。查询最多约 20 次退避;`--limit` 很大时最长约 22 分钟。**未退出前不要判定失败,不要并发/重复同一命令。**
  97. 4. **必填参数不齐先追问**(话术见 [ask.md](references/ask.md)),禁止猜测关键词或链接。
  98. > 开通[评论区线索挖掘 官网](https://www.guaikei.com) TOKEN, 配 TOKEN / 落盘 / FAQ → [faq.md](references/faq.md)。
  99. ## 2. 💎 价值与典型场景(10 秒判断该不该用)
  100. | 你是谁 | 你要做的事 | 用哪个命令 |
  101. | --- | --- | --- |
  102. | 短视频运营 | 找爆款选题、看高赞内容的共同点 | `search-cli.js --sort 1` |
  103. | 运营 / 投放 | 按关键词找对标账号、达人 | `user-search-cli.js` |
  104. | 品牌 / 投放 | 监控已知账号的发文节奏与内容策略 | `post-cli.js` |
  105. | 内容分析 | 看一条视频的文案、播放和互动 | `detail-cli.js` |
  106. | 舆情 / 客服 | 判断一条视频的评论区在骂还是在夸 | `comment-cli.js` |
  107. | 产品 / 运营 | 从评论里看痛点和诉求 | `comment-cli.js`,再读 [demand-mining.md](references/demand-mining.md) |
  108. | 销售 / 增长 | 按关键词在评论区挖高意向线索 | `search`→`comment`,再读 [customer-acquisition.md](references/customer-acquisition.md) |
  109. | 所有人 | 今天抖音在火什么 | `hot-cli.js` |
  110. **典型产出**:结构化 JSON(标题、作者、互动、链接、时间),可导入 Excel/BI 或交给 AI 做选题/竞品/舆情/线索表。结果落盘到技能目录 `logs/`(热榜除外)。
  111. **为什么用它**:无需登录抖音;零第三方依赖;按量单次最多 1 万条;stdout 纯 JSON、日志走 stderr。
  112. > **合规**:调用会把关键词/链接发到 `www.guaikei.com`。不上传本地文件、不登录、无写操作。仅公开数据,限个人/团队内部分析。
  113. ## 3. 🎯 识别卡(选命令,命中即停)
  114. | 用户要什么 | 命令 | 最少要有 |
  115. | --- | --- | --- |
  116. | 搜视频/图文、爆款、选题 | `node src/douyin/search-cli.js` | `--keyword` |
  117. | 搜用户/达人/账号、按词找对标 | `node src/douyin/user-search-cli.js` | `--keyword` |
  118. | 已知博主的作品、粉丝数据 | `node src/douyin/post-cli.js` | 主页链接或 `sec_uid` |
  119. | 某条视频/图文的评论(含痛点) | `node src/douyin/comment-cli.js` | 视频链接或 `aweme_id` |
  120. | 某条视频/图文的详情、播放、文案 | `node src/douyin/detail-cli.js` | 视频链接或 `aweme_id` |
  121. | 热搜、热榜 | `node src/douyin/hot-cli.js` | 无参数 |
  122. - 痛点 / 需求挖掘:仍用 `comment-cli`;**成功后必须读** [demand-mining.md](references/demand-mining.md)。
  123. - 获客 / 线索 / 截流:`search-cli`(常 `--sort 1`)→ `aweme_id` 跑 `comment-cli`;**成功后必须读** [customer-acquisition.md](references/customer-acquisition.md)。
  124. - 「找客户」与「挖痛点」同时出现:**先追问**要哪一种([ask.md](references/ask.md))。
  125. ## 4. 🛠️ 命令一行例(详参下沉)
  126. > **详参 / 枚举**:可视化浏览查看 [options.md](references/options.md);也可参见 [readme.md](readme.md)(含命令参数详表)。**仅在需要确认枚举或拼参时再读,不要每次都读。**
  127. ```bash
  128. node src/douyin/search-cli.js --keyword "AI 教程" --sort 1 --limit 10
  129. node src/douyin/user-search-cli.js --keyword "AI" --limit 20
  130. node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 30
  131. node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 0
  132. node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 40
  133. node src/douyin/detail-cli.js --url "https://www.douyin.com/video/xxx"
  134. node src/douyin/hot-cli.js
  135. ```
  136. **数量 / 套餐**:未指定 `--limit` 默认 10;不要擅自抓 10000。技能硬上限 10000(按量)。**包月**超限 → `PLAN_LIMIT`:视频搜索/用户搜索/作品 ≤30,评论 ≤50;详情与热榜无此条数限制。
  137. 口语 → flag 对照 → [routing.md](references/routing.md)。
  138. ## 5. 🔀 意图路由(按序命中即停)
  139. ```
  140. 1. 热榜/热搜/今天什么火 → hot-cli
  141. 2. 获客+痛点同时出现 → 先追问(ask.md),禁止两边都做
  142. 3. 获客/线索/截流/高意向 → search→comment;结束后读 customer-acquisition.md
  143. 4. 评论/留言/痛点/需求挖掘 + 有视频 → comment-cli;痛点类结束后读 demand-mining.md
  144. 5. 痛点/需求挖掘但无视频链接 → 先追问链接
  145. 6. 单条详情/播放/点赞/文案 → detail-cli
  146. 7. 搜用户/达人/对标账号(关键词、无主页链接)→ user-search-cli
  147. 8. 已有主页/sec_uid 或要某账号作品列表 → post-cli
  148. 9. 有关键词且无以上信号 → search-cli
  149. 10. 都不明确 → 先追问(ask.md)
  150. ```
  151. 消歧:单独「视频」不要默认 post/detail。`/user/` → 只能 post;`/video|note/` + 评论 → comment,+ 播放/文案 → detail,都没说 → 追问。「对标」仅关键词 → user-search;已有链接 → post。
  152. ## 6. 📜 输出(摘要)
  153. - stdout = 统一 JSON 信封;stderr = 日志。向用户**只摘关键字段**,勿整份粘贴。
  154. - `status=empty` + `NO_MATCH` 退出码 0,**不是失败**。
  155. - `results`:搜/用户/评论/热榜 = 数组;作品 = `{post,user}`;详情 = 单对象。
  156. 完整信封与形态 → [contract.md](references/contract.md)。JSON Schema 文件在 `assets/`(入参/出参/信封),清单见 [readme.md](readme.md) 参数章。
  157. ## 7. 🚨 错误应对(摘要)
  158. | error_code | 退出码 | Agent |
  159. | --- | --- | --- |
  160. | `AUTH_*` | 3 | **禁止重试**;引导官网配 TOKEN |
  161. | `PLAN_LIMIT` | 1 | **禁止同参重试**;降 limit 须用户同意 |
  162. | `INSUFFICIENT_BALANCE` / `DAILY_LIMIT` | 1 | **禁止同参重试**;充值或明日/调限额 |
  163. | `RATE_LIMITED` | 1 | **禁止立即重试** |
  164. | `INVALID_*` | 1/2 | 换词/换链/按 help 改一次;禁止擅自改默认再跑 |
  165. | `NO_MATCH` | 0 | 如实无结果 |
  166. | `TIMEOUT` / `NETWORK_ERROR` | 1 | 同参续等最多 1 次(搜/用户约 9 分钟、作品/详情/评论约 20 分钟复用);禁止改参「重做」 |
  167. 全表 → [errors.md](references/errors.md)。
  168. ## 8. 🛑 硬性禁止
  169. - 不得编造数据;不得把空结果说成有结果。
  170. - 不得未征得同意就自动改搜索条件重试。
  171. - `AUTH_*` / `PLAN_LIMIT` / `INSUFFICIENT_BALANCE` / `RATE_LIMITED` / `DAILY_LIMIT` 后不得同参或立即重试。
  172. - 不得把 stderr 原文转述给用户。
  173. - 不得做登录态/私密获取或任何写操作;不得编造手机号/微信号或骚扰脚本。
  174. - 不得在未 cd 到技能目录时执行 `node src/douyin/*.js`。
  175. ## 9. 📚 何时读 references(入口总表)
  176. | 时机 | 打开 |
  177. | --- | --- |
  178. | 确认枚举/参数取值 | [options.md](references/options.md) |
  179. | 口语指令 → flag | [routing.md](references/routing.md) |
  180. | 信封 / `results` 形态 | [contract.md](references/contract.md) |
  181. | 完整错误表 | [errors.md](references/errors.md) |
  182. | 缺参追问话术 | [ask.md](references/ask.md) |
  183. | 环境 / FAQ | [faq.md](references/faq.md) |
  184. | 需求挖掘(取数成功后) | [demand-mining.md](references/demand-mining.md) |
  185. | 公域获客(取数成功后) | [customer-acquisition.md](references/customer-acquisition.md) |
  186. | 版本变更 | [changelog.md](references/changelog.md) |
  187. | 技术人员总览(含命令参数详表 / Schema 清单) | [readme.md](readme.md) |
  188. | 机器可校验 Schema | `assets/*.schema.json` |
readme.md · README · 313 lines
  1. # 🚀评论区线索挖掘|抖音数据采集工具·关键词搜索 · 用户搜索 · 博主作品 · 作品详情 · 视频评论 · 实时热榜(无需登录 / 不封号)
  2. > **💡一句话价值**:一条命令拿到抖音公开的视频/用户/作者/作品详情/评论/热榜数据,直接输出结构化 JSON——做爆款选题、找对标账号、公域获客、账号监控、单条作品数据和热点追踪,不用再手动刷抖音。
  3. **一句话简介**:抖音公开数据只读技能,支持关键词搜索视频与图文、用户/达人搜索、博主作品与粉丝数据、单条作品详情、视频图文评论、实时热榜,并可按剧本做需求挖掘与公域获客(search→comment),全部以结构化 JSON 输出,不登录、不发布、不点赞、不评论。关键词:抖音搜索、抖音用户搜索、抖音热搜、抖音热榜、抖音评论、需求挖掘、获客、线索、竞品截流、痛点、播放量、作品详情、博主作品、对标账号、竞品分析、选题挖掘、舆情监控、douyin search、douyin user search、douyin hot、douyin detail、douyin comments。
  4. **维护状态**:持续更新中,当前版本 `1.5.0`,[更新日志](references/changelog.md)。Agent 执行卡见 [SKILL.md](SKILL.md)。
  5. > **🔥核心优势**
  6. >
  7. > - 安全:无需登录你的抖音账号,不存在风控 / 封号问题
  8. > - 强大:按量 Token 单次最多 10000 条;包月 Token 视频搜索/用户搜索/作品最多 30、评论最多 50
  9. > - 全面:出参覆盖作者、互动(点赞/评论/收藏/分享/推荐)、标签、链接、音乐、话题等可用字段
  10. > - 灵活:支持排序(综合/最多点赞/最新)、时间(1天/7天/半年)、时长、内容类型(视频/图文)多维度筛选
  11. > - 轻量:零第三方依赖,Node.js 内置模块直接跑,无需部署服务
  12. > - 友好:stdout 纯 JSON、日志走 stderr,AI 可直接解析;结果自动落盘便于二次分析
  13. ## ✅ 我能帮你解决什么(10 秒判断)
  14. | 你是谁 | 你要做的事 | 用哪个功能 |
  15. | ---------- | -------------------------------- | --------------------------- |
  16. | 短视频运营 | 找爆款选题、分析高赞视频规律 | 关键词搜索(点赞/最新排序) |
  17. | 运营/投放 | 按关键词找对标账号、达人 | 用户搜索 |
  18. | 销售/增长 | 评论区挖高意向线索、竞品截流 | 搜索→评论 + [获客剧本](references/customer-acquisition.md) |
  19. | 品牌/投放 | 监控已知账号的内容策略和发文节奏 | 博主作品抓取 |
  20. | 内容分析 | 看一条视频的文案、播放和互动 | 作品详情 |
  21. | 舆情/客服 | 看一条视频评论区在骂还是在夸 | 评论抓取 |
  22. | 内容策划 | 快速追热点、找当天的流量入口 | 实时热榜 |
  23. | 数据分析 | 把抖音数据导入 Excel/BI 做周报 | 结构化 JSON + 日志落盘 |
  24. **典型产出**:结构化 JSON(含标题、作者、点赞/评论/收藏/分享、标签、视频链接、发布时间),可直接导入 Excel / BI,或交给 AI 生成**选题库、竞品对比表、舆情周报、发文节奏分析、公域线索表**。剧本见 [需求挖掘](references/demand-mining.md)、[公域获客](references/customer-acquisition.md)。
  25. ---
  26. ## 🚀 3 步接入
  27. 1. **装 Node.js**(16.14.0+,Windows/Mac/Linux 均可,约 2 分钟)
  28. 2. **拿 TOKEN**:访问 [评论区线索挖掘 官网](https://www.guaikei.com) 自助开通,配置环境变量 `GUAIKEI_API_TOKEN`
  29. - Windows cmd:`set GUAIKEI_API_TOKEN=你的TOKEN`
  30. - Windows PowerShell:`$env:GUAIKEI_API_TOKEN="你的TOKEN"`
  31. - Linux/MacOS:`export GUAIKEI_API_TOKEN=你的TOKEN`
  32. 3. **进入技能目录后执行一条命令**:
  33. ```bash
  34. cd <本技能所在目录> # 即 readme.md / SKILL.md 所在的那一层
  35. node src/douyin/hot-cli.js
  36. ```
  37. > ⚠️ 一次只跑一条命令,跑完等进程自己退出。小查询常常十几秒;`--limit` 很大时最长约 15–22 分钟,**进程未退出前不要重复发起同一条命令**。
  38. ---
  39. ### 最快上手(复制就能跑)
  40. ```bash
  41. # 🔎 搜"AI"相关的抖音视频
  42. node src/douyin/search-cli.js --keyword "AI"
  43. # 🔎 按点赞排序找爆款(最常用)
  44. node src/douyin/search-cli.js --keyword "AI" --sort 1
  45. # 🔎 近 7 天"AI 模型"的最新 20 条
  46. node src/douyin/search-cli.js --keyword "AI 模型" --sort 2 --time 7 --limit 20
  47. # 👤 按关键词找用户 / 对标账号
  48. node src/douyin/user-search-cli.js --keyword "AI" --limit 20
  49. # 🦸 抓某个博主的作品(直接粘贴 App 分享链接也行)
  50. node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 20
  51. # 🦸 只要博主的粉丝数 / 获赞数等互动数据
  52. node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 0
  53. # 💬 看这条视频的评论
  54. node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 100
  55. # 📄 看这条视频的详情(文案、播放、点赞、作者)
  56. node src/douyin/detail-cli.js --url "https://www.douyin.com/video/xxx"
  57. # 📡 抖音实时热榜
  58. node src/douyin/hot-cli.js
  59. ```
  60. > 💡 Windows cmd.exe 下请使用双引号;PowerShell / bash 可直接执行。
  61. > 💡 支持直接粘贴 App 分享文案(含"复制到剪贴板…"字样和短链),链接会自动抽取、参数自动清理。
  62. ---
  63. ### 你会得到什么(真实输出结构示例)
  64. ```json
  65. {
  66. "status": "success",
  67. "error_code": "OK",
  68. "message": "搜索任务完成",
  69. "timestamp": "2026/9/4 20:13:20",
  70. "request": {
  71. "command": "search",
  72. "keyword": "AI 教程",
  73. "sort": 1,
  74. "limit": 20
  75. },
  76. "metadata": {
  77. "skill_version": "1.5.0",
  78. "runtime_version": "22.x",
  79. "execution_time": 34210
  80. },
  81. "results": [
  82. {
  83. "aweme_id": "7625...",
  84. "desc": "3 分钟讲透 RAG…",
  85. "author_nickname": "某某说AI",
  86. "author_sec_uid": "MS4wLjABAAAA…",
  87. "author_url": "https://www.douyin.com/user/MS4wLjABAAAA…",
  88. "digg_count": 13324,
  89. "comment_count": 118,
  90. "share_count": 2861,
  91. "collect_count": 11486,
  92. "url": "https://www.douyin.com/video/7625...",
  93. "create_time": 1775434101,
  94. "create_time_str": "2026/4/5 10:08:21",
  95. "tags": ["#AI", "#教程"]
  96. }
  97. ]
  98. }
  99. ```
  100. - 视频搜索、用户搜索、评论、热榜成功时 `results` 是**数组**;博主作品成功时 `results` 是**对象**,包含 `post`(作品数组)和 `user`(博主信息)。
  101. - 空结果是 `"status": "empty"` + `error_code: "NO_MATCH"`,**退出码仍然是 0,属正常情况,不是失败**。
  102. - 字段较多(含封面图、播放地址等长 URL),向用户汇报时建议只摘取 `desc` / `author_nickname` / `digg_count` / `url` / `create_time_str` 等关键字段。
  103. ---
  104. ## 📌 适用场景(我该不该用?)
  105. - 需要短视频选题 → 关键词搜索 + 点赞排序(`--sort 1`)
  106. - 需要按词找对标账号 / 达人 → 用户搜索(`user-search-cli.js`)
  107. - 需要研究已知账号 → 按主页链接抓取其公开作品(**一次抓一个账号**,多个账号逐条执行)
  108. - 需要看账号体量 → 作品命令加 `--limit 0`,直接拿粉丝数 / 获赞数
  109. - 需要分析内容舆情 → 获取视频/图文评论,可做观点聚类
  110. - 需要快速追热点 → 实时热榜(约 50 条,含排名与热度值)
  111. - 需要做营销报告 → 输出结构化 JSON 并自动落盘,便于复盘与二次分析
  112. ## 🔍 和其他方式比,凭什么用它?
  113. | 对比项 | 本技能 | 手动刷抖音 | 自己写爬虫 |
  114. | -------------- | -------------------------- | --------------------- | ---------------------------- |
  115. | 上手成本 | 一条命令,5 分钟接入 | 0,但整理数据极费时间 | 需要逆向/维护,门槛高 |
  116. | 登录与封号风险 | **无需登录,只读公开数据** | 无 | 高(需带登录态,易触发风控) |
  117. | 数据结构 | 标准 JSON,字段齐全 | 手抄 | 自己定义 |
  118. | 单次规模 | 按量最多 10000;包月满足基本使用 | 受限于人肉 | 受限于风控 |
  119. | 维护成本 | 平台负责更新 | 无 | 接口一变就失效 |
  120. | 配合 AI 分析 | 天然适配(stdout 纯 JSON) | 不适配 | 需额外处理 |
  121. ---
  122. ## 🔧 命令与参数详表
  123. > 口语化指令枚举续读 [references/options.md](references/options.md)。机器 Schema 见 `assets/`。信封与 `results` 形态见 [references/contract.md](references/contract.md)。
  124. ### 关键词搜索 `search-cli.js`
  125. | 参数 | 缩写 | 必填 | 取值 | 默认 |
  126. | --- | --- | --- | --- | --- |
  127. | `--keyword` | `-k` | ✅ | 2–50 个字符,不能是链接,不含 `< > " ' &` | — |
  128. | `--sort` | `-s` | | 0 综合 / 1 最多点赞 / 2 最新发布 | 0 |
  129. | `--time` | `-t` | | 0 全部 / 1 一天内 / 7 七天内 / 180 半年内 | 0 |
  130. | `--duration` | `-d` | | 0 不限 / 1 1分钟以下 / 2 1-5分钟 / 3 5分钟以上 | 0 |
  131. | `--content` | `-c` | | 0 不限 / 1 视频 / 2 图文 | 0 |
  132. | `--limit` | `-l` | | 1–10000(**包月 Token 实际最多 30**) | 10 |
  133. 未指定 `--limit` 时只返回 10 条。用户说「全部」再显式加大,不要自作主张抓 10000。关键词以 `-` 开头时写成 `--keyword=-AI`,或 `node src/douyin/search-cli.js -- -AI`。
  134. **套餐双上限**:技能硬上限 10000(按量)。**包月**超限返回 `PLAN_LIMIT`:视频搜索/用户搜索/作品最多 **30**,评论最多 **50**;详情与热榜无此条数限制。
  135. ### 用户搜索 `user-search-cli.js`
  136. 按关键词搜用户/达人/账号。成功时 `results` 是**用户数组**(含 `sec_uid`、`nickname`、`fans` 等;有 `sec_uid` 时含 `author_url`)。**不是**视频搜索。暂不支持粉丝量/认证类型筛选。
  137. | 参数 | 缩写 | 必填 | 取值 | 默认 |
  138. | --- | --- | --- | --- | --- |
  139. | `--keyword` | `-k` | ✅ | 2–50 个字符,不能是链接,不含 `< > " ' &` | — |
  140. | `--limit` | `-l` | | 1–10000(**包月最多 30**) | 10 |
  141. 找到账号后要看作品,用 `author_url` 或 `sec_uid` 再跑 `post-cli.js`。
  142. ### 博主作品 `post-cli.js`
  143. | 参数 | 缩写 | 必填 | 取值 | 默认 |
  144. | --- | --- | --- | --- | --- |
  145. | `--url` | `-u` | ✅ | `douyin.com/user/xxx`、`v.douyin.com/xxx`,或 `sec_uid`(`MS4wLjA` 开头) | — |
  146. | `--limit` | `-l` | | 0–10000(**包月最多 30**;**`0` = 只取博主互动数据**) | 10 |
  147. 成功时 `results` 是**对象**,含 `post`(作品数组)和 `user`(博主信息)。
  148. ### 视频评论 `comment-cli.js`
  149. | 参数 | 缩写 | 必填 | 取值 | 默认 |
  150. | --- | --- | --- | --- | --- |
  151. | `--url` | `-u` | ✅ | `douyin.com/video/xxx`、`douyin.com/note/xxx`、`v.douyin.com/xxx`,或纯数字 `aweme_id` | — |
  152. | `--limit` | `-l` | | 1–10000(**包月最多 50**) | 10 |
  153. ### 作品详情 `detail-cli.js`
  154. | 参数 | 缩写 | 必填 | 取值 | 默认 |
  155. | --- | --- | --- | --- | --- |
  156. | `--url` | `-u` | ✅ | `douyin.com/video/xxx`、`douyin.com/note/xxx`、`v.douyin.com/xxx`,或纯数字 `aweme_id` | — |
  157. 没有 `--limit`。成功时 `results` 是**一条作品对象**,不是数组,也不含评论。图文(note)通常没有播放数和时长。
  158. ### 实时热榜 `hot-cli.js`
  159. 不接受参数。返回约 50 条。失败时最多重试 3 次,不走长查询。
  160. ### Schema 入口
  161. - 输出信封 [output_envelope.schema.json](assets/output_envelope.schema.json)
  162. - 关键词搜索 [入参](assets/search_cli_req.schema.json) / [出参](assets/search_cli_resp.schema.json)
  163. - 用户搜索 [入参](assets/user_search_cli_req.schema.json) / [出参](assets/user_search_cli_resp.schema.json)
  164. - 博主作品 [入参](assets/post_cli_req.schema.json) / [出参](assets/post_cli_resp.schema.json)
  165. - 评论 [入参](assets/comment_cli_req.schema.json) / [出参](assets/comment_cli_resp.schema.json)
  166. - 作品详情 [入参](assets/detail_cli_req.schema.json) / [出参](assets/detail_cli_resp.schema.json)
  167. - 热榜 [出参](assets/hot_cli_resp.schema.json)
  168. 口语 → 命令对照:[references/routing.md](references/routing.md)。错误全表:[references/errors.md](references/errors.md)。
  169. ---
  170. ## ⚠️ 重要限制(不踩坑)
  171. - 仅抓取抖音**公开**数据,不支持私密/隐藏内容
  172. - 需要配置 `GUAIKEI_API_TOKEN` 才能运行;调用会把关键词/链接发送至第三方 API( www.guaikei.com )
  173. - 数据仅限个人/团队内部使用,禁止违规分发
  174. - 小查询常常十几秒内结束,条数越大越慢。进程会自己创建任务并继续查询,最长约 15–22 分钟才结束
  175. - 播放地址和分享链接有时效,过期后需要重新获取
  176. ---
  177. ## ❓ 常见问题(秒解决)
  178. > **Q:运行报错,提示无权限 / 退出码 3?**
  179. >
  180. > A:`GUAIKEI_API_TOKEN` 未配置、格式无效或已过期。令牌须为 16-256 位字母、数字、下划线或连字符。配置方式见上文"3 步接入"。请注意保密,不要泄露给他人。
  181. > **Q:搜索结果为空?**
  182. >
  183. > A:换常用关键词,或把 `--time` 改为 0(全部时间)。空结果退出码为 0,属正常情况。
  184. > **Q:提示 `Cannot find module`?**
  185. >
  186. > A:没有先进入技能目录。先 `cd` 到 `SKILL.md` / `readme.md` 所在目录,再执行 `node src/douyin/...`。
  187. > **Q:输出文件在哪里?**
  188. >
  189. > A:搜索 / 用户搜索 / 作品 / 评论 / 作品详情任务的结果会自动保存在技能目录的 `logs/` 下:
  190. >
  191. > - 搜索任务:`时间戳_关键词_排序_时间_时长_类型_search.json`
  192. > - 用户搜索:`时间戳_关键词_数量_user_search.json`
  193. > - 博主作品:`时间戳_博主sec_uid或短链码_post.json`
  194. > - 评论获取:`时间戳_视频aweme_id或短链码_comment.json`
  195. > - 作品详情:`时间戳_视频aweme_id或短链码_detail.json`
  196. > - (热榜为实时直读,不落盘)
  197. > **Q:支持哪些链接形式?**
  198. >
  199. > A:PC 链接(`douyin.com/user/xxx`、`douyin.com/video/xxx`、`douyin.com/note/xxx`)、App 短链(`v.douyin.com/xxx`)、`iesdouyin.com` 分享链接、sec_uid、aweme_id。链接里的 `?from_tab_name=` 等参数会自动剥离,直接粘贴整段分享文案也可以。
  200. > **Q:单次最多多少条?调用失败扣不扣量?**
  201. >
  202. > A:技能侧硬上限 10000 条/次(按量 Token)。**包月 Token** 视频搜索/用户搜索/作品最多 30、评论最多 50,超限返回 `PLAN_LIMIT`(退出码 1),不要当网络错误重试。具体计费口径以官网说明为准。
  203. > **Q:报错 `PLAN_LIMIT` / 提示包月受限?**
  204. >
  205. > A:当前套餐单次条数不够。降低 `--limit` 后经用户同意再跑,或到 [评论区线索挖掘 API](https://www.guaikei.com) 升级按量套餐。**禁止同参重试,禁止擅自加大 limit。**
  206. > **Q:支持 Windows/Mac/Linux 吗?**
  207. >
  208. > A:全平台支持,仅需安装 Node.js(16.14.0+)。
  209. > **Q:支持批量抓多个账号吗?**
  210. >
  211. > A:当前版本一次抓取一个账号,多个账号请逐条执行。
  212. ## 🛑 错误处理与重试策略(AI 使用者必读)
  213. ### 遇到以下错误,立即停止操作并向用户报告
  214. - **权限错误**(退出码 3,`AUTH_REQUIRED`/`AUTH_ERROR`):TOKEN 未配置、无效或过期,提示用户重新配置,**不要重试**
  215. - **套餐条数超限**(退出码 1,`PLAN_LIMIT`):包月等套餐单次上限不足,转述 `message`,建议降 `--limit` 或升级;**不要同参重试**
  216. - **余额不足**(退出码 1,`INSUFFICIENT_BALANCE`):引导充值;**不要同参重试**
  217. - **提交过频**(退出码 1,`RATE_LIMITED`):稍后经用户同意再试;**不要立即重试**
  218. - **日消费上限**(退出码 1,`DAILY_LIMIT`):明日再试或到官网调整限额;**不要同参重试**
  219. - **网络超时**:可告知用户后重试,最多 1 次;仍失败则停止并报告
  220. ### 禁止行为
  221. - ❌ 不要在收到权限错误、`PLAN_LIMIT`、`INSUFFICIENT_BALANCE`、`RATE_LIMITED`、`DAILY_LIMIT` 后继续同参或立即重试
  222. - ❌ 不要在 API 返回明确错误码后擅自修改参数重试(`PLAN_LIMIT` 降 limit 须先征得用户同意)
  223. - ❌ 不要在用户未明确要求的情况下自动调整搜索条件
  224. - ❌ 不要编造数据。空结果是 `status:"empty"`、退出码 0,不要说成有结果
  225. ### 正确做法
  226. - ✅ 遇到错误,向用户展示错误信息(`error_code` + `message`)
  227. - ✅ 询问用户是否需要调整参数或重新尝试
  228. - ✅ 网络超时可重试,最多 1 次后停止
  229. ---
  230. ## 📞 帮助与支持
  231. - 🌐 **自助开通 TOKEN / 查阅使用帮助**:[GuaiKei 评论区线索挖掘](https://www.guaikei.com)
  232. > 🆕 [更新日志](references/changelog.md) | [options.md](references/options.md) | [contract.md](references/contract.md) | [errors.md](references/errors.md) | Agent 执行卡 [SKILL.md](SKILL.md)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.