# Douyin Search Keyword

> 抖音公开数据智能获取工具。支持抖音关键词搜索、抖音博主作品抓取、抖音视频评论分析、抖音实时热榜查询。当用户需要搜抖音视频、查抖音热榜、看抖音评论、抓博主作品、做抖音竞品分析、短视频选题调研、舆情监控、热点追踪、爆款挖掘、抖音运营数据分析时使用。触发词：抖音搜索、抖音热榜、抖音评论、抖音作品、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点。

- Skill: `um-why/douyin-search-keyword` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add um-why/douyin-search-keyword`
- Raw SKILL.md: https://api.skillmd.com/api/skills/um-why/douyin-search-keyword/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: um-why (https://skillmd.com/u/um-why)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/um-why/douyin-search-keyword

---


# 🚀 抖音关键词搜索、竞品分析、舆情监控与热榜跟踪工具 (Douyin Search & Analytics)

## 1. 🛠️ 技能概述

抖音公开数据获取与智能分析工具。支持**关键词搜索排序**、**博主作品抓取**、**视频评论分析**、**实时热榜获取**，适用于短视频选题、竞品监控、舆情分析、热点追踪，助力爆款内容策划与流量运营。

> **🔥核心优势**
>
> - **安全**：无需登录抖音账号，无风控 / 封号风险
> - **强大**：单次最多可获取 1W 条数据，内置批量与多维筛选
> - **全面**：出参覆盖作者、互动、标签、链接等可用数据及有价值数据都会返回
> - **轻量**：无需部署服务，Node.js 一键运行，仅依赖内置模块
> - **友好**：stdout 纯 JSON、日志走 stderr，便于 AI 稳定解析与二次分析

## 2. ✅ 何时调用与能力边界

### 🎯 在以下场景优先调用：

- 用户明确要查 **抖音** 的公开内容（视频 / 图文 / 作者 / 评论 / 热榜）。
- 用户要做 **关键词搜索**、**爆款选题调研**、**竞品监控**、**评论洞察**、**博主作品追踪**、**热点追流**。
- 用户提供了抖音关键词、视频链接、博主主页链接，希望拿到结构化数据。
- 用户后续还要基于结果做总结、对比、筛选、报告生成。

### 🚫 不应调用

- 用户只想要文案/标题/脚本，未要求查抖音数据。
- 平台不是抖音（小红书、B站、微博、公众号）→ 路由到对应技能。
- 要求私密/登录态/隐藏数据。
- 既无关键词也无可识别抖音链接且目标不明 → 先追问。

> 意图不明确时先追问，不要盲目执行命令。

### 🛑 本技能不需要、不负责：

登录账号、发布/点赞/评论/关注等写操作、获取非公开数据、替用户做营销策略判断。职责是**先把数据拿回来**，再交上层分析。

## 3. 🔀 调用路由

> **Note:** 请先通过 [抖音数据获取技能官网](https://www.guaikei.com) 开通并配置环境变量 `GUAIKEI_API_TOKEN` 后，再按意图路由：

| 意图             | 脚本                        | 必填                 | 典型结果                        |
| ---------------- | --------------------------- | -------------------- | ------------------------------- |
| 搜关键词内容     | `src/douyin/search-cli.js`  | `keyword`            | 视频/图文列表、作者、互动、链接 |
| 看热搜/热点/榜单 | `src/douyin/hot-cli.js`     | 无                   | 热榜词条、热度、搜索量          |
| 看博主最近作品   | `src/douyin/post-cli.js`    | 主页 URL 或 sec_uid  | 博主公开作品列表                |
| 看视频/图文评论  | `src/douyin/comment-cli.js` | 视频 URL 或 aweme_id | 评论内容、评论者、互动          |

### 🧭 消歧义（重要）

- 单独出现"视频"二字时，不要默认归 `post`。
- 有"关键词"且无"评论" → `search`（用户想搜某个视频）。
- "这个视频的评论/留言" → `comment`。
- 仅当"作品/主页/账号/博主"出现时才用 `post`。

## 4. 🧺 输入收集规则

执行前先收集足够输入，避免无效调用。

### 4.1 🔍 关键词搜索（search-cli）

至少要确认：`keyword`（2-50 字符）。可选：

- `sort`：0 综合 / 1 最多点赞 / 2 最新发布
- `time`：0 全部 / 1 一天内 / 7 七天内 / 180 半年内
- `duration`：0 不限 / 1 1分钟内 / 2 1-5分钟 / 3 5分钟以上
- `content`：0 不限 / 1 视频 / 2 图文
- `limit`：1-10000，默认 10

### 4.2 📡 博主作品（post-cli）

至少要确认：`url`（主页 URL 或 sec_uid）。可选：`limit`（1-10000，默认 10）。
适用链接：`https://www.douyin.com/user/MS4wLjABxxx`、`https://v.douyin.com/xxx`、或直接使用 `sec_uid`。

### 4.3 💬 评论分析（comment-cli）

至少要确认：`url`（视频 / 图文 URL 或 aweme_id）。可选：`limit`（1-10000，默认 10）。
适用链接：`https://www.douyin.com/video/xxx`、`https://www.douyin.com/note/xxx`、或直接使用 `aweme_id`。

## 5. 📜 执行与输出约定

- 在技能根目录执行；只输出纯 JSON 到 stdout，日志/banner 走 stderr。
- 没有关键词：先追问关键词。
- 没有链接：先追问视频 / 主页链接或 ID。
- 链接类型不明确：先确认这是视频还是博主主页。
- 没有 `GUAIKEI_API_TOKEN`：提醒用户先配置环境变量，再执行。
- 退出码：`0`=成功（含 empty），`1`=运行错误（接口异常/网络/超时），`3`=auth_required（缺/错 token）。
- 失败须向用户说明原因，**不编造数据，不把空结果当成功**。空结果退出码 0 属正常。
- 完整选项见 可参阅 [完整选项说明](references/options.md) ；LLM理解技能的详细选项，可参阅技能 `assets` 目录中文件。
- 执行完成后，优先返回：本次目标、关键参数、结构化 JSON 结果，必要时再补一小段摘要。
- 适合衔接的后续动作：选题汇总、高赞对比、评论观点聚类、竞品内容风格总结、博主发文节奏分析、报告与表格生成。

## 6. 💡 调用示例

```bash
node src/douyin/search-cli.js --keyword "AI 教程" --sort 1
node src/douyin/search-cli.js --keyword "AI模型" --sort 2 --time 7 --limit 20
node src/douyin/hot-cli.js
node src/douyin/post-cli.js --url "https://www.douyin.com/user/MS4wLjABxxx" --limit 50
node src/douyin/comment-cli.js --url "https://www.douyin.com/video/xxx" --limit 100
```

- 🤖 自然语言触发示例："帮我搜抖音里'AI 教程'最火的视频""抖音今天有什么热点""分析这条抖音视频评论区的主要观点"。
- 🧠 若用户表达笼统（如"帮我做抖音竞品分析"），优先拆成两步：① 确认关键词 / 竞品链接 / 博主主页；② 再调用对应脚本拿回数据。

## 7. 🎧 环境、合规与支持

- 环境：Node.js 16.14.0+，兼容 Windows/Linux/macOS；必需 `GUAIKEI_API_TOKEN`；官网 <https://www.guaikei.com>。
- 合规：仅处理抖音公开数据，不支持私密/隐藏/登录态数据；数据仅限个人/团队内部分析，禁止违规分发；依赖第三方 API（guaikei.com），使用前确认数据外发与授权范围。
- 支持：官网 <[抖音数据获取技能官网](https://www.guaikei.com)>（自助开通 TOKEN）；微信 `13395823479`（备注：抖音技能）。

## 8. ❓ 常见问题

- 没结果：放宽关键词或减少限定（`--time 0`）、换更贴近的词。
- 结果太多：补场景/人群/品牌/时间/账号。
- 调用失败：先确认 `GUAIKEI_API_TOKEN` 已配置有效（退出码 3 即 token 问题）。
- 账号安全：只读能力，不登录/发帖/点赞/评论。