Back to search
public-lead-mining
SkillWorks with Claude CodeGitHub
当用户需要从短视频评论区挖掘潜在客户或销售线索时使用本技能——按关键词搜索内容,再用内容ID拉取评论区数据,提取评论者的昵称、唯一标识、地区和需求表达,实现低成本线索挖掘与竞品截流。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/engheng-art--public-lead-mining)HTML
<a href="/listings/engheng-art--public-lead-mining"><img src="/api/listings/engheng-art--public-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
- ---
- name: public-lead-mining
- slug: public-lead-mining
- displayName: 🚀公域线索挖掘
- summary: 看实时热点,选话题关键词回去做搜索+评论
- description: 当用户需要从短视频评论区挖掘潜在客户或销售线索时使用本技能——按关键词搜索内容,再用内容ID拉取评论区数据,提取评论者的昵称、唯一标识、地区和需求表达,实现低成本线索挖掘与竞品截流。
- license: MIT
- version: 1.5.0
- metadata:
- openclaw:
- emoji: "🎬"
- primaryEnv: GUAIKEI_API_TOKEN
- requires:
- bins:
- - node
- env:
- - GUAIKEI_API_TOKEN
- enabled: true
- runtime: "nodejs@16.14.0+"
- env_desc:
- GUAIKEI_API_TOKEN: "抖音数据 API 访问令牌。未配置时无法调用接口;可通过 https://www.guaikei.com 开通并获取支持。"
- keywords:
- - "抖音"
- - "抖音搜索"
- - "抖音用户搜索"
- - "抖音热搜"
- - "抖音热榜"
- - "抖音评论"
- - "需求挖掘"
- - "痛点分析"
- - "评论挖掘"
- - "作品详情"
- - "博主作品"
- - "对标账号"
- - "获客"
- - "线索"
- - "竞品截流"
- - "短视频数据分析"
- - "douyin"
- - "douyin search"
- - "douyin user search"
- - "douyin hot"
- - "douyin comments"
- - "douyin detail"
- category:
- - "数据分析"
- - "内容创作"
- - "Data&APIs"
- tags:
- - "抖音"
- - "抖音搜索"
- - "抖音用户搜索"
- - "抖音热搜"
- - "抖音热榜"
- - "抖音评论"
- - "需求挖掘"
- - "痛点分析"
- - "视频数据"
- - "抖音作品"
- - "作品详情"
- - "博主主页"
- - "对标账号"
- - "获客"
- - "线索"
- - "竞品截流"
- - "选题"
- - "竞品分析"
- - "舆情监控"
- - "douyin"
- - "douyin-search"
- - "douyin-user-search"
- - "douyin-hot"
- - "douyin-comments"
- - "douyin-detail"
- examples:
- - '抖音上"AI 教程"最火的视频 → node src/douyin/search-cli.js --keyword "AI 教程" --sort 1'
- - '最近一周关于"AI 模型"的最新内容,要 20 条 → node src/douyin/search-cli.js --keyword "AI 模型" --sort 2 --time 7 --limit 20'
- - '找做 AI 的对标账号 / 搜达人 → node src/douyin/user-search-cli.js --keyword "AI" --limit 20'
- - "今天抖音有什么热点 / 热搜榜 → node src/douyin/hot-cli.js"
- - '这个博主最近 30 条作品 → node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 30'
- - '看看这个对标账号多少粉丝、多少获赞 → node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 0'
- - '这条视频的评论区都在说什么 → node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 40'
- - '这条视频的评论里有什么痛点 → 先确认至少取 50 条,同意后 node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 50,再读 references/demand-mining.md'
- - '按关键词在评论区找高意向客户 → node src/douyin/search-cli.js --keyword "装修" --sort 1 --limit 20,再用 aweme_id 跑 comment-cli,结束后读 references/customer-acquisition.md'
- - '这条视频多少播放、点赞和文案 → node src/douyin/detail-cli.js --url "https://www.douyin.com/video/xxx"'
- - '搜索结果里第 3 条不错,展开看看 → node src/douyin/detail-cli.js --url <上一条搜索结果里的 url>'
- - '用户搜索结果里这个账号不错,看主页作品 → node src/douyin/post-cli.js --url <上一条用户结果里的 author_url 或 sec_uid>'
- - '帮我找 1 分钟以内的减肥短视频,先来 30 条 → node src/douyin/search-cli.js --keyword "减肥" --duration 1 --limit 30'
- - '半年内最火的 AI 教程图文 → node src/douyin/search-cli.js --keyword "AI 教程" --sort 1 --time 180 --content 2'
- ---
- # 🚀公域线索挖掘|抖音关键词搜索、竞品分析、舆情监控与热榜跟踪工具 (Douyin Search & Analytics)
- 抖音公开数据只读:关键词搜视频/图文、用户/达人搜索、博主作品、作品详情、评论、热榜;输出结构化 JSON。适用于选题、对标账号、竞品、舆情、热点、需求挖掘、公域获客。
- ## 1. ⚠️ 执行前置(每次必过)
- 1. **先 `cd` 到本 SKILL.md 所在目录**,再执行 `node src/douyin/*.js`。
- 2. **确认 `GUAIKEI_API_TOKEN` 已配置**。未配置 → 不执行,走 `AUTH_REQUIRED`(见 §7 / [errors.md](references/errors.md)),禁止先跑「试试看」。
- 3. **一次只跑一条命令,等进程自己结束**。查询最多约 20 次退避;`--limit` 很大时最长约 22 分钟。**未退出前不要判定失败,不要并发/重复同一命令。**
- 4. **必填参数不齐先追问**(话术见 [ask.md](references/ask.md)),禁止猜测关键词或链接。
- > 开通[公域线索挖掘 官网](https://www.guaikei.com) TOKEN, 配 TOKEN / 落盘 / FAQ → [faq.md](references/faq.md)。
- ## 2. 💎 价值与典型场景(10 秒判断该不该用)
- | 你是谁 | 你要做的事 | 用哪个命令 |
- | --- | --- | --- |
- | 短视频运营 | 找爆款选题、看高赞内容的共同点 | `search-cli.js --sort 1` |
- | 运营 / 投放 | 按关键词找对标账号、达人 | `user-search-cli.js` |
- | 品牌 / 投放 | 监控已知账号的发文节奏与内容策略 | `post-cli.js` |
- | 内容分析 | 看一条视频的文案、播放和互动 | `detail-cli.js` |
- | 舆情 / 客服 | 判断一条视频的评论区在骂还是在夸 | `comment-cli.js` |
- | 产品 / 运营 | 从评论里看痛点和诉求 | `comment-cli.js`,再读 [demand-mining.md](references/demand-mining.md) |
- | 销售 / 增长 | 按关键词在评论区挖高意向线索 | `search`→`comment`,再读 [customer-acquisition.md](references/customer-acquisition.md) |
- | 所有人 | 今天抖音在火什么 | `hot-cli.js` |
- **典型产出**:结构化 JSON(标题、作者、互动、链接、时间),可导入 Excel/BI 或交给 AI 做选题/竞品/舆情/线索表。结果落盘到技能目录 `logs/`(热榜除外)。
- **为什么用它**:无需登录抖音;零第三方依赖;按量单次最多 1 万条;stdout 纯 JSON、日志走 stderr。
- > **合规**:调用会把关键词/链接发到 `www.guaikei.com`。不上传本地文件、不登录、无写操作。仅公开数据,限个人/团队内部分析。
- ## 3. 🎯 识别卡(选命令,命中即停)
- | 用户要什么 | 命令 | 最少要有 |
- | --- | --- | --- |
- | 搜视频/图文、爆款、选题 | `node src/douyin/search-cli.js` | `--keyword` |
- | 搜用户/达人/账号、按词找对标 | `node src/douyin/user-search-cli.js` | `--keyword` |
- | 已知博主的作品、粉丝数据 | `node src/douyin/post-cli.js` | 主页链接或 `sec_uid` |
- | 某条视频/图文的评论(含痛点) | `node src/douyin/comment-cli.js` | 视频链接或 `aweme_id` |
- | 某条视频/图文的详情、播放、文案 | `node src/douyin/detail-cli.js` | 视频链接或 `aweme_id` |
- | 热搜、热榜 | `node src/douyin/hot-cli.js` | 无参数 |
- - 痛点 / 需求挖掘:仍用 `comment-cli`;**成功后必须读** [demand-mining.md](references/demand-mining.md)。
- - 获客 / 线索 / 截流:`search-cli`(常 `--sort 1`)→ `aweme_id` 跑 `comment-cli`;**成功后必须读** [customer-acquisition.md](references/customer-acquisition.md)。
- - 「找客户」与「挖痛点」同时出现:**先追问**要哪一种([ask.md](references/ask.md))。
- ## 4. 🛠️ 命令一行例(详参下沉)
- > **详参 / 枚举**:可视化浏览查看 [options.md](references/options.md);也可参见 [readme.md](readme.md)(含命令参数详表)。**仅在需要确认枚举或拼参时再读,不要每次都读。**
- ```bash
- node src/douyin/search-cli.js --keyword "AI 教程" --sort 1 --limit 10
- node src/douyin/user-search-cli.js --keyword "AI" --limit 20
- node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 30
- node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 0
- node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 40
- node src/douyin/detail-cli.js --url "https://www.douyin.com/video/xxx"
- node src/douyin/hot-cli.js
- ```
- **数量 / 套餐**:未指定 `--limit` 默认 10;不要擅自抓 10000。技能硬上限 10000(按量)。**包月**超限 → `PLAN_LIMIT`:视频搜索/用户搜索/作品 ≤30,评论 ≤50;详情与热榜无此条数限制。
- 口语 → flag 对照 → [routing.md](references/routing.md)。
- ## 5. 🔀 意图路由(按序命中即停)
- ```
- 1. 热榜/热搜/今天什么火 → hot-cli
- 2. 获客+痛点同时出现 → 先追问(ask.md),禁止两边都做
- 3. 获客/线索/截流/高意向 → search→comment;结束后读 customer-acquisition.md
- 4. 评论/留言/痛点/需求挖掘 + 有视频 → comment-cli;痛点类结束后读 demand-mining.md
- 5. 痛点/需求挖掘但无视频链接 → 先追问链接
- 6. 单条详情/播放/点赞/文案 → detail-cli
- 7. 搜用户/达人/对标账号(关键词、无主页链接)→ user-search-cli
- 8. 已有主页/sec_uid 或要某账号作品列表 → post-cli
- 9. 有关键词且无以上信号 → search-cli
- 10. 都不明确 → 先追问(ask.md)
- ```
- 消歧:单独「视频」不要默认 post/detail。`/user/` → 只能 post;`/video|note/` + 评论 → comment,+ 播放/文案 → detail,都没说 → 追问。「对标」仅关键词 → user-search;已有链接 → post。
- ## 6. 📜 输出(摘要)
- - stdout = 统一 JSON 信封;stderr = 日志。向用户**只摘关键字段**,勿整份粘贴。
- - `status=empty` + `NO_MATCH` 退出码 0,**不是失败**。
- - `results`:搜/用户/评论/热榜 = 数组;作品 = `{post,user}`;详情 = 单对象。
- 完整信封与形态 → [contract.md](references/contract.md)。JSON Schema 文件在 `assets/`(入参/出参/信封),清单见 [readme.md](readme.md) 参数章。
- ## 7. 🚨 错误应对(摘要)
- | error_code | 退出码 | Agent |
- | --- | --- | --- |
- | `AUTH_*` | 3 | **禁止重试**;引导官网配 TOKEN |
- | `PLAN_LIMIT` | 1 | **禁止同参重试**;降 limit 须用户同意 |
- | `INSUFFICIENT_BALANCE` / `DAILY_LIMIT` | 1 | **禁止同参重试**;充值或明日/调限额 |
- | `RATE_LIMITED` | 1 | **禁止立即重试** |
- | `INVALID_*` | 1/2 | 换词/换链/按 help 改一次;禁止擅自改默认再跑 |
- | `NO_MATCH` | 0 | 如实无结果 |
- | `TIMEOUT` / `NETWORK_ERROR` | 1 | 同参续等最多 1 次(搜/用户约 9 分钟、作品/详情/评论约 20 分钟复用);禁止改参「重做」 |
- 全表 → [errors.md](references/errors.md)。
- ## 8. 🛑 硬性禁止
- - 不得编造数据;不得把空结果说成有结果。
- - 不得未征得同意就自动改搜索条件重试。
- - `AUTH_*` / `PLAN_LIMIT` / `INSUFFICIENT_BALANCE` / `RATE_LIMITED` / `DAILY_LIMIT` 后不得同参或立即重试。
- - 不得把 stderr 原文转述给用户。
- - 不得做登录态/私密获取或任何写操作;不得编造手机号/微信号或骚扰脚本。
- - 不得在未 cd 到技能目录时执行 `node src/douyin/*.js`。
- ## 9. 📚 何时读 references(入口总表)
- | 时机 | 打开 |
- | --- | --- |
- | 确认枚举/参数取值 | [options.md](references/options.md) |
- | 口语指令 → flag | [routing.md](references/routing.md) |
- | 信封 / `results` 形态 | [contract.md](references/contract.md) |
- | 完整错误表 | [errors.md](references/errors.md) |
- | 缺参追问话术 | [ask.md](references/ask.md) |
- | 环境 / FAQ | [faq.md](references/faq.md) |
- | 需求挖掘(取数成功后) | [demand-mining.md](references/demand-mining.md) |
- | 公域获客(取数成功后) | [customer-acquisition.md](references/customer-acquisition.md) |
- | 版本变更 | [changelog.md](references/changelog.md) |
- | 技术人员总览(含命令参数详表 / Schema 清单) | [readme.md](readme.md) |
- | 机器可校验 Schema | `assets/*.schema.json` |
readme.md · README · 313 lines
- # 🚀公域线索挖掘|抖音数据采集工具·关键词搜索 · 用户搜索 · 博主作品 · 作品详情 · 视频评论 · 实时热榜(无需登录 / 不封号)
- > **💡一句话价值**:一条命令拿到抖音公开的视频/用户/作者/作品详情/评论/热榜数据,直接输出结构化 JSON——做爆款选题、找对标账号、公域获客、账号监控、单条作品数据和热点追踪,不用再手动刷抖音。
- **一句话简介**:抖音公开数据只读技能,支持关键词搜索视频与图文、用户/达人搜索、博主作品与粉丝数据、单条作品详情、视频图文评论、实时热榜,并可按剧本做需求挖掘与公域获客(search→comment),全部以结构化 JSON 输出,不登录、不发布、不点赞、不评论。关键词:抖音搜索、抖音用户搜索、抖音热搜、抖音热榜、抖音评论、需求挖掘、获客、线索、竞品截流、痛点、播放量、作品详情、博主作品、对标账号、竞品分析、选题挖掘、舆情监控、douyin search、douyin user search、douyin hot、douyin detail、douyin comments。
- **维护状态**:持续更新中,当前版本 `1.5.0`,[更新日志](references/changelog.md)。Agent 执行卡见 [SKILL.md](SKILL.md)。
- > **🔥核心优势**
- >
- > - 安全:无需登录你的抖音账号,不存在风控 / 封号问题
- > - 强大:按量 Token 单次最多 10000 条;包月 Token 视频搜索/用户搜索/作品最多 30、评论最多 50
- > - 全面:出参覆盖作者、互动(点赞/评论/收藏/分享/推荐)、标签、链接、音乐、话题等可用字段
- > - 灵活:支持排序(综合/最多点赞/最新)、时间(1天/7天/半年)、时长、内容类型(视频/图文)多维度筛选
- > - 轻量:零第三方依赖,Node.js 内置模块直接跑,无需部署服务
- > - 友好:stdout 纯 JSON、日志走 stderr,AI 可直接解析;结果自动落盘便于二次分析
- ## ✅ 我能帮你解决什么(10 秒判断)
- | 你是谁 | 你要做的事 | 用哪个功能 |
- | ---------- | -------------------------------- | --------------------------- |
- | 短视频运营 | 找爆款选题、分析高赞视频规律 | 关键词搜索(点赞/最新排序) |
- | 运营/投放 | 按关键词找对标账号、达人 | 用户搜索 |
- | 销售/增长 | 评论区挖高意向线索、竞品截流 | 搜索→评论 + [获客剧本](references/customer-acquisition.md) |
- | 品牌/投放 | 监控已知账号的内容策略和发文节奏 | 博主作品抓取 |
- | 内容分析 | 看一条视频的文案、播放和互动 | 作品详情 |
- | 舆情/客服 | 看一条视频评论区在骂还是在夸 | 评论抓取 |
- | 内容策划 | 快速追热点、找当天的流量入口 | 实时热榜 |
- | 数据分析 | 把抖音数据导入 Excel/BI 做周报 | 结构化 JSON + 日志落盘 |
- **典型产出**:结构化 JSON(含标题、作者、点赞/评论/收藏/分享、标签、视频链接、发布时间),可直接导入 Excel / BI,或交给 AI 生成**选题库、竞品对比表、舆情周报、发文节奏分析、公域线索表**。剧本见 [需求挖掘](references/demand-mining.md)、[公域获客](references/customer-acquisition.md)。
- ---
- ## 🚀 3 步接入
- 1. **装 Node.js**(16.14.0+,Windows/Mac/Linux 均可,约 2 分钟)
- 2. **拿 TOKEN**:访问 [公域线索挖掘 官网](https://www.guaikei.com) 自助开通,配置环境变量 `GUAIKEI_API_TOKEN`
- - Windows cmd:`set GUAIKEI_API_TOKEN=你的TOKEN`
- - Windows PowerShell:`$env:GUAIKEI_API_TOKEN="你的TOKEN"`
- - Linux/MacOS:`export GUAIKEI_API_TOKEN=你的TOKEN`
- 3. **进入技能目录后执行一条命令**:
- ```bash
- cd <本技能所在目录> # 即 readme.md / SKILL.md 所在的那一层
- node src/douyin/hot-cli.js
- ```
- > ⚠️ 一次只跑一条命令,跑完等进程自己退出。小查询常常十几秒;`--limit` 很大时最长约 15–22 分钟,**进程未退出前不要重复发起同一条命令**。
- ---
- ### 最快上手(复制就能跑)
- ```bash
- # 🔎 搜"AI"相关的抖音视频
- node src/douyin/search-cli.js --keyword "AI"
- # 🔎 按点赞排序找爆款(最常用)
- node src/douyin/search-cli.js --keyword "AI" --sort 1
- # 🔎 近 7 天"AI 模型"的最新 20 条
- node src/douyin/search-cli.js --keyword "AI 模型" --sort 2 --time 7 --limit 20
- # 👤 按关键词找用户 / 对标账号
- node src/douyin/user-search-cli.js --keyword "AI" --limit 20
- # 🦸 抓某个博主的作品(直接粘贴 App 分享链接也行)
- node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 20
- # 🦸 只要博主的粉丝数 / 获赞数等互动数据
- node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 0
- # 💬 看这条视频的评论
- node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 100
- # 📄 看这条视频的详情(文案、播放、点赞、作者)
- node src/douyin/detail-cli.js --url "https://www.douyin.com/video/xxx"
- # 📡 抖音实时热榜
- node src/douyin/hot-cli.js
- ```
- > 💡 Windows cmd.exe 下请使用双引号;PowerShell / bash 可直接执行。
- > 💡 支持直接粘贴 App 分享文案(含"复制到剪贴板…"字样和短链),链接会自动抽取、参数自动清理。
- ---
- ### 你会得到什么(真实输出结构示例)
- ```json
- {
- "status": "success",
- "error_code": "OK",
- "message": "搜索任务完成",
- "timestamp": "2026/9/4 20:13:20",
- "request": {
- "command": "search",
- "keyword": "AI 教程",
- "sort": 1,
- "limit": 20
- },
- "metadata": {
- "skill_version": "1.5.0",
- "runtime_version": "22.x",
- "execution_time": 34210
- },
- "results": [
- {
- "aweme_id": "7625...",
- "desc": "3 分钟讲透 RAG…",
- "author_nickname": "某某说AI",
- "author_sec_uid": "MS4wLjABAAAA…",
- "author_url": "https://www.douyin.com/user/MS4wLjABAAAA…",
- "digg_count": 13324,
- "comment_count": 118,
- "share_count": 2861,
- "collect_count": 11486,
- "url": "https://www.douyin.com/video/7625...",
- "create_time": 1775434101,
- "create_time_str": "2026/4/5 10:08:21",
- "tags": ["#AI", "#教程"]
- }
- ]
- }
- ```
- - 视频搜索、用户搜索、评论、热榜成功时 `results` 是**数组**;博主作品成功时 `results` 是**对象**,包含 `post`(作品数组)和 `user`(博主信息)。
- - 空结果是 `"status": "empty"` + `error_code: "NO_MATCH"`,**退出码仍然是 0,属正常情况,不是失败**。
- - 字段较多(含封面图、播放地址等长 URL),向用户汇报时建议只摘取 `desc` / `author_nickname` / `digg_count` / `url` / `create_time_str` 等关键字段。
- ---
- ## 📌 适用场景(我该不该用?)
- - 需要短视频选题 → 关键词搜索 + 点赞排序(`--sort 1`)
- - 需要按词找对标账号 / 达人 → 用户搜索(`user-search-cli.js`)
- - 需要研究已知账号 → 按主页链接抓取其公开作品(**一次抓一个账号**,多个账号逐条执行)
- - 需要看账号体量 → 作品命令加 `--limit 0`,直接拿粉丝数 / 获赞数
- - 需要分析内容舆情 → 获取视频/图文评论,可做观点聚类
- - 需要快速追热点 → 实时热榜(约 50 条,含排名与热度值)
- - 需要做营销报告 → 输出结构化 JSON 并自动落盘,便于复盘与二次分析
- ## 🔍 和其他方式比,凭什么用它?
- | 对比项 | 本技能 | 手动刷抖音 | 自己写爬虫 |
- | -------------- | -------------------------- | --------------------- | ---------------------------- |
- | 上手成本 | 一条命令,5 分钟接入 | 0,但整理数据极费时间 | 需要逆向/维护,门槛高 |
- | 登录与封号风险 | **无需登录,只读公开数据** | 无 | 高(需带登录态,易触发风控) |
- | 数据结构 | 标准 JSON,字段齐全 | 手抄 | 自己定义 |
- | 单次规模 | 按量最多 10000;包月满足基本使用 | 受限于人肉 | 受限于风控 |
- | 维护成本 | 平台负责更新 | 无 | 接口一变就失效 |
- | 配合 AI 分析 | 天然适配(stdout 纯 JSON) | 不适配 | 需额外处理 |
- ---
- ## 🔧 命令与参数详表
- > 口语化指令枚举续读 [references/options.md](references/options.md)。机器 Schema 见 `assets/`。信封与 `results` 形态见 [references/contract.md](references/contract.md)。
- ### 关键词搜索 `search-cli.js`
- | 参数 | 缩写 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- | --- |
- | `--keyword` | `-k` | ✅ | 2–50 个字符,不能是链接,不含 `< > " ' &` | — |
- | `--sort` | `-s` | | 0 综合 / 1 最多点赞 / 2 最新发布 | 0 |
- | `--time` | `-t` | | 0 全部 / 1 一天内 / 7 七天内 / 180 半年内 | 0 |
- | `--duration` | `-d` | | 0 不限 / 1 1分钟以下 / 2 1-5分钟 / 3 5分钟以上 | 0 |
- | `--content` | `-c` | | 0 不限 / 1 视频 / 2 图文 | 0 |
- | `--limit` | `-l` | | 1–10000(**包月 Token 实际最多 30**) | 10 |
- 未指定 `--limit` 时只返回 10 条。用户说「全部」再显式加大,不要自作主张抓 10000。关键词以 `-` 开头时写成 `--keyword=-AI`,或 `node src/douyin/search-cli.js -- -AI`。
- **套餐双上限**:技能硬上限 10000(按量)。**包月**超限返回 `PLAN_LIMIT`:视频搜索/用户搜索/作品最多 **30**,评论最多 **50**;详情与热榜无此条数限制。
- ### 用户搜索 `user-search-cli.js`
- 按关键词搜用户/达人/账号。成功时 `results` 是**用户数组**(含 `sec_uid`、`nickname`、`fans` 等;有 `sec_uid` 时含 `author_url`)。**不是**视频搜索。暂不支持粉丝量/认证类型筛选。
- | 参数 | 缩写 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- | --- |
- | `--keyword` | `-k` | ✅ | 2–50 个字符,不能是链接,不含 `< > " ' &` | — |
- | `--limit` | `-l` | | 1–10000(**包月最多 30**) | 10 |
- 找到账号后要看作品,用 `author_url` 或 `sec_uid` 再跑 `post-cli.js`。
- ### 博主作品 `post-cli.js`
- | 参数 | 缩写 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- | --- |
- | `--url` | `-u` | ✅ | `douyin.com/user/xxx`、`v.douyin.com/xxx`,或 `sec_uid`(`MS4wLjA` 开头) | — |
- | `--limit` | `-l` | | 0–10000(**包月最多 30**;**`0` = 只取博主互动数据**) | 10 |
- 成功时 `results` 是**对象**,含 `post`(作品数组)和 `user`(博主信息)。
- ### 视频评论 `comment-cli.js`
- | 参数 | 缩写 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- | --- |
- | `--url` | `-u` | ✅ | `douyin.com/video/xxx`、`douyin.com/note/xxx`、`v.douyin.com/xxx`,或纯数字 `aweme_id` | — |
- | `--limit` | `-l` | | 1–10000(**包月最多 50**) | 10 |
- ### 作品详情 `detail-cli.js`
- | 参数 | 缩写 | 必填 | 取值 | 默认 |
- | --- | --- | --- | --- | --- |
- | `--url` | `-u` | ✅ | `douyin.com/video/xxx`、`douyin.com/note/xxx`、`v.douyin.com/xxx`,或纯数字 `aweme_id` | — |
- 没有 `--limit`。成功时 `results` 是**一条作品对象**,不是数组,也不含评论。图文(note)通常没有播放数和时长。
- ### 实时热榜 `hot-cli.js`
- 不接受参数。返回约 50 条。失败时最多重试 3 次,不走长查询。
- ### Schema 入口
- - 输出信封 [output_envelope.schema.json](assets/output_envelope.schema.json)
- - 关键词搜索 [入参](assets/search_cli_req.schema.json) / [出参](assets/search_cli_resp.schema.json)
- - 用户搜索 [入参](assets/user_search_cli_req.schema.json) / [出参](assets/user_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)
- - 作品详情 [入参](assets/detail_cli_req.schema.json) / [出参](assets/detail_cli_resp.schema.json)
- - 热榜 [出参](assets/hot_cli_resp.schema.json)
- 口语 → 命令对照:[references/routing.md](references/routing.md)。错误全表:[references/errors.md](references/errors.md)。
- ---
- ## ⚠️ 重要限制(不踩坑)
- - 仅抓取抖音**公开**数据,不支持私密/隐藏内容
- - 需要配置 `GUAIKEI_API_TOKEN` 才能运行;调用会把关键词/链接发送至第三方 API( www.guaikei.com )
- - 数据仅限个人/团队内部使用,禁止违规分发
- - 小查询常常十几秒内结束,条数越大越慢。进程会自己创建任务并继续查询,最长约 15–22 分钟才结束
- - 播放地址和分享链接有时效,过期后需要重新获取
- ---
- ## ❓ 常见问题(秒解决)
- > **Q:运行报错,提示无权限 / 退出码 3?**
- >
- > A:`GUAIKEI_API_TOKEN` 未配置、格式无效或已过期。令牌须为 16-256 位字母、数字、下划线或连字符。配置方式见上文"3 步接入"。请注意保密,不要泄露给他人。
- > **Q:搜索结果为空?**
- >
- > A:换常用关键词,或把 `--time` 改为 0(全部时间)。空结果退出码为 0,属正常情况。
- > **Q:提示 `Cannot find module`?**
- >
- > A:没有先进入技能目录。先 `cd` 到 `SKILL.md` / `readme.md` 所在目录,再执行 `node src/douyin/...`。
- > **Q:输出文件在哪里?**
- >
- > A:搜索 / 用户搜索 / 作品 / 评论 / 作品详情任务的结果会自动保存在技能目录的 `logs/` 下:
- >
- > - 搜索任务:`时间戳_关键词_排序_时间_时长_类型_search.json`
- > - 用户搜索:`时间戳_关键词_数量_user_search.json`
- > - 博主作品:`时间戳_博主sec_uid或短链码_post.json`
- > - 评论获取:`时间戳_视频aweme_id或短链码_comment.json`
- > - 作品详情:`时间戳_视频aweme_id或短链码_detail.json`
- > - (热榜为实时直读,不落盘)
- > **Q:支持哪些链接形式?**
- >
- > 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=` 等参数会自动剥离,直接粘贴整段分享文案也可以。
- > **Q:单次最多多少条?调用失败扣不扣量?**
- >
- > A:技能侧硬上限 10000 条/次(按量 Token)。**包月 Token** 视频搜索/用户搜索/作品最多 30、评论最多 50,超限返回 `PLAN_LIMIT`(退出码 1),不要当网络错误重试。具体计费口径以官网说明为准。
- > **Q:报错 `PLAN_LIMIT` / 提示包月受限?**
- >
- > A:当前套餐单次条数不够。降低 `--limit` 后经用户同意再跑,或到 [公域线索挖掘 API](https://www.guaikei.com) 升级按量套餐。**禁止同参重试,禁止擅自加大 limit。**
- > **Q:支持 Windows/Mac/Linux 吗?**
- >
- > A:全平台支持,仅需安装 Node.js(16.14.0+)。
- > **Q:支持批量抓多个账号吗?**
- >
- > A:当前版本一次抓取一个账号,多个账号请逐条执行。
- ## 🛑 错误处理与重试策略(AI 使用者必读)
- ### 遇到以下错误,立即停止操作并向用户报告
- - **权限错误**(退出码 3,`AUTH_REQUIRED`/`AUTH_ERROR`):TOKEN 未配置、无效或过期,提示用户重新配置,**不要重试**
- - **套餐条数超限**(退出码 1,`PLAN_LIMIT`):包月等套餐单次上限不足,转述 `message`,建议降 `--limit` 或升级;**不要同参重试**
- - **余额不足**(退出码 1,`INSUFFICIENT_BALANCE`):引导充值;**不要同参重试**
- - **提交过频**(退出码 1,`RATE_LIMITED`):稍后经用户同意再试;**不要立即重试**
- - **日消费上限**(退出码 1,`DAILY_LIMIT`):明日再试或到官网调整限额;**不要同参重试**
- - **网络超时**:可告知用户后重试,最多 1 次;仍失败则停止并报告
- ### 禁止行为
- - ❌ 不要在收到权限错误、`PLAN_LIMIT`、`INSUFFICIENT_BALANCE`、`RATE_LIMITED`、`DAILY_LIMIT` 后继续同参或立即重试
- - ❌ 不要在 API 返回明确错误码后擅自修改参数重试(`PLAN_LIMIT` 降 limit 须先征得用户同意)
- - ❌ 不要在用户未明确要求的情况下自动调整搜索条件
- - ❌ 不要编造数据。空结果是 `status:"empty"`、退出码 0,不要说成有结果
- ### 正确做法
- - ✅ 遇到错误,向用户展示错误信息(`error_code` + `message`)
- - ✅ 询问用户是否需要调整参数或重新尝试
- - ✅ 网络超时可重试,最多 1 次后停止
- ---
- ## 📞 帮助与支持
- - 🌐 **自助开通 TOKEN / 查阅使用帮助**:[GuaiKei 公域线索挖掘](https://www.guaikei.com)
- > 🆕 [更新日志](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 inFree to use. If it’s helped, pass it on.