---
name: tiktok
description: TikTok influencer marketing, trend discovery, and TikTok Shop product research. Use when user needs to find TikTok creators (TikTok网红/达人/创作者), discover viral products (爆款/热销/带货), search TikTok Shop products (TikTok小店商品/搜索产品/TikTok Shop), analyze trending videos (热门视频/趋势), research hashtags (话题/标签/#), or competitive analysis (竞品/对手分析).
---

# TikTok - Influencer Marketing, Trend Discovery & Shop Research

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

---

## 🌍 地区参数 (Region Parameter)

部分命令支持 `--region` 参数，用于指定目标市场。不同地区的热门内容和产品完全不同。

| 命令 | 是否支持 | 默认值 | 使用说明 |
|------|---------|--------|---------|
| `shop-search` | ✅ | 无（可选） | 搜索特定地区的 TikTok Shop 产品 |
| `search-videos` | ✅ | 无（可选） | 搜索特定地区的视频内容 |
| `trending` | ✅ | `US` | 查看特定地区的热门视频（默认美国） |
| `hashtags` | ✅ | `US` | 查看特定地区的热门话题（默认美国） |
| `creators` | ❌ | - | 使用 `--country` 参数 |
| `shop-product` | ❌ | - | 产品详情不依赖地区 |
| `video-insights` | ❌ | - | 视频分析不依赖地区 |
| `creator-products` | ❌ | - | 创作者产品不依赖地区 |

**常用地区代码**：`US`（美国）、`UK`/`GB`（英国）、`VN`（越南）

**示例**：
```bash
# 美国市场产品搜索
scout tiktok shop-search "coffee" --region US --limit 20

# 英国市场热门视频
scout tiktok trending --region UK --time-period 7d --limit 20
```

---

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

| 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
|---------|---------|---------|---------|
| **发现爆款产品** | `shop-search` 按销量排序 | `search-videos --has-product` | 销量+视频热度双验证 |
| **找内容灵感** | `trending` | `video-insights` | 发现热门话题，深入分析文案 |
| **验证产品需求** | `search-videos "产品" --has-product` | `shop-search "产品"` | 视频数量=热度，销量=真实需求 |
| **竞品分析** | `search-videos "品牌"` | `shop-search "品牌"` | 内容策略+价格策略 |
| **网红合作** | `creators` | `creator-products` | 找人+看历史推广 |
| **学习爆款套路** | `video-insights <url>` | `shop-product <id>` | 内容拆解+产品定位 |

---

## 典型场景

当用户说：
- "帮我找TikTok网红" / "找美妆博主" → `scout tiktok creators`
- "TikTok上什么产品火" / "最近有什么爆款" → `scout tiktok shop-search "品类" --region US`
- "最近流行什么话题" / "看看热门视频" → `scout tiktok trending --region US`
- "搜索TikTok Shop的XX产品" → `scout tiktok shop-search "XX"`
- "这个TikTok Shop产品详情" → `scout tiktok shop-product <productId>`
- "搜索XX相关的视频" → `scout tiktok search-videos "XX"`
- "这个视频数据怎么样" + URL → `scout tiktok video-insights <url>`
- "TikTok热门话题" → `scout tiktok hashtags`
- "看看XX网红推广什么产品" → `scout tiktok creator-products @username`
- 用户发 TikTok Shop 产品链接 → 提取 productId → `scout tiktok shop-product <productId>`
- 用户发 TikTok 视频链接 → `scout tiktok video-insights "<url>"`
- 用户发 TikTok 达人主页链接 → 提取 username → `scout tiktok creator-products @username`

---

## URL 解析 - TikTok 链接处理

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

| URL 特征 | 提取内容 | 调用命令 |
|----------|---------|---------|
| 含 `/product/` 或 `productId=` | productId (数字) | `scout tiktok shop-product <productId>` |
| 含 `/@user/video/` | 完整 URL | `scout tiktok video-insights "<url>"` |
| `vm.tiktok.com/XXXX` 或 `tiktok.com/t/XXXX` | 完整 URL | `scout tiktok video-insights "<url>"` |
| `tiktok.com/@username` (无 /video/) | username | `scout tiktok creator-products @username` |

**示例**：
```bash
# 产品链接 → 提取 productId
# https://www.tiktok.com/view/product/1729991116834247323
scout tiktok shop-product 1729991116834247323

# 视频链接 → 直接传入（支持各种格式，API 自动解析）
scout tiktok video-insights "https://www.tiktok.com/@user/video/7456789012345"

# 达人主页 → 提取 username
scout tiktok creator-products @username --sort popular --limit 30
```

---

## 核心命令

### 📦 第一层：产品发现

#### 1. TikTok Shop 产品搜索 - `scout tiktok shop-search`

直接搜索 TikTok Shop 的在售商品，获取真实销量数据。

```bash
scout tiktok shop-search "coffee" --region US --limit 20
scout tiktok shop-search "coffee maker" --region US --limit 10 --format text
```

**返回数据**：`product_id`, `title`, `product_price_info`, `sold_info.sold_count`（实际销量）, `rate_info`, `seller_info`, `seo_url.canonical_url`

**关键指标**：
- **sold_count**：>5000（高销量）、1000-5000（中等）、<1000（低销量/新品）
  - ⚠️ 实际基准因品类、价格、地区差异很大
- **rating + review_count**：评分高但评论少 = 刷单风险
- **discount_format**：了解价格策略

#### 2. 热门视频 - `scout tiktok trending`

发现正在火的产品和内容。

```bash
scout tiktok trending --region US --time-period 7d --has-product --limit 20
```

**返回数据**：`id`, `url`, `creator`, `description`, `createdAt`, `duration`

**使用场景**：
- 快速查看当前热门视频话题和创作者
- 发现热门内容的创意灵感
- 需要详细数据时，用返回的 URL 调用 `video-insights` 获取完整信息

#### 3. 搜索视频 - `scout tiktok search-videos`

研究特定产品/话题的视频。

```bash
scout tiktok search-videos "coffee maker" --region US --has-product --limit 20
```

**返回数据**：`views`, `likes`, `comments`, `shares`, `productUrl`, `description`, `creator`, `videoUrl`（视频直接下载链接，使用 `wget -O "filename.mp4" "<videoUrl>"` 下载）

**--has-product 参数**：有产品链接 = 已商业化，市场验证

---

### 🔍 第二层：深度分析

#### 4. 视频深度分析 - `scout tiktok video-insights`

分析爆款视频的成功要素。

```bash
scout tiktok video-insights "https://tiktok.com/@user/video/123456789"
```

**返回数据**：`video`（完整数据）, `transcript`（视频字幕，仅当视频有字幕时返回）, `comments`（用户评论）

**分析重点**：
1. Video 统计数据 - views, likes, comments, shares
2. Transcript（如有）前 3 秒 - 开头 Hook
3. Comments 高频词 - "where to buy", "I need this"
4. Likes/Views >5% - 优秀内容
5. Shares - 传播性强

#### 5. TikTok Shop 产品详情 - `scout tiktok shop-product`

获取产品的完整信息。

```bash
scout tiktok shop-product "1729991116834247323"
scout tiktok shop-product "1729991116834247323" --format json
```

**返回数据**：基础信息（标题、价格、销量、评分）、产品规格、运费信息、卖家详情、产品描述和图片

**使用场景**：选品决策、竞品分析、供应商对接

#### 6. 创作者产品提取 - `scout tiktok creator-products`

看某个网红推广什么产品。

```bash
scout tiktok creator-products @username --sort popular --limit 30
```

**返回数据**：`products`（产品URL列表）, `fromVideo`（产品出现在哪个视频，视频表现）

**分析用途**：找网红前看品类契合度、竞品分析、产品验证

---

### 🛠️ 第三层：支撑工具

#### 7. 查找创作者 - `scout tiktok creators`

找网红合作，按粉丝数和互动率筛选。

```bash
scout tiktok creators --follower-count "100K-1M" --sort engagement_rate --limit 20
scout tiktok creators --follower-count "1M-10M" --country US --limit 10
```

**返回数据**：`username`, `displayName`, `followers`, `totalVideos`, `totalLikes`, `engagementRate`（最重要）, `avgViews`, `verified`, `profileUrl`

**关键指标**：
- 互动率 >5% = 优质网红
- 互动率 2-5% = 正常水平
- avgViews/followers >1 = 内容质量好

#### 8. 热门话题 - `scout tiktok hashtags`

找热门话题，优化内容策略。

```bash
scout tiktok hashtags --region US --limit 30
```

**返回数据**：`name`, `views`, `trending`

---

## 选品方法论：数据交叉验证

TikTok 选品的关键是交叉验证：
- 📹 **视频热度**（`search-videos`）= 内容端的热度（views/likes 数据）
- 🎯 **热门话题**（`trending`）= 发现当前趋势和话题方向
- 💰 **销量数据**（`shop-search`, `shop-product`）= 交易端的验证

### 信号强度判断

| 信号强度 | 销量 | 视频数量 | 评论反馈 | 决策 |
|---------|-----|---------|---------|------|
| 🔥 强信号 | >5000 | 3+ 个推同一产品 | 高频询问购买链接 | 立即行动 |
| ⚡ 中等信号 | 1000-5000 | 1-2 个视频 | 部分购买意向 | 值得测试 |
| ❄️ 弱信号 | <1000 | 0-1 个视频 | 无明显意向 | 观望 |

### 典型验证流程

**流程1：search-videos 发现 → shop-search 验证**
```bash
# 1. 搜索产品相关视频，按热度排序
scout tiktok search-videos "产品名" --region US --has-product --limit 20

# 2. 验证销量
scout tiktok shop-search "产品名" --region US

# 3. 判断：高 views/likes + sold_count >5000 = 强信号
```

**流程2：shop-search 发现 → search-videos 学习**
```bash
# 1. 找高销量产品
scout tiktok shop-search "coffee" --region US --limit 20

# 2. 查看详情
scout tiktok shop-product <product_id>

# 3. 搜索推广视频，学习内容角度
scout tiktok search-videos "产品标题" --region US --has-product

# 4. 分析最火视频
scout tiktok video-insights <视频URL>
```

---

## 完整选品工作流

### TikTok → Amazon → 1688 完整链路

```bash
# 1. TikTok Shop 找高销量产品
scout tiktok shop-search "coffee mug" --region US --limit 20

# 2. 查看产品详情
scout tiktok shop-product <product_id>

# 3. 搜索推广视频，学习内容
scout tiktok search-videos "coffee mug" --region US --has-product --limit 20

# 4. 分析爆款视频
scout tiktok video-insights <视频URL>

# 5. Amazon 市场验证
scout search "coffee mug" --limit 10

# 6. 找 1688 供应商
scout supplier-search "咖啡杯" --limit 10
```

### 网红营销选号流程

```bash
# 1. 找目标粉丝规模的网红
scout tiktok creators --follower-count "100K-1M" --sort engagement_rate --limit 20

# 2. 看推广历史（判断品类契合度）
scout tiktok creator-products @creator_username --limit 30

# 3. 分析爆款视频（学习风格）
scout tiktok video-insights <视频URL>
```

### 竞品分析流程

```bash
# 1. 搜索竞品推广视频
scout tiktok search-videos "competitor brand" --limit 30

# 2. 分析竞品内容策略
scout tiktok video-insights <竞品视频URL>

# 3. 搜索竞品 TikTok Shop 产品
scout tiktok shop-search "competitor brand" --limit 20

# 4. 查看竞品产品详情（定价、运费、卖点）
scout tiktok shop-product <competitor_product_id>

# 5. 分析竞品合作网红
scout tiktok creator-products @competitor_influencer
```

---

## 数据解读参考

### 网红质量判断

| 指标 | 优秀 | 良好 | 一般 | 差 |
|------|------|------|------|-----|
| 互动率 | >8% | 5-8% | 2-5% | <2% |
| avgViews/followers | >2 | 1-2 | 0.5-1 | <0.5 |

**决策**：互动率最重要（>5%优先），粉丝数 100K-1M 性价比最高

### 视频表现判断

| 指标 | 优秀 | 良好 | 一般 |
|------|------|------|------|
| Likes/Views | >5% | 3-5% | <3% |
| Comments/Views | >0.5% | 0.2-0.5% | <0.2% |

**购买意向信号**："Where to buy" / "I need this" / "Ordering now"

### TikTok Shop 数据解读

| 销量区间 | 评估 | 评分+评论 | 质量判断 |
|---------|------|---------|---------|
| >10000 | 超级爆款，竞争激烈 | >4.5 + >100 | 产品质量好 |
| 5000-10000 | 热销产品，市场验证充分 | >4.5 + <50 | 可能刷单 |
| 1000-5000 | 稳定需求，适合跟进 | <4.0 | 产品问题，慎重 |
| <1000 | 新品或弱需求 | - | - |

---

## 常见陷阱与避坑指南

### 陷阱1：视频热度与销量不匹配
- **视频火但销量低**：纯娱乐内容，不转化 → 必须用 `shop-search` 验证
- **销量高但视频少**：趋势已过 → 优先选"视频热度上升 + 销量增长"的产品

### 陷阱2：刷单产品
**识别方法**：评分 >4.5 但评论 <10、评论模板化、评论日期集中
**避坑**：结合 trending 视频评论、Amazon 对比、观察店铺其他产品

### 陷阱3：区域和货源限制
- **区域不匹配**：用 `--region` 参数保持一致
- **找不到货源**：使用图片反向搜索、联系原厂代理

---

## 重要提醒

1. **Time Period 选择**：`24h`（最新但可能昙花一现）、`7d`（稳定，推荐）、`30d`（长期但可能过时）
2. **--has-product 筛选**：找产品机会必须加这个参数
3. **Engagement Rate > Follower Count**：小网红高互动比大V低互动效果好
4. **跨 Skill 联动**：TikTok 发现趋势 → scout 验证市场 → scout supplier-search 找供应商
5. **TikTok Shop 数据最可靠**：销量数据 > 视频热度，真实交易数据是最强验证
6. **视频下载**：`search-videos` 和 `video-insights` 返回的 `videoUrl` 是可直接下载的 .mp4 链接（临时链接，几小时后过期），使用 `wget -O "filename.mp4" "<videoUrl>"` 下载
7. **Region 参数使用**：美国和英国的趋势完全不同，建议明确指定 `--region` 匹配目标市场
