---
name: douyin
description: "抖音达人发现、视频趋势分析和电商研究。当用户需要搜索抖音视频（抖音视频/搜视频/找视频）、查看抖音热搜（热搜/热门/趋势）、搜索抖音达人（达人/网红/博主/创作者）、分析抖音视频（视频分析/数据/播放量）、下载抖音视频（下载/无水印）、查看抖音商品（抖音商品/抖店/电商）、或研究抖音话题（话题/挑战/标签/#）时使用此技能。"
---

# 抖音 - 达人发现、视频趋势分析与电商研究

所有命令使用 `scout douyin` 前缀。

---

## 快速选择：我该用哪个命令？

| 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
|---------|---------|---------|---------|
| **发现热门内容** | `hot-search` | `trending-challenges` | 热搜趋势+挑战热度 |
| **找内容灵感** | `search-videos "关键词"` | `video-insights` | 搜索视频→深入分析文案评论 |
| **找达人合作** | `search-users "关键词"` | `user-profile` + `user-videos` | 搜人→看主页→看作品 |
| **下载抖音视频** | `video-download <awemeId>` | `video-detail` | 获取无水印原画下载链接 |
| **分析竞品视频** | `video-detail <awemeId>` | `video-comments` | 视频数据+评论分析 |
| **研究话题趋势** | `search-challenges "关键词"` | `trending-challenges` | 话题播放量+热门挑战 |
| **查看抖音商品** | `product <id> --shop-id <id>` | `product-reviews` | 商品评价+评分 |
| **查看热搜总榜** | `billboard` | `hot-search` | 按时间范围看历史热搜 |

---

## 典型场景

当用户说：
- "抖音上什么火" / "最近什么热门" → `scout douyin hot-search`
- "搜一下XX视频" / "找XX相关视频" → `scout douyin search-videos "XX"`
- "找抖音达人" / "找XX博主" → `scout douyin search-users "XX"`
- "看看这个达人" + sec_user_id → `scout douyin user-profile <sec_user_id>`
- "这个达人发了什么" → `scout douyin user-videos <sec_user_id>`
- "分析这个视频" + aweme_id → `scout douyin video-insights <aweme_id>`
- "下载这个抖音视频" + aweme_id/链接 → `scout douyin video-download <aweme_id>`
- "看看这个视频评论" → `scout douyin video-comments <aweme_id>`
- "抖音热门话题" / "什么挑战火" → `scout douyin trending-challenges`
- "搜一下XX话题" → `scout douyin search-challenges "XX"`
- "看看这个抖音商品" → `scout douyin product <productId> --shop-id <shopId>`
- "看看热搜历史" → `scout douyin billboard --type range --start-date 20260327 --end-date 20260328`
- 用户发抖音视频链接 → 提取 aweme_id 或用 `video-by-url`

---

## URL 解析 - 抖音链接处理

用户经常直接贴抖音链接。**不要用 WebFetch**（会被登录墙拦截），按以下规则解析：

| URL 特征 | 提取内容 | 调用命令 |
|----------|---------|---------|
| `douyin.com/video/数字` | aweme_id (数字) | `scout douyin video-detail <awemeId>` |
| `douyin.com/user/MS4wLjAB...` | sec_user_id | `scout douyin user-profile <secUserId>` |
| `v.douyin.com/短链接` | 完整 URL | `scout douyin video-by-url "<url>"` |
| 其他抖音分享链接 | 完整 URL | `scout douyin video-by-url "<url>"` |

**示例**：
```bash
# 视频链接 → 提取 aweme_id
# https://www.douyin.com/video/7354264417699204363
scout douyin video-detail 7354264417699204363

# 分享短链接 → 直接传入
scout douyin video-by-url "https://v.douyin.com/iRNBho5/"

# 达人主页 → 提取 sec_user_id
# https://www.douyin.com/user/MS4wLjABAAAAstr32_WJilxxlkNdlvt_WowyYp5W0SfORT3dwByTSk4
scout douyin user-profile "MS4wLjABAAAAstr32_WJilxxlkNdlvt_WowyYp5W0SfORT3dwByTSk4"
```

---

## 核心命令

### 🔥 第一层：趋势发现

#### 1. 热搜榜 - `scout douyin hot-search`

查看抖音实时热搜，发现当前热点。

```bash
scout douyin hot-search
scout douyin hot-search --format text
```

**返回数据**：`word`（热搜词）、`hotValue`（热度值）、`position`（排名）

#### 2. 热门挑战 - `scout douyin trending-challenges`

查看当前热门挑战/话题。

```bash
scout douyin trending-challenges --page-size 20
```

**返回数据**：`rank`、`title`（挑战名）、`hotScore`（热度分）、`videoCount`（参与视频数）

#### 3. 热搜总榜 - `scout douyin billboard`

按时间范围查看热搜历史数据。

```bash
# 按时间范围查看
scout douyin billboard --type range --start-date 20260327 --end-date 20260328 --page-size 20

# 按时刻快照查看
scout douyin billboard --type snapshot --snapshot-time 20260328120000 --page-size 20
```

**返回数据**：`rank`、`title`、`hotScore`

---

### 🔍 第二层：视频搜索与分析

#### 4. 搜索视频 - `scout douyin search-videos`

按关键词搜索抖音视频。

```bash
scout douyin search-videos "咖啡"
scout douyin search-videos "美妆" --sort-type 1 --publish-time 7
```

**参数**：
- `--sort-type`：排序方式（`0`=综合、`1`=最多点赞、`2`=最新发布）
- `--publish-time`：发布时间（`0`=不限、`1`=一天内、`7`=一周内、`180`=半年内）
- `--filter-duration`：视频时长（`0`=不限、`0-1`=一分钟内、`1-5`=1-5分钟、`5-10000`=5分钟以上）

**返回数据**：`id`（aweme_id）、`creator`（用户名/昵称/secUid）、`description`、`likes`、`comments`、`shares`、`collects`（收藏）、`hashtags`

**注意**：搜索结果中 `views`（播放量）通常为 0（抖音限制），需要通过 `video-detail` 获取。

#### 5. 视频详情 - `scout douyin video-detail`

获取视频完整数据。

```bash
scout douyin video-detail 7354264417699204363
```

**返回数据**：`views`、`likes`、`comments`、`shares`、`collects`、`creator`、`description`、`videoUrl`（播放链接）、`musicInfo`

#### 6. 通过链接获取视频 - `scout douyin video-by-url`

用分享链接获取视频详情。

```bash
scout douyin video-by-url "https://www.douyin.com/video/7354264417699204363"
scout douyin video-by-url "https://v.douyin.com/iRNBho5/"
```

#### 7. 视频下载 - `scout douyin video-download`

获取视频下载链接，包括原画无水印版本。

```bash
scout douyin video-download 7354264417699204363
```

**返回数据**：
- `originalUrl`：原画无水印（文件最大，最高画质）
- `fileSizeMb`：原画文件大小
- `playUrls`：无水印播放链接（多 CDN 节点）
- `downloadUrls`：有水印下载链接（多 CDN 节点）

**下载方法**：
```bash
# 获取链接
scout douyin video-download 7354264417699204363 --format json

# 用 wget 下载原画
wget -O "video.mp4" "<originalUrl>"

# 或用 curl
curl -L -o "video.mp4" "<playUrls[0]>"
```

**注意**：所有链接为临时签名链接，有效期几小时，过期需重新获取。

#### 8. 视频评论 - `scout douyin video-comments`

获取视频评论列表。

```bash
scout douyin video-comments 7354264417699204363 --count 20
```

**返回数据**：`text`、`likes`（点赞数）、`author`（评论者昵称）、`createdAt`

#### 9. 视频洞察 - `scout douyin video-insights`

一次获取视频详情 + 评论。

```bash
scout douyin video-insights 7354264417699204363
scout douyin video-insights 7354264417699204363 --no-comments
```

**返回数据**：`video`（完整视频数据）+ `comments`（评论列表）

**分析重点**：
1. 点赞/播放比 >5% = 优质内容
2. 评论高频词 = 用户关注点
3. 收藏数高 = 实用性强
4. 分享数高 = 传播性强

---

### 👤 第三层：达人分析

#### 10. 搜索用户 - `scout douyin search-users`

按关键词搜索抖音达人/创作者。

```bash
scout douyin search-users "咖啡博主"
scout douyin search-users "美妆达人"
```

**返回数据**：`username`、`displayName`、`followers`、`secUid`

**注意**：搜索结果中 `totalVideos` 和 `totalLikes` 可能为 0，需通过 `user-profile` 获取完整数据。

#### 11. 用户主页 - `scout douyin user-profile`

获取用户完整主页数据。

```bash
scout douyin user-profile "MS4wLjABAAAAstr32_WJilxxlkNdlvt_WowyYp5W0SfORT3dwByTSk4"
```

**返回数据**：`username`、`displayName`、`followers`、`following`、`totalVideos`、`totalLikes`、`engagementRate`、`bio`、`profileUrl`

**关键指标**：
- `engagementRate` >5% = 高互动达人
- `totalLikes / totalVideos` = 平均每条视频点赞

#### 12. 用户视频列表 - `scout douyin user-videos`

获取用户发布的视频。

```bash
scout douyin user-videos "MS4wLjABAAAAstr32_WJilxxlkNdlvt_WowyYp5W0SfORT3dwByTSk4" --count 10
```

**返回数据**：视频列表 + `hasMore`（是否有更多）+ `maxCursor`（翻页游标）

**翻页**：
```bash
# 第一页
scout douyin user-videos <sec_user_id> --count 20

# 下一页（使用返回的 maxCursor）
scout douyin user-videos <sec_user_id> --count 20 --max-cursor 1773994568000
```

---

### 🏷️ 第四层：话题研究

#### 13. 搜索话题 - `scout douyin search-challenges`

搜索抖音话题/挑战。

```bash
scout douyin search-challenges "咖啡"
```

**返回数据**：`id`（话题 ID）、`name`（话题名）、`viewCount`（播放量）、`userCount`（参与人数）

---

### 📦 第五层：商品研究

#### 14. 商品详情 - `scout douyin product`

获取抖音商品数据（通过评价+SKU+评分组装）。

```bash
scout douyin product 3770337983790711029 --shop-id 129508461 --author-id 3109048548866375
```

**参数**：
- `<productId>`：商品 ID（必填）
- `--shop-id`：店铺 ID（必填）
- `--author-id`：作者 ID（可选，提供则返回 SKU 数据）

**返回数据**：`name`、`price`（元）、`shop`、`rating`（好评率/总评数）、`tags`（评价标签）、`skus`（SKU 规格）

**注意**：抖音商品详情接口已废弃，数据通过评价 OrderSnapshot + SKU + 评分组装，需要 `shop_id`。

#### 15. 商品评价 - `scout douyin product-reviews`

获取商品评价列表。

```bash
scout douyin product-reviews 3770337983790711029 --shop-id 129508461 --count 20
scout douyin product-reviews 3770337983790711029 --shop-id 129508461 --sort-type 1  # 按最新排序
```

**返回数据**：`Content`（评价内容）、`Likes`（点赞数）、`CommentTime`、`Photos`（买家晒图）、`OrderSnapshot`（包含商品名/价格/店铺信息）

---

## 典型工作流

### 抖音趋势研究

```bash
# 1. 看当前热搜
scout douyin hot-search --format text

# 2. 看热门挑战
scout douyin trending-challenges --page-size 10 --format text

# 3. 搜索感兴趣的话题视频
scout douyin search-videos "热搜关键词" --sort-type 1 --format text

# 4. 深入分析爆款视频
scout douyin video-insights <aweme_id>
```

### 达人分析流程

```bash
# 1. 搜索目标领域达人
scout douyin search-users "美妆博主"

# 2. 查看达人主页（用搜索结果的 secUid）
scout douyin user-profile <sec_user_id>

# 3. 看达人作品
scout douyin user-videos <sec_user_id> --count 10

# 4. 分析爆款视频
scout douyin video-insights <aweme_id>
```

### 竞品视频分析

```bash
# 1. 搜索竞品视频
scout douyin search-videos "竞品品牌" --sort-type 1

# 2. 分析最火视频（文案+评论）
scout douyin video-insights <aweme_id>

# 3. 下载视频素材
scout douyin video-download <aweme_id>
```

### 跨平台选品联动

```bash
# 1. 抖音发现趋势
scout douyin hot-search
scout douyin search-videos "产品关键词" --sort-type 1

# 2. TikTok 验证海外市场
scout tiktok shop-search "product keyword" --region US

# 3. Amazon 市场验证
scout search "product keyword" --limit 10

# 4. 找供应商
scout supplier-search "产品中文名" --limit 10
```

---

## 数据解读参考

### 视频表现判断

| 指标 | 优秀 | 良好 | 一般 |
|------|------|------|------|
| 点赞/播放 | >5% | 3-5% | <3% |
| 评论/点赞 | >3% | 1-3% | <1% |
| 收藏数 | >点赞数 10% | 5-10% | <5% |
| 分享数 | >点赞数 5% | 2-5% | <2% |

### 达人质量判断

| 指标 | 优秀 | 良好 | 一般 |
|------|------|------|------|
| 互动率 (engagementRate) | >8% | 3-8% | <3% |
| 平均点赞/粉丝 | >0.1 | 0.05-0.1 | <0.05 |

### 话题热度判断

| 播放量 | 评估 |
|--------|------|
| >100亿 | 超级话题 |
| 10-100亿 | 热门话题 |
| 1-10亿 | 活跃话题 |
| <1亿 | 小众话题 |

---

## 重要提醒

1. **播放量限制**：搜索结果中 `views` 通常为 0（抖音限制），需用 `video-detail` 获取真实播放量
2. **sec_user_id**：用户主页和视频列表需要 `sec_user_id`（以 `MS4wLjAB` 开头的长字符串），从搜索结果或视频详情中获取
3. **游标分页**：所有列表接口使用 `cursor` 分页（非 offset/limit），翻页用返回的 `maxCursor` 值
4. **视频下载链接临时有效**：所有下载 URL 带签名过期时间，几小时后失效需重新获取
5. **商品数据需要 shop_id**：商品详情接口已废弃，通过评价组装数据，必须提供 `--shop-id`
6. **跨 Skill 联动**：抖音发现趋势 → TikTok 验证海外 → scout search Amazon 验证 → scout supplier-search 找供应商
