当用户需要抖音公开数据时，使用本技能。覆盖四类数据：关键词搜索（视频/图文/用户）、博主作品批量抓取、视频评论获取分析、实时热榜查询。适用于内容调研、竞品账号分析、用户评论洞察、热点趋势追踪；用户做短视频调研未明确提到"抖音"时同样触发。不适用于发布/剪辑/下载视频、涨粉代运营咨询，也不覆盖其他短视频平台。
浏览器
guaikei-douyin-extract-videos-comments-hot
试用当用户需要抖音公开数据时，使用本技能。覆盖四类数据：①关键词搜索（视频/图文/用户）、 ②博主作品批量抓取、③视频评论获取分析、④实时热榜查询。适用于内容调研、竞品账号分析、 用户评论洞察、热点趋势追踪；用户做短视频调研未明确提到"抖音"时同样触发。不适用于 发布/剪辑/下载视频、涨粉代运营咨询，也不覆盖其他短视频平台（各有对应技能）。
它能做什么
当用户需要抖音公开数据时，使用本技能。覆盖四类数据：①关键词搜索（视频/图文/用户）、 ②博主作品批量抓取、③视频评论获取分析、④实时热榜查询。适用于内容调研、竞品账号分析、 用户评论洞察、热点趋势追踪；用户做短视频调研未明确提到"抖音"时同样触发。不适用于 发布/剪辑/下载视频、涨粉代运营咨询，也不覆盖其他短视频平台（各有对应技能）。
技能文档
guaikei 抖音提取视频评论热榜
抖音公开数据采集技能。基于 guaikei 国内数据服务（https://www.guaikei.com）， 提供抖音四类公开数据的查询与抓取能力。纯中文界面，国内网络直连，无需额外代理配置。
何时使用（Adaptability · 触发与边界）
应触发场景（任一即用）：
- 关键词搜索：按关键词在抖音找视频、图文、用户或社交数据
- 博主作品：批量抓取指定账号已发布作品列表（对标、调研）
- 视频评论：抓取并分析指定作品的评论内容（舆情、口碑）
- 热榜查询：获取抖音实时热搜榜单（热点追踪、选题）
即使用户未明确提到"抖音"，只要任务对象是短视频内容、博主、评论或热点，也应触发。
不应触发边界（明确排除，防误触发）：
- 发布视频、剪辑视频、下载视频或去水印 → 非数据采集范畴
- 涨粉代运营咨询、抖音运营课程推荐 → 非数据获取
- 私域后台数据（如创作者后台播放量、粉丝画像）→ 需登录权限，不在公开数据范围
- 其他短视频平台（B 站、小红书、快手等）→ 各自有对应技能，不在此技能覆盖
- 写爬虫脚本本身 → 用户要的是代码不是查询结果
环境与权限（Trust · 最小权限 + 国内可用）
- 运行时：Node.js >= 16.14.0
- 所需命令：仅
node（最小权限，无系统级操作、无文件写盘、无网络外联除 guaikei 外） - 必需环境变量：
GUAIKEI_API_TOKEN：抖音数据 API 访问令牌
- 令牌获取：访问 https://www.guaikei.com 开通，或联系开发者（wx 13395823479）
- 国内可用性：API 服务器部署于国内，纯中文界面，国内网络直连无需代理
- 敏感信息保护：令牌仅通过环境变量读取，不写入文件、不输出到日志、不随响应外泄
命令总览
通过 npm run 或 node src/douyin/-cli.js 调用四个子命令：
| 命令 | 作用 | 主要参数 |
|---|---|---|
npm run search | 关键词搜索抖音视频/图文/用户 | --keyword --sort --limit |
npm run post | 抓取指定博主作品列表 | --author --limit |
npm run comment | 抓取指定视频评论 | --url --limit |
npm run hot | 查询实时热榜 | （无必填） |
标准工作流（Effectiveness · 减少返工）
按用户意图选择对应子命令，按以下流程执行：
- 确认意图：判断用户需要四类数据中的哪一类（可多选）；若意图模糊，先澄清。
- 收集参数：根据子命令收集必需参数；参数缺失时主动询问，不要硬编默认值。
- 校验参数：调用对应
src/validate/.js校验合法性（关键词非空、URL 格式、limit 范围等）。 - 调用 API：通过
src/api/.js发起请求，自动附带GUAIKEI_API_TOKEN。 - 失败重试：使用
src/utils/retry.js指数退避重试（默认 3 次），错误按src/utils/errors.js统一编码。 - 格式化输出：按对应
assets/_resp.schema.json输出结构化 JSON，确保字段一致、可直接使用。
输入输出规范（Convention · 渐进式披露 + 规范性）
- 请求体：每个 CLI 接受命令行参数或 JSON 输入；完整参数说明见
references/options.md。 - 响应体：每个 CLI 输出 JSON，字段与
assets/*_resp.schema.json严格一致。 - 日志：通过
src/utils/log.js输出，区分 info / warn / error 三级；令牌等敏感字段自动脱敏。 - 错误码：见
src/utils/errors.js，常见类型：TOKEN_MISSING：环境变量未配置PARAM_INVALID：参数校验未通过UPSTREAM_RATE_LIMIT：上游限流（自动重试）UPSTREAM_ERROR：上游服务异常NOT_FOUND：目标博主/视频不存在
边界与异常处理（Reliability · 稳定 + 一致）
- 空结果：搜索/抓取无数据时返回空数组与
total: 0，不报错。 - 限流：上游返回 429 时自动退避重试，超过上限返回
UPSTREAM_RATE_LIMIT并提示稍后重试。 - 超时：单请求默认 15 秒超时，超时后重试一次，仍失败则返回
UPSTREAM_ERROR。 - 参数越界：
limit超过上限自动截断到最大值并 warn 提示，不报错。 - URL 非法：直接返回
PARAM_INVALID并指出具体字段，不发起请求。 - 令牌失效：返回
TOKEN_MISSING或TOKEN_INVALID，提示重新获取，不重试。 - 网络异常：捕获并返回
NETWORK_ERROR，提示检查网络后重试。
使用示例（Convention · 示例充分性）
示例 1：关键词搜索
用户：「帮我搜下抖音上"露营装备"的爆款视频」
调用：npm run search -- --keyword "露营装备" --sort "hot" --limit 20
返回：视频列表 JSON，每条含标题、作者、点赞数、评论数、分享数、发布时间、视频链接。
示例 2：博主作品抓取
用户：「把 @某品牌方账号 近 30 条作品都抓下来，我要做竞品分析」
调用：npm run post -- --author "某品牌方账号" --limit 30
返回：作品列表 JSON，每条含标题、视频链接、互动数据（赞/评/转）、发布时间。
示例 3：视频评论抓取
用户：「这条视频评论区都在说啥？」（配视频链接）
调用：npm run comment -- --url "" --limit 100
返回：评论列表 JSON，每条含用户昵称、评论内容、点赞数、时间、回复数。
示例 4：实时热榜查询
用户：「今天抖音啥火？」
调用：npm run hot
返回：实时热搜榜 JSON，含排名、关键词、热度值、分类标签。
示例 5：多步工作流（埋在更长任务里）
用户：「帮我出一份本周美妆赛道的短视频选题建议」
应触发：先 hot 看热点 → search 按"美妆"关键词搜爆款 → post 抓 2-3 个对标账号作品 → 综合输出选题建议。即使用户没提"抖音"也要触发。
安全与合规声明（Trust · 红线维度）
- 数据范围：仅采集抖音公开数据，不涉及需要登录权限的私域数据，不存储用户隐私信息。
- 合规使用：结果仅用于内容调研、竞品分析、舆情监控等合法用途；不得用于骚扰、恶意抓取、侵犯隐私或违反平台规则的行为。
- 频率控制：遵循上游 API 限流策略，默认开启重试与退避，避免对上游造成压力。
- 令牌安全：令牌仅通过环境变量传递，技能本身不持久化、不外泄、不打印。
- 不替代人工：数据分析结论需结合人工判断，技能仅提供数据获取能力，不提供投资或经营决策建议。
- 版权提示：抓取的视频/评论内容版权归原平台与创作者所有，使用者需自行遵守相关法律法规。
限制说明（Convention · 限制完整性）
- 不提供视频下载、去水印、转码能力。
- 不提供发布、评论、点赞等写入操作。
- 不提供粉丝画像、播放量等需登录权限的私域数据。
- 不覆盖抖音以外的短视频平台。
- 不提供 AI 内容生成（脚本、文案、剪辑）能力，仅做数据获取。
- 数据时效性受上游 API 影响，热榜为实时，搜索/作品/评论为公开快照。
参考资料
- 命令参数详情：
references/options.md - 接口变更与版本：
references/changelog.md - 数据服务平台：https://www.guaikei.com
- 源码仓库：https://github.com/um-why/douyin-search-openclaw
相关技能
当用户需要搜索抖音关键词（视频/图文/用户）、获取博主作品列表、抓取视频评论或查询实时热榜时，使用本技能。覆盖短视频选题、竞品账号分析、评论区舆情、热点追踪四类任务；用户做内容调研而未点名平台时同样适用。不适用于发布视频、下载去水印或非抖音平台。
当用户需要抖音公开数据时，使用本技能。覆盖四类数据：关键词搜索（视频/图文/用户）、博主作品批量抓取、视频评论获取分析、实时热榜查询。适用于内容调研、竞品账号分析、用户评论洞察、热点趋势追踪；用户做短视频调研未明确提到"抖音"时同样触发。不适用于发布/剪辑/下载视频、涨粉代运营咨询，也不覆盖其他短视频平台。
当用户需要抖音公开数据时，使用本技能。覆盖四类数据：关键词搜索（视频/图文/用户）、博主作品批量抓取、视频评论获取分析、实时热榜查询。适用于内容调研、竞品账号分析、用户评论洞察、热点趋势追踪；用户做短视频调研未明确提到"抖音"时同样触发。不适用于发布/剪辑/下载视频、涨粉代运营咨询，也不覆盖其他短视频平台。
1 次安装
支持抖音关键词搜索、抖音博主作品抓取、抖音视频评论分析、抖音实时热榜查询。当用户需要搜抖音视频、查抖音热榜、看抖音评论、抓博主作品、做抖音竞品分析、短视频选题调研、舆情监控、热点追踪、爆款挖掘、抖音运营数据分析时使用。
抖音公开数据智能获取工具。支持抖音关键词搜索、抖音博主作品抓取、抖音视频评论分析、抖音实时热榜查询。当用户需要搜抖音视频、查抖音热榜、看抖音评论、抓博主作品、做抖音竞品分析、短视频选题调研、舆情监控、热点追踪、爆款挖掘、抖音运营数据分析时使用。触发词：抖音搜索、抖音热榜、抖音评论、抖音作品、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点。
1 次安装