原始内容
name: douyin-search-keyword description: 抖音公开数据智能获取工具。支持抖音关键词搜索、抖人作品抓取、获取作品评论、实时热榜跟踪,适用于短视频营销、竞品分析、舆情分析和热点监控,助力爆款内容策划与流量追踪。 license: MIT metadata: version: 1.1.6 enabled: true type: command runtime: "nodejs@16.14.0+" requires: bins: - "node" env: - "GUAIKEI_API_TOKEN" category: - "Data&APIs" - "内容创作" tags: - "douyin" - "抖音" - "search" - "搜索" - "数据挖掘" - "content-analysis" - "营销分析" - "数据分析" - "competitor-analysis" - "竞品分析" - "评论分析" - "热点追踪" - "marketing" - "trend-tracking" - "workflow" - "insight" - "automation" schemas: - 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/hot_cli_resp.schema.json" - name: "评论入参" file: "assets/comment_cli_req.schema.json" - name: "评论出参" file: "assets/comment_cli_resp.schema.json" examples: - name: 搜索 AI 教程视频 command: 'node src/douyin/search-cli.js --keyword "AI 教程"' description: 用户说"搜索 AI 教程"时使用 - name: 找点赞最多的视频 command: 'node src/douyin/search-cli.js --keyword "AI" --sort 1' description: 用户说"找最火的 AI 视频"时使用 - name: 最新发布的内容 command: 'node src/douyin/search-cli.js --keyword "AI 模型" --time 7' description: 用户说"最新的 AI 模型视频"时使用 - name: 搜索半年内最新20条 AI 教程视频 command: 'node src/douyin/search-cli.js --keyword "AI 教程" --sort 2 --time 180 --limit 20' description: 用户说"半年内最新 AI 教程视频"时使用 - name: 获取博主作品 command: 'node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx"' description: 用户说"查看这个博主的作品"时使用 - name: 获取视频评论 command: 'node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx"' description: 用户说"看看这个视频的评论"时使用 - name: 获取热榜 command: "node src/douyin/hot-cli.js" description: 用户说"抖音今天有什么热点"时使用
🚀 抖音关键词搜索、竞品分析、舆情监控与热点跟踪工具 (Douyin Search & Analytics)
💡一句话价值:一键抓取抖音公开视频/作者/评论/热榜数据,帮你做爆款选题、竞品分析、舆情监控、热点追踪。
🔥核心优势
- 安全: 无需登录你的抖音账号,不担心风控风险 / 封号问题
- 强大: 一次可获取最多1W条数据,技能内置批量操作,使用简单方便
- 全面: 各功能出参数据全面,可见及有价值数据都会返回
- 灵活: 支持多维度筛选、批量操作
- 轻量: 无需部署服务,Node.js 一键运行
- 低耗: 日志自动归档,适配营销报告 / 内容策划场景 ,便于数据二次分析
1. ✅ 我能帮你解决什么(10 秒判断)
- 🔍 按关键词搜抖音视频(点赞/最新排序):找爆款选题、分析高赞视频规律
- 🦸 竞品监控:批量抓取对标账号所有公开作品数据,分析内容策略
- 💬 评论分析:获取抖音评论详情,分析舆情方向
- 📡 热点追流:实时获取抖音热榜,抢占流量风口
- 📊 数据导出:自动生成JSON日志,方便对比分析和使用
2. 🚀 最快上手(复制就能跑,30 秒出结果)
Note: 请先通过微信 <13395823479> 申请TOKEN ,或访问抖音搜索技能官网开通TOKEN,配置环境变量
GUAIKEI_API_TOKEN后才能正常运行。
2.1 🔎 抖音关键词搜索(最简单)
node src/douyin/search-cli.js --keyword "AI"
2.2 🔎 按点赞排序找爆款(最常用)
node src/douyin/search-cli.js --keyword "AI" --sort 1
2.3 🦸 抓取抖音抖人全部作品
node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx"
2.4 💬 获取抖音作品评论内容
node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx"
2.5 📡 获取抖音实时热榜
node src/douyin/hot-cli.js
3. 📌 适用场景(我该不该用?)
- 你需要做短视频选题 → 关键词搜索 + 点赞排序
- 你需要模仿爆款文案 → 查看高赞视频详情
- 你需要监控竞品账号 → 批量抓取对方作品
- 你需要分析内容舆情 → 获取抖音评论详情
- 你需要快速追热点 → 实时获取抖音热榜
- 你需要做营销报告 → 导出结构化数据
4. 🔧 参数详解表
详细选项参数说明, 可参阅 完整选项说明
LLM理解技能的详细选项,可参阅技能
assets目录中文件,其遵循 JSON Schema draft-07 版本规范。
5. ⚠️ 重要限制(不踩坑)
- 仅抓取抖音公开数据,不支持私密 / 隐藏内容
- 需要配置 GUAIKEI_API_TOKEN 才能正常运行
- 数据仅限个人 / 团队内部使用,禁止违规分发
6. ❓ 常见问题(秒解决)
💡Q:运行报错,提示无权限?
A:配置环境变量:
- Windows:
set GUAIKEI_API_TOKEN=你的TOKEN- Linux/MacOS:
export GUAIKEI_API_TOKEN=你的TOKEN- 私有TOKEN申请后请留意使用安全,避免泄露给他人
💡Q:搜索结果为空?
A:换常用关键词,或把
--time改为 0(全部时间)💡Q:输出文件在哪里?
A:自动保存在技能目录的
logs文件夹下
- 搜索任务日志: 默认保存为「时间戳_关键词_排序_时间_时长_search.json」
- 抖人作品获取日志: 默认保存为「时间戳_(抖人sec_uid)_post.json」
- 抖音评论获取日志: 默认保存为「时间戳_(视频aweme_id)_comment.json」
💡Q:支持 Windows/Mac/Linux 吗?
A:全平台支持,仅需安装 Node.js 环境
7. 📞 帮助与支持
- 联系微信 13395823479(备注抖音技能)开通TOKEN或获得技能使用支持;
- 或通过 抖音关键词搜索技能官网 自助开通TOKEN或查阅使用帮助。
🆕 更新日志 可查阅这里
8. 🛑 错误处理与重试策略(重要)
8.1 遇到以下错误,立即停止操作并向用户报告
- 权限错误(AUTH_ERROR):TOKEN 无效或已过期,请提示用户重新配置
- API 次数超限:提示用户联系客服开通更高额度
- 网络错误连续 3 次失败:提示用户检查网络连接
8.2 禁止行为
- ❌ 不要在收到 AUTH_ERROR 后继续重试
- ❌ 不要在 API 返回明确错误码后尝试修改参数重试
- ❌ 不要在用户未明确要求的情况下自动调整搜索条件
8.3 正确做法
- ✅ 遇到错误,立即向用户展示错误信息
- ✅ 询问用户是否需要调整参数或重新尝试
- ✅ 对于网络超时,可以尝试最多 3 次之后停止
9. 💬 自然语言指令映射(AI 快速参考)
统一调用约定(重要)
- 必须在技能根目录执行。
- 需要被 AI / 程序解析时,加
--json:只输出纯 JSON 到 stdout,日志与 banner 走 stderr,便于稳定解析。- 退出码约定:
0=成功(含 empty),1=运行错误,3=auth_required(缺/错 token)。
9.1 搜索功能
| 用户口语化指令 | 对应命令 | 参数推导 |
|---|---|---|
| "搜索 / 搜一下 / 找 AI 相关视频" | node src/douyin/search-cli.js --keyword "AI" |
带关键词即搜索 |
| "找点赞最多的 / 最火的 AI 视频" | node src/douyin/search-cli.js --keyword "AI" --sort 1 |
最火/点赞最多 → sort=1 |
| "最新的 AI 教程,要 20 条" | node src/douyin/search-cli.js --keyword "AI 教程" --sort 2 --limit 20 |
最新 → sort=2;数量 → limit |
| "近一周最火的短视频" | node src/douyin/search-cli.js --keyword "短视频" --time 7 --sort 1 |
一周 → time=7;最火 → sort=1 |
| "半年内最新 20 条 AI 教程" | node src/douyin/search-cli.js --keyword "AI 教程" --sort 2 --time 180 --limit 20 |
半年 → time=180 |
| "减肥视频,只要 1 分钟以下的" | node src/douyin/search-cli.js --keyword "减肥" --duration 1 |
见下方 duration 表 |
| "AI 模型,5 分钟以上的,前 50 条" | node src/douyin/search-cli.js --keyword "AI 模型" --duration 3 --limit 50 |
5分钟以上 → duration=3 |
9.2 竞品监控
| 用户口语化指令 | 对应命令 | 参数推导 |
|---|---|---|
| "查看这个博主的所有作品 / 主页" | node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" |
作品/主页/账号 → post |
| "抓取 MS4wLjABxxx 的作品" | node src/douyin/post-cli.js --url "MS4wLjABxxx" |
sec_uid 直接可用 |
| "获取他最近 50 条视频" | node src/douyin/post-cli.js --url "xxx" --limit 50 |
数量 → limit |
9.3 评论分析
| 用户口语化指令 | 对应命令 | 参数推导 |
|---|---|---|
| "看看这个视频的评论 / 留言" | node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" |
评论/留言 → comment |
| "获取这条视频的 100 条评论" | node src/douyin/comment-cli.js --url "xxx" --limit 100 |
数量 → limit |
9.4 热榜
| 用户口语化指令 | 对应命令 |
|---|---|
| "抖音今天有什么热点 / 热搜榜 / 热点榜单" | node src/douyin/hot-cli.js |
10. 🧠 AI 意图识别规则
10.1 识别优先级(从上到下)
- 热搜 / 热点 / 榜单 / 今天什么火 →
hot-cli.js - 搜索 / 搜一下 / 找 + 关键词 →
search-cli.js - 评论 / 留言 / 弹幕 →
comment-cli.js(必须出现"评论"类词才归此类) - 作品 / 视频(指博主内容) / 主页 / 账号 / 博主 →
post-cli.js
⚠️ 歧义提示:单独出现"视频"二字时,不要默认归到 post-cli。
- 若同时有"关键词"且无"评论" → 视为
search(用户想搜某个视频)。- 若明确"这个视频的评论/留言" →
comment。- 仅当"作品/主页/账号/博主"出现时才用
post。
10.2 参数推断规则
排序(sort,与 time 正交)
- 提到"综合 / 默认" →
sort=0 - 提到"点赞最多 / 最火 / 爆款" →
sort=1 - 提到"最新 / 最近发布 / 刚发" →
sort=2
时间窗(time)
- 提到"全部 / 不限制" →
time=0 - 提到"一天 / 24小时" →
time=1 - 提到"一周 / 7天" →
time=7 - 提到"半年" →
time=180
时长
- 提到"1分钟以下 / 短于1分钟" →
duration=1 - 提到"1到5分钟 / 1-5分钟" →
duration=2 - 提到"5分钟以上" →
duration=3 - 提到"不限时长" →
duration=0
数量(limit)
- 提到"条数 / 数量 / N条 / 前N条" →
limit=N
10.3 默认值
- sort: 0(综合)|time: 0(全部)|duration: 0(不限)|limit: 10