抖音搜索关键词、竞品分析、舆情监控与热榜跟踪工具
抖音公开数据只读工具箱,提供4个能力:①关键词搜索(可按点赞/最新排序、时间窗、时长、图文类型筛选)②博主主页作品抓取 ③视频/图文评论抓取 ④实时热榜。输出结构化 JSON(含作者、互动数据、标签、链接)。当用户需要搜抖音视频、抓博主作品、看抖音评论、查抖音热榜、做竞品/对标账号监控、短视频选题调研、评论舆情分析、热点追踪、爆款挖掘时使用。触发词:抖音搜索、抖音热榜、抖音评论、抖音作品、博主作品、对标账号、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点、舆情监控、热点追踪、爆款挖掘、douyin search、douyin hot search、douyin comments
Rank
62
Safety
84
Downloads
3.2k
Updated
Oct 9, 2026
Version
1.3.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 3.2K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 3.2K downloadsadoption · observed Oct 9, 2026
- Latest release
- 1.3.0release · observed Sep 13, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17dekqcarz582t04nvd15aj1183gf0v:douyin-search-keyword- Install using `clawhub skill install s17dekqcarz582t04nvd15aj1183gf0v:douyin-search-keyword` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/um-why/douyin-search-keyword before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/snapshot"
Documentation
CLAWHUB
155,482 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: douyin-search-keyword description: 抖音公开数据只读工具箱,提供4个能力:①关键词搜索(可按点赞/最新排序、时间窗、时长、图文类型筛选)②博主主页作品抓取 ③视频/图文评论抓取 ④实时热榜。输出结构化 JSON(含作者、互动数据、标签、链接)。当用户需要搜抖音视频、抓博主作品、看抖音评论、查抖音热榜、做竞品/对标账号监控、短视频选题调研、评论舆情分析、热点追踪、爆款挖掘时使用。触发词:抖音搜索、抖音热榜、抖音评论、抖音作品、博主作品、对标账号、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点、舆情监控、热点追踪、爆款挖掘、douyin search、douyin hot search、douyin comments。 license: MIT metadata: enabled: true type: command runtime: "[email protected]+" version: 1.3.0 requires: bins: - "node" env: - "GUAIKEI_API_TOKEN" env_desc: GUAIKEI_API_TOKEN: "抖音数据 API 访问令牌。未配置时无法调用接口;可通过 https://www.guaikei.com 开通,或联系开发者(wx 13395823479)获取支持。" category: - "Data&APIs" - "内容创作" - "数据分析" - "商业运营" - "办公效率" tags: - "抖音" - "douyin" - "抖音搜索" - "抖音热榜" - "抖音评论" - "抖音作品" - "抖音竞品分析" - "抖音数据分析" - "短视频运营" - "短视频" - "舆情监控" - "热点追踪" - "爆款挖掘" - "竞品分析" - "营销分析" - "search" - "数据挖掘" - "content-analysis" - "competitor-analysis" - "marketing" - "trend-tracking" 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: - '搜抖音里"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' - "查抖音今天有什么热点/热搜榜: node src/douyin/hot-cli.js" - '抓这个抖音博主最近 30 条作品: node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 30' - '看这条抖音视频的 40 条评论: node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 40' --- # 🚀 抖音关键词搜索、竞品分析、舆情监控与热榜跟踪工具 (Douyin Search & Analytics) ## 1. 🛠️ 技能概述 抖音公开数据只读获取工具。支持**关键词搜索排序**、**博主作品抓取**、**视频/图文评论抓取**、**实时热榜获取**,输出结构化 JSON,适用于短视频选题、竞品监控、舆情分析、热点追踪。 > **合规前置说明(重要)**:调用本技能会把用户提供的关键词/链接发送至第三方数据 API(域名 `www.guaikei.com`)以换取结果。本技能不上传任何本地文件,不登录任何账号,无任何写操作(不发布/点赞/评论/关注)。仅处理抖音公开数据,不支持私密/登录态数据;数据仅限个人/团队内部分析。 **🔥 核心特性** - 安全:无需登录抖音账号,无风控/封号风险 - 强大:单次最多可获取 1W 条数据 - 全面:出参覆盖作者、互动、标签、链接等可用数据及有价值数据都会返回 - 轻量:零第三方依赖,Node.js 内置模块直接运行 - 友好:stdout 纯 JSON、日志走 stderr,便于 AI 稳定解析 ## 2. ✅ 何时调用与能力边界 **🎯 应调用**: - 用户明确要查 **抖音** 的公开内容(视频/图文/作者/评论/热榜)。 - 用户要做关键词搜索、爆款选题调研、对标账号监控、评论洞察、热点追流。 - 用户提供了抖音关键词、视频/主页链接,希望拿到结构化数据。 **🚫 不调用**: - 用户只想要文案/标题/脚本,未要求查抖音数据。 - 平台不是抖音:小红书 / 快手 / B站 / 微博 / 公众号 → 路由到对应技能,**不要用本技能**。 - 要求私密/登录态/隐藏数据。 - 既无关键词也无可识别抖音链接且目标不明 → 先追问。 ## 3. 🔀 意图路由决策树(按顺序判断,命中即停) ``` 1. 提到"热榜/热搜/热点/今天什么火/榜单" → hot-cli.js(无需参数) 2. 提到"评论/留言"且指向某
readme.md
# 🚀 抖音数据采集工具|关键词搜索 · 博主作品 · 视频评论 · 实时热榜(无需登录 / 不封号)
> **💡一句话价值**:一条命令拿到抖音公开的视频/作者/评论/热榜数据,直接输出结构化 JSON——做爆款选题、对标账号监控、评论舆情分析、热点追踪,不用再手动刷抖音。
**维护状态**:持续更新中,当前版本 `1.3.0`,[更新日志](references/changelog.md)。
> **🔥核心优势**
>
> - 安全: 无需登录你的抖音账号,不担心风控风险 / 封号问题
> - 强大: 一次可获取最多1W条数据,使用简单方便
> - 全面: 各功能出参数据全面,可见及有价值数据都会返回
> - 灵活: 支持多维度筛选
> - 轻量: 无需部署服务,Node.js 一键运行
> - 低耗: 日志自动归档,适配营销报告 / 内容策划场景 ,便于数据二次分析
## ✅ 我能帮你解决什么(10 秒判断)
| 你是谁 | 你要做的事 | 用哪个功能 |
| ---------- | -------------------------------- | --------------------------- |
| 短视频运营 | 找爆款选题、分析高赞视频规律 | 关键词搜索(点赞/最新排序) |
| 品牌/投放 | 监控对标账号的内容策略和发文节奏 | 博主作品抓取 |
| 舆情/客服 | 看一条视频评论区在骂还是在夸 | 评论抓取 |
| 所有人 | 今天抖音在火什么,追热点 | 实时热榜 |
**产出物**:结构化 JSON(含标题、作者、点赞/评论/收藏/分享、标签、视频链接),可直接导入 Excel/BI,或交给 AI 生成选题库、竞品对比表、舆情周报。
## 🚀 3 步接入
1. **装 Node.js**(16.14.0+,Windows/Mac/Linux 均可,约 2 分钟)
2. **拿 TOKEN**:访问 [抖音搜索技能官网](https://www.guaikei.com) 自助开通,配置环境变量 `GUAIKEI_API_TOKEN`
- Windows:`set GUAIKEI_API_TOKEN=你的TOKEN`
- Linux/MacOS:`export GUAIKEI_API_TOKEN=你的TOKEN`
3. **复制一条命令跑**(10-60 秒出结果)👇
### 最快上手(复制就能跑)
```bash
# 🔎 搜"AI"相关的抖音视频
node src/douyin/search-cli.js --keyword "AI"
# 🔎 按点赞排序找爆款(最常用)
node src/douyin/search-cli.js --keyword "AI" --sort 1
# 🦸 抓某个博主的作品(直接粘贴 App 分享链接也行)
node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 20
# 💬 看这条视频的评论
node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 100
# 📡 抖音实时热榜
node src/douyin/hot-cli.js
```
> 💡 Windows cmd.exe 下请使用双引号;PowerShell / bash 可直接执行。
> 💡 技能支持直接粘贴 App 分享文案(含"复制到剪贴板…"字样和短链),链接会自动抽取、参数自动清理。
### 你会得到什么(真实输出结构示例)
```json
{
"status": "success",
"error_code": "OK",
"request": {
"command": "search",
"keyword": "AI 教程",
"sort": 1,
"limit": 20
},
"metadata": { "skill_version": "1.3.0", "execution_time": 34210 },
"results": [
{
"desc": "3 分钟讲透 RAG…",
"author_nickname": "某某说AI",
"author_sec_uid": "MS4wLjABAAAA…",
"author_url": "https://www.douyin.com/user/MS4wLjABAAAA…",
"digg_count": 123456,
"comment_count": 8901,
"share_count": 1200,
"collect_count": 3400,
"url": "https://www.douyin.com/video/7xxxxxxxxxxxxxxxxxx",
"create_time_str": "2026/9/4 20:13:20",
"tags": ["#AI", "#教程"]
}
]
}
```
---
## 📌 适用场景(我该不该用?)
- 需要短视频选题 → 关键词搜索 + 点赞排序
- 需要研究对标账号 → 按主页链接抓取其公开作品(**一次抓一个账号**,多个账号逐条执行即可)
- 需要分析内容舆情 → 获取视频/图文评论
- 需要快速追热点 → 实时获取抖音热榜
- 需要做营销报告 → 输出结构化 JSON,自动落盘留存
## 🔍 和其他方式比,凭什么用它?
| 对比项 | 本技能 | 手动刷抖音 | 自己写爬虫 |
| -------------- | -------------------------- | --------------------- | ---------------------------- |
| 上手成本 | 一条命令,5 分钟接入 | 0,但整理数据极费时间 | 需要逆向/维护,门槛高 |
| 登录与封号风险 | **无需登录,只读公开数据** | 无 _meta.json
{
"ownerId": "kn79p9y6xrdxyr0maxy3tj5nb9835e0e",
"slug": "douyin-search-keyword",
"version": "1.3.0",
"publishedAt": 1789293094602
}references/changelog.md
# 抖音关键词搜索 (Douyin Search & Analytics) 更新日志 ## 1.3.0 - 2026-09-13 - 增加获取抖音博主互动数据的功能。 - 优化SKILL返回方式 ## 1.2.2 - 2026-08-17 - bug紧急修复。 ## 1.2.1 - 2026-08-16 - 技能细节打磨,优化AI对技能的识别及解析能力。 - 增强参数与命名处理。 - 技能描述、分类和标签进一步优化,适配更多抖音相关业务场景。 - 示例命令更聚焦实际检索和分析场景,便于快速上手。 - 增强环境变量说明与能力边界指引,提升使用与接入体验。 ## 1.2.0 - 2026-08-08 - 搜索功能优化,支持类型搜索(视频、图文等)。 - 各项功能细节优化。 ## 1.1.5 - 2026-06-18 - 新增抖音视频评论获取功能,支持抓取并分析指定作品的评论内容。 - 更新 schema,新增评论入参与出参 JSON Schema 规范,完善数据结构。 - SKILL.md 说明文档同步更新,增加评论分析与用法示例。 ## 1.1.4 - 2026-06-09 - 新增多份 JSON 模式文件,用于命令行结构化输入输出校验。 - 在 references/ 目录下添加文档:更新日志(changelog.md)、配置说明(options.md)。 - 优化 SKILL.md:补充模式文件引用,并完善令牌获取相关说明。 - 为技能元数据补充模式定义,提升兼容性与自检能力。 ## 1.1.3 - 2026-05-11 **新增:支持获取抖音作者(抖人)已发布作品,实现竞品账号内容批量抓取。** - 新增 post-cli 指令,可根据抖音主页 URL 或 sec_uid 一键获取创作者所有公开作品,便于竞品监控和账号内容分析。 - 参数说明、使用范例及常见问题等文档内容同步更新,更清晰指引新功能使用方式。 - 指令参数支持短缩写,limit上限提升至200,提升批量数据抓取能力。 - 关键词搜索、热榜等原有功能保持兼容并优化参数配置,提升整体易用性。 - 调整并精简 Skill 文档,增加使用案例,强调 TOKEN 申请与日志留存说明。 - 示例与文档同步完善,能力标签更明确。 ## 1.1.2 - 2026-05-04 - 新增支持抖音热搜榜单查询(hot-cli.js),可独立调用。 - 关键词搜索与热榜查询分别独立为入口(search-cli.js/hot-cli.js)。 - 项目结构优化,API与工具模块化拆分,便于维护与扩展。 - 移除旧 scripts/lib 目录,迁移为 src/api、src/utils、src/validate 目录。 - 更新文档与示例,增强上手指引与使用场景说明。 ## 1.1.1 - 2026-03-31 - 更新 JSON 响应中的输出字段,明确标记更多字段,提高下游解析的一致性。 - 无功能或界面变更;文档现在准确反映了输出模式中始终存在的字段。 ## 1.1.0 - 2026-03-31 **重大升级:结构化输出、多参数排序与筛选能力增强** - 增加多维度排序(综合/最多点赞/最新发布)和发布时间筛选(1天/7天/半年),结果更精准。 - 支持自定义返回数量(1~60条)。 - 完全结构化 JSON 输出,字段覆盖互动数据、标签等,适配 OpenClaw 生态。 - 内置参数合法性校验、敏感词过滤及安全保护,保证调用稳定合规。 - 增强任务轮询&超时重试机制,提升检索成功率和稳定性。 - 技能文档全面更新,提供详细参数表、示例与应用场景说明。 ## 1.0.2 - 2026-03-24 - 技能重命名为“douyin-search-keyword”。 - 在SKILL.md中添加了openclaw元数据、使用帮助、许可证、标签和示例,以实现更好的集成与文档化。 - 移除了两个本地文件(.env 和 scripts/last-search.json),以优化代码结构并提升安全性。 - 文档现已更加简洁且以用户为中心,重点在于提供清晰的使用说明和数据字段解释。 - 突出技能特性、合规要点及技术流程。 ## 1.0.1 - 2026-3-20 - 更新技能描述,强调支持多维度抖音公开内容检索(视频、图文、用户等) - 扩展文档,新增适用/不适用场景说明 - 新增环境和token配置的详细步骤与平台限制说明 - 明确数据字段及样例,补充表格形式字段解释 - 强调合规、风控及临时链接有效期注意事项 ## 1.0.0 - 2026-03-18 - douyin-search-general 技能首次发布。 - 提供抖音通用搜索接口,支持视频、图文、用户及社交数据搜索。 - 返回详细信息,包括内容描述、作者、发布时间、点赞数、评论数、分享数、封面图片及视频链接。 - 需要Node.js和有效的GUAIKEI_API_TOKEN环境变量才能运行。 - 输出包含可直接复制的URL,并附有示例响应格式说明。
references/options.md
# 抖音关键词搜索 (Douyin Search & Analytics) 完整选项参数说明 ## 🔎 抖音关键词搜索 | 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 | | :----------- | :--: | :----------- | :----------------------------------------------------- | :--- | :----: | | `--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 条 | 否 | 10 | | `--help` | `-h` | 显示帮助信息 | | 否 | | ```bash # **基础语法** node src/douyin/search-cli.js --keyword <关键词> --sort <排序方式> --time <时间范围> --duration <视频时长> --content <内容类型> --limit <获取数量> # **使用示例** # 搜索"AI 教程"的抖音内容 node src/douyin/search-cli.js --keyword "AI 教程" # 搜索 AI 获取最多点赞的抖音内容 node src/douyin/search-cli.js --keyword "AI" --sort 1 # 搜索近7天"AI 模型"的抖音内容 node src/douyin/search-cli.js --keyword "AI 模型" --time 7 # 搜索"AI 教程"视频时长在5分钟以上的抖音内容 node src/douyin/search-cli.js --keyword "AI 教程" --duration 3 # 搜索半年内最新20条"AI 教程"的抖音内容 node src/douyin/search-cli.js --keyword "AI 教程" --sort 2 --time 180 --limit 20 ``` ## 🦸 抖音博主作品获取 | 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 | | :-------- | :--: | :----------------------- | :--------- | :--- | :----: | | `--url` | `-u` | 抖音博主主页URL或sec_uid | | 是 | | | `--limit` | `-l` | 获取作品数量 | 0-10000 条 | 否 | 10 | | `--help` | `-h` | 显示帮助信息 | | 否 | | > **💡"抖音博主主页URL"说明** > > - PC端 ( 格式:<https://www.douyin.com/user/MS4wLjABxxx> ) > - 移动端 ( 格式:<https://v.douyin.com/xxx> ) > - 技能关键词搜索返回的author_sec_uid字段 ```bash # **基础语法** node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" # **使用示例** # 获取抖音博主 MS4wLjABxxx 已发布的20条作品 node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 20 # 获取抖音博主 MS4wLjABxxx 的互动数据(关注数、粉丝数、总获赞数)等信息。 node src/douyin/post-cli.js -u "https://www.douyin.com/user/MS4wLjABxxx" -l 0 ``` ## 💬 抖音作品评论数据 | 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 | | :-------- | :--: | :---------------------------- | :--------- | :--- | :----: | | `--url` | `-u` | 抖音视频(或图文)URL或aweme_id | | 是 | | | `--limit` | `-l` | 获取评论数量 | 1-10000 条 | 否 | 10 | | `--help` | `-h` | 显示帮助信息 | | 否 | | ```bash # **基础语法** node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" # **使用示例** # 获取视频 xxx 的1
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/um-why/skills/douyin-search-keyword",
"sourceUrl": "https://clawhub.ai/um-why/skills/douyin-search-keyword",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T09:11:52.302Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T09:11:52.302Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "3.2K downloads",
"href": "https://clawhub.ai/um-why/douyin-search-keyword",
"sourceUrl": "https://clawhub.ai/um-why/douyin-search-keyword",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T09:11:52.302Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.3.0",
"href": "https://clawhub.ai/um-why/douyin-search-keyword",
"sourceUrl": "https://clawhub.ai/um-why/douyin-search-keyword",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-13T09:51:34.602Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.3.0",
"description": "Version 1.3.0 - Removed the file skill-card.md from the project. - Updated documentation for improved clarity, shorter introduction, and enhanced API call and output rules. - Revised and streamlined capability descriptions, intent routing, and parameter mapping for more precise command selection. - Clarified error handling, output format, and environmental requirements. - Expanded and formalized user intent recognition and command mapping guidance. - No changes to code or functionality; documentation only.",
"href": "https://clawhub.ai/um-why/douyin-search-keyword",
"sourceUrl": "https://clawhub.ai/um-why/douyin-search-keyword",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-13T09:51:34.602Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
