@optima-chat/optima-agent 0.7.7 → 0.7.8

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

@@ -17,6 +17,50 @@ npm install -g @optima-chat/scout-cli@latest
 
 ---
 
+## 🌍 地区参数 (Region Parameter)
+
+部分命令支持 `--region` 参数，用于指定目标市场。不同地区的热门内容和产品完全不同。
+
+| 命令 | 是否支持 | 默认值 | 使用说明 |
+|------|---------|--------|---------|
+| `shop-search` | ✅ | 无（可选） | 搜索特定地区的 TikTok Shop 产品 |
+| `search-videos` | ✅ | 无（可选） | 搜索特定地区的视频内容 |
+| `trending` | ✅ | `US` | 查看特定地区的热门视频（默认美国） |
+| `hashtags` | ✅ | `US` | 查看特定地区的热门话题（默认美国） |
+| `creators` | ❌ | - | 使用 `--country` 参数 |
+| `shop-product` | ❌ | - | 产品详情不依赖地区 |
+| `video-insights` | ❌ | - | 视频分析不依赖地区 |
+| `creator-products` | ❌ | - | 创作者产品不依赖地区 |
+
+**支持的地区代码（示例）**：
+- `US` - 美国（最常用）
+- `UK` - 英国
+- `VN` - 越南
+- `GB` - 英国（同 UK）
+
+**使用建议**：
+- ✅ 销售美国市场 → 使用 `--region US` 或不指定（trending/hashtags 默认 US）
+- ✅ 跨市场分析 → 对比不同 region 的搜索结果
+- ✅ 保持一致性 → 同一选品流程中使用同一 region 参数
+
+**示例**：
+```bash
+# 美国市场 TikTok Shop 产品搜索
+scout tiktok shop-search "coffee" --region US --limit 20
+
+# 英国市场热门视频（trending 默认 US，需明确指定）
+scout tiktok trending --region UK --time-period 7d --limit 20
+
+# 越南市场视频搜索
+scout tiktok search-videos "coffee" --region VN --limit 20
+
+# 美国市场话题（默认就是 US，可省略）
+scout tiktok hashtags --limit 30
+scout tiktok hashtags --region US --limit 30  # 等同上一条
+```
+
+---
+
 ## ⚠️ 核心方法论：数据交叉验证
 
 TikTok 选品的**关键**是交叉验证：
@@ -77,11 +121,17 @@ trending/search-videos 发现 → shop-search 验证 → shop-product 深挖 →
 **用途**：直接搜索 TikTok Shop 的在售商品，获取**真实销量数据**
 
 ```bash
-# 搜索咖啡相关产品
-scout tiktok shop-search "coffee" --limit 20
+# 搜索咖啡相关产品（美国市场）
+scout tiktok shop-search "coffee" --region US --limit 20
+
+# 英国市场搜索
+scout tiktok shop-search "coffee maker" --region UK --limit 10
 
 # 文本格式输出（更易读）
-scout tiktok shop-search "coffee maker" --limit 10 --format text
+scout tiktok shop-search "coffee maker" --region US --limit 10 --format text
+
+# 不指定地区（使用 API 默认值）
+scout tiktok shop-search "coffee" --limit 20
 ```
 
 **返回数据**：
@@ -142,11 +192,17 @@ scout tiktok trending --region GB --time-period 24h --limit 30
 **用途**：研究特定产品/话题的视频
 
 ```bash
-# 找咖啡机相关的所有视频
-scout tiktok search-videos "coffee maker" --limit 30
+# 找咖啡机相关的所有视频（美国市场）
+scout tiktok search-videos "coffee maker" --region US --limit 30
 
 # 只找带货视频（验证商业化）
+scout tiktok search-videos "coffee maker" --region US --has-product --limit 20
+
+# 不指定地区（使用 API 默认值）
 scout tiktok search-videos "coffee maker" --has-product --limit 20
+
+# 英国市场搜索
+scout tiktok search-videos "coffee maker" --region UK --limit 30
 ```
 
 **--has-product 参数的意义**：
@@ -312,8 +368,8 @@ scout tiktok hashtags --region US --limit 30
 # Step 1: 看到热门视频推某产品
 scout tiktok trending --region US --has-product
 
-# Step 2: 提取产品关键词，验证 TikTok Shop 销量
-scout tiktok shop-search "提取的产品名"
+# Step 2: 提取产品关键词，验证 TikTok Shop 销量（保持相同地区）
+scout tiktok shop-search "提取的产品名" --region US
 
 # Step 3: 判断
 # - 如果 sold_count >5000 → 强信号，市场验证
@@ -322,25 +378,25 @@ scout tiktok shop-search "提取的产品名"
 
 **场景2：shop-search 发现高销量产品**
 ```bash
-# Step 1: 找高销量产品
-scout tiktok shop-search "coffee" --limit 20
+# Step 1: 找高销量产品（指定目标市场）
+scout tiktok shop-search "coffee" --region US --limit 20
 # 假设发现某款卖了 10000 件
 
 # Step 2: 提取 product_id，看详情
 scout tiktok shop-product <product_id>
 # 了解定价、规格
 
-# Step 3: 搜索推广视频，学习内容角度
-scout tiktok search-videos "产品标题" --has-product
+# Step 3: 搜索推广视频，学习内容角度（保持相同地区）
+scout tiktok search-videos "产品标题" --region US --has-product
 # 如果视频少 → 可能是靠自然流量，内容机会
 # 如果视频多 → 竞争激烈，需要差异化
 ```
 
 **场景3：双向验证（最可靠）**
 ```bash
-# 同时查询视频热度和销量数据
+# 同时查询视频热度和销量数据（保持相同地区）
 scout tiktok trending --region US --has-product --limit 20
-scout tiktok shop-search "同一产品关键词" --limit 20
+scout tiktok shop-search "同一产品关键词" --region US --limit 20
 
 # 交叉对比：
 # 视频热 + 销量高 = 🔥 强信号
@@ -355,16 +411,16 @@ scout tiktok shop-search "同一产品关键词" --limit 20
 ### 流程1：TikTok Shop 选品 → Amazon 验证 → 采购
 
 ```bash
-# 1. 搜索 TikTok Shop 的热销产品
-scout tiktok shop-search "coffee mug" --limit 20
+# 1. 搜索 TikTok Shop 的热销产品（指定目标市场）
+scout tiktok shop-search "coffee mug" --region US --limit 20
 # 关注 sold_count >1000 + rating >4.5 的产品
 
 # 2. 查看高销量产品的详细信息
 scout tiktok shop-product <product_id>
 # 了解规格、定价策略、运费
 
-# 3. 搜索相关视频，看内容趋势
-scout tiktok search-videos "coffee mug" --has-product --limit 20
+# 3. 搜索相关视频，看内容趋势（保持相同地区）
+scout tiktok search-videos "coffee mug" --region US --has-product --limit 20
 # 验证有多少视频在推广，学习内容角度
 
 # 4. 分析最火的推广视频
@@ -397,8 +453,8 @@ scout tiktok trending --region US --has-product --time-period 7d --limit 20
 scout tiktok video-insights "https://tiktok.com/video/xxx"
 # 看评论是否有强购买意向，transcript 看卖点
 
-# 3. 验证 TikTok Shop 销量
-scout tiktok shop-search "从视频提取的产品关键词"
+# 3. 验证 TikTok Shop 销量（保持相同地区）
+scout tiktok shop-search "从视频提取的产品关键词" --region US
 # 如果销量高 → 强信号
 
 # 4. 查看产品详情
@@ -574,12 +630,12 @@ scout tiktok creator-products @competitor_influencer
 
 ## 重要提醒
 
-1. **Region 很重要**：美国和英国的趋势完全不同，务必指定 `--region` 匹配目标市场
-2. **Time Period 选择**：
+1. **Time Period 选择**：
    - `24h` - 抓最新趋势，但可能是昙花一现
    - `7d` - 稳定趋势，最推荐
    - `30d` - 长期趋势，但可能已经过时
-3. **--has-product 筛选**：找产品机会必须加这个参数，否则很多纯内容向视频
-4. **Engagement Rate > Follower Count**：小网红高互动比大V低互动效果好
-5. **跨 Skill 联动**：TikTok 发现趋势 → scout 验证市场 → scout supplier-search 找供应商，这是完整链路
-6. **TikTok Shop 数据最可靠**：销量数据 > 视频热度，真实交易数据是最强验证
+2. **--has-product 筛选**：找产品机会必须加这个参数，否则很多纯内容向视频
+3. **Engagement Rate > Follower Count**：小网红高互动比大V低互动效果好
+4. **跨 Skill 联动**：TikTok 发现趋势 → scout 验证市场 → scout supplier-search 找供应商，这是完整链路
+5. **TikTok Shop 数据最可靠**：销量数据 > 视频热度，真实交易数据是最强验证
+6. **Region 参数使用**：美国和英国的趋势完全不同，建议明确指定 `--region` 匹配目标市场（详见"🌍 地区参数"章节）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.7.7",
+  "version": "0.7.8",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",