@optima-chat/optima-agent 0.9.13 → 0.9.15

package/.claude/skills/tiktok/SKILL.md

@@ -1,381 +1,381 @@
----
-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` 匹配目标市场
+---
+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` 匹配目标市场