@optima-chat/optima-agent 0.9.12 → 0.9.14

package/.claude/skills/douyin/SKILL.md

@@ -1,408 +1,408 @@
----
-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 找供应商
+---
+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 找供应商