@optima-chat/optima-agent 0.7.9 → 0.8.0

package/.claude/settings.local.json

@@ -106,7 +106,11 @@
       "Bash(git pull:*)",
       "Bash(pnpm build:*)",
       "Skill(read-code)",
-      "Bash(npm run cli:*)"
+      "Bash(npm run cli:*)",
+      "Bash(scout:*)",
+      "WebFetch(domain:docs.scrapecreators.com)",
+      "WebFetch(domain:scrapecreators.com)",
+      "Bash(gh auth status:*)"
     ],
     "deny": [],
     "ask": []

package/.claude/skills/scout/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: scout
-description: "Interactive Amazon product research consultant with 1688 supplier sourcing. Search products, analyze markets, find suppliers, and generate professional reports. ALWAYS use when user asks about: selling products (卖/开店), product ideas (产品/商品), market research (市场/竞品), suppliers (供应商/厂家), sourcing (采购/进货/货源), evaluating business opportunities (生意/创业). Start with conversational exploration, then suggest comprehensive report generation. Uses 'scout search', 'scout product', and 'scout supplier-search' commands."
+description: "Interactive Amazon product research consultant with 1688 supplier sourcing. Search products, analyze markets, find suppliers (by keyword or image), and generate professional reports. ALWAYS use when user asks about: selling products (卖/开店), product ideas (产品/商品), market research (市场/竞品), suppliers (供应商/厂家), sourcing (采购/进货/货源), image search (图片找货/以图搜货/找同款), evaluating business opportunities (生意/创业). Start with conversational exploration, then suggest comprehensive report generation. Uses 'scout search', 'scout product', 'scout supplier-search', and 'scout supplier-search-image' commands."
 ---
 
 # Optima Scout - AI Product Research
@@ -16,6 +16,7 @@ Use this skill when:
 - User needs to find suppliers or manufacturers (e.g., "帮我找咖啡机供应商", "哪里进货")
 - User wants to source products from 1688/Alibaba China
 - User asks about wholesale prices, bulk purchasing costs, or profit margins (e.g., "成本多少", "批发价", "利润空间")
+- User wants to find suppliers by product image (e.g., "这个图片能找到货源吗", "帮我找同款", "看图找货", "Amazon这个能在1688找到吗")
 
 ## Interaction Style: Conversational → Report
 
@@ -116,33 +117,60 @@ scout product ASIN
 - **Images count** - 7 is standard, fewer = poor optimization
 - **Specifications** - May include BSR in multiple categories
 
-### 3. Search 1688 Suppliers: `scout supplier-search`
+### 3. Search 1688 Suppliers (Keyword): `scout supplier-search`
 
-Search for suppliers on 1688.com to find wholesale sources and manufacturing partners.
+Search for suppliers on 1688.com using keywords.
 
 **Syntax:**
 ```bash
-scout supplier-search "KEYWORD" --limit NUMBER --format FORMAT
+scout supplier-search "KEYWORD" --limit NUMBER
 ```
 
 **Parameters:**
 - `KEYWORD`: Product keywords in Chinese (e.g., "咖啡机", "蓝牙耳机", "钛合金杯子")
 - `--limit`: Number of results (1-100, default: 20)
-- `--format`: Output format - `text` (human-readable) or `json` (for data processing)
+- `--format`: Output format - `text` or `json`
 
 **Returns:**
-- Supplier list with product info, pricing, MOQ (minimum order quantity), supplier ratings
+- Supplier list with product info, pricing, MOQ, supplier ratings
 - Price tiers for bulk ordering (e.g., "2~49台: ¥599", "≥100台: ¥429")
-- Supplier details: name, location, years in business, seller type (manufacturer vs. trader)
+- Supplier details: location, years in business, seller type
 - Tags: shipping policies (退货包运费), payment terms (先采后付), certifications (实力商家)
 
 **Key analysis:**
 - MOQ constraints (minimum order quantity)
-- Price tiers for bulk ordering
 - Supplier type: 生产加工 (manufacturer) vs. 经销批发 (trader)
 - Years in business (8+ years = established)
 - Return rate (lower = better, typical: 30-50%)
 
+### 4. Search 1688 Suppliers (Image): `scout supplier-search-image`
+
+Search for suppliers on 1688.com using product images - perfect for finding sources for products you see on Amazon, Shopify, or other platforms.
+
+**Syntax:**
+```bash
+scout supplier-search-image "IMAGE_URL" --limit NUMBER
+```
+
+**Parameters:**
+- `IMAGE_URL`: Product image URL (Amazon, Alibaba, or any accessible image URL)
+- `--limit`: Number of results (1-100, default: 20)
+- `--format`: Output format - `text` or `json`
+
+**Returns:** Same as `supplier-search` (supplier list, pricing, MOQ, ratings)
+
+**Use cases:**
+- Finding 1688 alternatives for Amazon/Shopify products
+- "找同款" / "看图找货" scenarios
+- Visual products where images are more descriptive than keywords
+- When user provides product image URL
+
+**Important notes:**
+- Works with images from any platform (Amazon, Alibaba, direct URLs)
+- Non-Alibaba images are automatically converted for 1688 search
+- If image is inaccessible (404, expired, auth-required), will return helpful error message
+- **Best practice**: Try both image and keyword search for comprehensive results
+
 ## Research Workflow
 
 ### Interactive Research Flow (Recommended):
@@ -150,10 +178,7 @@ scout supplier-search "KEYWORD" --limit NUMBER --format FORMAT
 **Phase 1: Initial Discovery & Discussion**
 1. **Quick Market Scan** → Run 1-2 searches with key terms
 2. **Share Initial Findings** → Present key metrics (price range, competition level, demand signals)
-3. **Discuss with User** → Ask clarifying questions:
-   - "我发现市场上有 X 个竞品，价格区间是 $Y-Z，你的目标价位是多少？"
-   - "看起来高端保温款竞争少，要不要深入看看这个方向？"
-   - "你更关注哪些产品？我可以详细分析"
+3. **Discuss with User** → Ask clarifying questions about target price, market segment, priorities
 
 **Phase 2: Deep Dive & Refinement**
 4. **Targeted Analysis** → Based on user feedback, run `scout product` on relevant ASINs
@@ -161,25 +186,26 @@ scout supplier-search "KEYWORD" --limit NUMBER --format FORMAT
 6. **Iterate & Explore** → User may request different keywords, specific competitor analysis, or alternative product categories
 
 **Phase 2.5: Supplier Sourcing (Optional but Recommended)**
-7. **Trigger**: User shows interest in profit margins, costs, or sourcing:
+7. **Trigger**: User shows interest in costs/sourcing, or after market validation
    - "成本大概多少？" "批发价怎么样？" "利润空间大吗？"
    - "哪里进货？" "供应商怎么找？"
-   - Or proactively suggest after market analysis: "要不要我帮你查一下供应商成本？"
-8. **Search 1688 Suppliers**:
-   ```bash
-   scout supplier-search "咖啡机" --limit 10
-   ```
+   - "这个图片能找到货源吗？" "Amazon这个能在1688找到吗？"
+
+8. **Choose search method**:
+   - **With image**: `scout supplier-search-image "https://..."` ← More accurate for visual products
+   - **With keyword**: `scout supplier-search "产品关键词"`
+   - **Best practice**: Try both and compare results
+
 9. **Share Findings**:
    - Wholesale price range (e.g., ¥429-599)
    - MOQ (minimum order quantity)
    - Profit margin calculation: Amazon price ($60-80) - 1688 cost (¥429 ≈ $60) - shipping ($10-15)
    - Supplier quality indicators (years in business, certifications)
+
 10. **Ask**: "要不要我详细分析几个供应商？" or proceed to report
 
 **Phase 3: Report Generation (Proactive Suggestion)**
-11. **Gauge Completion** → After sufficient data gathering, **proactively suggest**:
-   - "我已经收集了足够的数据，要不要我整理成一份完整的市场分析报告？"
-   - "我可以生成一份详细报告，包括市场规模、竞品分析、进入策略和财务预测"
+11. **Gauge Completion** → After sufficient data, suggest: "要不要我整理成一份完整的市场分析报告？"
 12. **Generate Report** → Create comprehensive markdown report with all findings
 13. **Save & Iterate** → Offer to save report and refine based on feedback
 
@@ -187,12 +213,11 @@ scout supplier-search "KEYWORD" --limit NUMBER --format FORMAT
 
 ### Alternative: Quick Research Flow
 
-When user explicitly requests a report upfront ("给我一份XX市场分析报告"):
+When user explicitly requests a report upfront:
 1. Run 3-4 diverse keyword searches
 2. Analyze top 3-5 products with `scout product`
-3. Search 1688 suppliers for cost analysis
+3. Search 1688 suppliers (image + keyword)
 4. Generate comprehensive report directly
-5. Offer follow-up discussion after report delivery
 
 ### Multi-Keyword Research Strategy
 
@@ -201,138 +226,77 @@ When user explicitly requests a report upfront ("给我一份XX市场分析报
 scout search "titanium cup" --limit 15
 scout search "titanium mug" --limit 15
 scout search "titanium tumbler" --limit 10
-scout search "camping titanium" --limit 10
 ```
 
 **Why multiple keywords:**
 - Different keywords reveal different market segments
-- Find niche opportunities (e.g., "insulated titanium" vs "camping titanium")
-- Cross-validate market size across searches
-- Discover related products and categories
-
-## Complete Example: Interactive Research Session
-
-**User**: "我想开个店卖钛合金杯子，你觉得合适吗"
-
-**Assistant Phase 1 - Initial Scan:**
-```bash
-scout search "titanium cup" --limit 15
-scout search "titanium mug" --limit 10
-```
-
-**Assistant**: "我先快速看了一下钛合金杯子市场：
-- 市场上有约 50+ 个竞品
-- 价格区间：$15-90，主要集中在 $20-30
-- 头部产品月销约 200 件（看 'recent_sales' 数据）
-- 竞争适中，评论数多在 50-200 之间
-
-我注意到两个方向：
-1. 低价位单层杯（$15-25）- 竞争激烈
-2. 高端保温款（$60-90）- 产品很少
-
-**你更倾向哪个价位段？或者你的目标客户群是什么？**"
-
-**User**: "我想做中高端的，质量好的"
-
-**Assistant Phase 2 - Targeted Deep Dive:**
-```bash
-scout product B0CTKWJDXX  # TOAKS - 中端爆款
-scout product B0DNCMN3NX  # KOYASU - 高端保温款
-scout product B083NLR6BF  # usharedo - 低价参考
-```
+- Find niche opportunities
+- Cross-validate market size
+- Discover related products
 
-**Assistant**: "我详细分析了 3 个代表性产品：
+## Usage Examples
 
-**TOAKS (中端爆款)**
-- BSR #530 → 月销约 250 件
-- 评分 4.7，87% 五星好评
-- 用户最爱：超轻、品质好、无金属味
-- 主要抱怨：散热快（无保温）、无盖子
+### Example 1: Interactive Research (Keyword-based)
 
-**KOYASU (高端保温)**
-- 双层保温，$89.99
-- 评论少（18 条）但 4.8 高分
-- 这个方向竞争少！
-
-**发现机会点：**
-保温款市场几乎空白，但用户需求很强（很多人在评论里说希望有保温功能）。
-
-**要不要我再看看 'titanium tumbler' 这个关键词，专门找保温方向的竞品？**"
-
-**User**: "好的，你看看"
-
-**Assistant Phase 3 - Refined Search:**
-```bash
-scout search "titanium tumbler" --limit 10
-```
+**User**: "我想开个店卖钛合金杯子，你觉得合适吗"
 
-**Assistant**: "找到了！titanium tumbler 搜索结果更聚焦保温款，竞品只有 5-6 个，价格 $60-110。
+**Flow:**
+1. Run `scout search "titanium cup"` + `scout search "titanium mug"`
+2. Share: "市场有50+竞品，价格$15-90，主要在$20-30。头部产品月销约200件。两个方向：低价位($15-25)竞争激烈，高端保温款($60-90)产品很少。你更倾向哪个？"
+3. User: "中高端的，质量好的"
+4. Run `scout product` on 3 representative ASINs (B0CTKWJDXX, B0DNCMN3NX, B083NLR6BF)
+5. Share: "TOAKS中端爆款BSR#530，月销250件，87%五星。用户最爱：超轻、品质好、无金属味。主要抱怨：散热快（无保温）。KOYASU高端保温$89.99，评论少但4.8分。保温款市场几乎空白！"
+6. User: "好的，你看看"
+7. Run `scout search "titanium tumbler"`
+8. Share: "titanium tumbler竞品只5-6个，$60-110。现在查供应商成本？"
+9. Run `scout supplier-search "钛合金保温杯"`
+10. Share: "批发价区间：¥180-450（约$25-65），起订量多数50-100个。头部供应商：8年工厂，¥280批发价。**利润分析**：Amazon售价$70-90，1688成本¥280（约$40），运费+关税约$15，总成本约$55，**毛利率25-40%**。"
+11. Suggest report generation
 
-**现在帮你查一下 1688 供应商成本，看看利润空间？**"
+### Example 2: Image-Based Supplier Search
 
-**User**: "好的"
+**User**: "我在Amazon看到这个蓝牙耳机很火，帮我找1688供应商 https://m.media-amazon.com/images/..."
 
-**Assistant Phase 2.5 - Supplier Sourcing:**
+**Flow:**
 ```bash
-scout supplier-search "钛合金保温杯" --limit 10
+scout supplier-search-image "https://m.media-amazon.com/images/..." --limit 20
 ```
 
-**Assistant**: "找到供应商数据：
-- 批发价区间：¥180-450（约 $25-65）
-- 起订量：多数 50-100 个
-- 头部供应商：8年工厂，¥280 批发价，起订 50 个
-
-**利润空间分析：**
-- Amazon 售价：$70-90
-- 1688 批发价：¥280（约 $40）
-- 运费+关税：约 $15
-- 总成本：约 $55
-- 毛利率：约 25-40%
-
-我现在收集了足够的数据：
-- 4 个关键词搜索
-- 5 个产品深度分析
-- 供应商成本分析
-- 明确的市场空白（保温款）
-
-**要不要我把这些整理成一份完整的市场分析报告？可以包括：**
-- 市场规模和竞争格局
-- 头部产品深度拆解
-- 保温款机会分析
-- 进入策略（定价、差异化、供应链）
-- 财务预测"
+**Response**: "通过图片搜索找到15个供应商：
 
-**User**: "好的，生成报告吧"
+**TOP 3 推荐：**
+1. 深圳某电子厂（8年工厂）
+   - 批发价：¥45-68 | Amazon售价：$89.99
+   - 起订量：50件 | 评分：4.8★
+   - **利润空间：~40-50%**
 
-**Assistant Phase 4 - Generate Report:**
-[Creates comprehensive report: `钛合金杯子市场分析报告.md`]
+2. 东莞某科技（5年工厂）
+   - 批发价：¥38-55 | 起订量：100件
+   - 标签：退货包运费、7天包换
 
-**Assistant**: "报告已生成！核心结论：
-✅ 适合进入，但需专注中高端保温款（$60-90）
-✅ 避开低价位红海，填补保温功能空白
-✅ 预计首年净利润 $17k，ROI 76%
+3. [...]
 
-报告已保存为 `钛合金杯子市场分析报告.md`，需要补充哪些信息吗？"
+要详细对比这几个供应商吗？"
 
-## Competitor Analysis Checklist
+### Example 3: Competitor Analysis
 
-When user asks to analyze a specific product (e.g., "帮我分析一下这个产品 B0788F3R8X"), follow this analysis framework:
+**User**: "帮我分析这个产品 B0788F3R8X"
 
+**Action:**
 ```bash
 scout product B0788F3R8X
 ```
 
 **Analysis Checklist:**
 - ✅ **BSR & Market Position**
-  - Check BSR in specifications
-  - Estimate sales volume from BSR
+  - Check BSR in specifications → estimate sales volume
   - Compare with category averages
 - ✅ **Customer Satisfaction**
   - Rating breakdown (five-star %, one-star %)
   - Total reviews count (market maturity indicator)
   - Review trends over time
 - ✅ **Listing Quality**
-  - Images count (7 is standard)
+  - Images count (7 is standard, fewer = poor optimization)
   - Feature bullets count and quality
   - Product description completeness
   - A+ content presence
@@ -349,37 +313,42 @@ scout product B0788F3R8X
 
 ## Analysis Framework
 
-### Market Viability Assessment
+### Market Viability Quick Reference
 
 | 指标 | 优秀市场 | 正常市场 | 风险市场 |
 |------|---------|---------|---------|
 | 竞品数量 | 10-50 | 5-10 或 50-100 | <5 或 >100 |
-| 头部产品评论数 | 100-1000 | 50-100 或 1000-5000 | <50 或 >5000 |
-| 价格区间 | 宽（有差异化空间） | 中等 | 窄（价格战） |
-| BSR 范围 | 1K-10K | 10K-50K | >50K |
+| 头部评论数 | 100-1000 | 50-100 或 1K-5K | <50 或 >5K |
+| 价格区间 | 宽（差异化） | 中等 | 窄（价格战） |
+| BSR范围 | 1K-10K | 10K-50K | >50K |
+| 进入难度 | 适中 | 需差异化 | 很难或需求不明 |
+
+### Key Metrics
+
+**BSR (Best Seller Rank):**
+- <1K = 月销500+件 | 1K-10K = 100-500件 | 10K-50K = 20-100件 | >50K = <20件
 
-**决策逻辑**：
-- **优秀市场** = 有需求、有空间、竞争适中
-- **正常市场** = 需要差异化或资源投入
-- **风险市场** = 需求不明或红海竞争
+**Rating Breakdown:**
+- 70%+ five-star = 优秀 | 60-70% = 正常 | <60% = 质量问题 | 10%+ one-star = 严重问题
+
+**Market Maturity:**
+- ratings_total >1000 = 成熟 | 100-1000 = 发展中 | <100 = 新兴/小众
 
-### Demand Indicators
+**Demand Signals:**
 
-**High Demand Signals:**
-- ✅ "10K+ bought in past month" 标签
-- ✅ 多个产品 ratings_total > 500
-- ✅ BSR < 10,000 in category
+High Demand:
+- ✅ "10K+ bought in past month"
+- ✅ 多个产品 ratings_total >500
+- ✅ BSR <10K
 - ✅ 搜索结果超过 30 个相关产品
 
-**Low Demand Signals:**
+Low Demand:
 - ⚠️ 少于 10 个搜索结果
 - ⚠️ 头部产品 ratings_total < 50
 - ⚠️ BSR > 100,000
 - ⚠️ 没有 "bought in past month" 标签
 
-### Competitive Landscape
-
-**进入难度评估：**
+**Entry Difficulty Assessment:**
 
 | 维度 | 容易进入 | 中等难度 | 困难进入 |
 |------|---------|---------|---------|
@@ -388,15 +357,14 @@ scout product B0788F3R8X
 | 价格竞争 | 差异化定价 | 价格区间宽 | 价格战 |
 | 评分分布 | <4.5 平均分 | 4.5-4.7 | >4.7（难超越） |
 
-### Report Generation Guidelines
+### Report Generation
 
-**When to suggest report:**
-- ✅ 3+ searches completed with diverse keywords
-- ✅ 3-5 products analyzed in detail (with BSR, reviews, etc.)
-- ✅ User asks synthesizing questions: "所以你觉得呢？" "值得做吗？" "总结一下"
-- ✅ Clear opportunity or risk identified that should be documented
+**When to suggest:**
+- 3+ searches + 3-5 product analyses completed
+- User asks: "所以你觉得呢？" "值得做吗？" "总结一下"
+- Clear opportunity/risk identified that should be documented
 
-**How to suggest report (use this natural template):**
+**How to suggest (use this natural template):**
 ```
 "我已经分析了 X 个搜索和 Y 个竞品，发现了一些有意思的模式。
 
@@ -420,74 +388,36 @@ scout product B0788F3R8X
 - Offer report again later if more data gathered
 
 **Report must include:**
-- **Executive Summary** - 核心结论前置（适合进入？风险是什么？）
-- **Market Analysis** - 基于搜索数据的市场概况
-- **Competitor Deep-Dive** - 基于 product details 的竞品分析（BSR, rating breakdown, top reviews insights）
-- **Opportunity Assessment** - SWOT 或机会/挑战分析
-- **Entry Strategy** - 产品定位、定价、差异化策略
-- **Financial Projections** (optional) - 如果用户需要投资决策
-- **Supplier Analysis** (if Phase 2.5 completed) - 1688 供应商、成本、利润空间
+- Executive Summary（核心结论前置：适合进入？风险是什么？）
+- Market Analysis（基于搜索数据的市场概况）
+- Competitor Deep-Dive（基于product details的竞品分析：BSR, rating breakdown, top reviews insights）
+- Opportunity Assessment（SWOT 或机会/挑战分析）
+- Entry Strategy（产品定位、定价、差异化策略）
+- Supplier Analysis (if Phase 2.5 completed)（1688供应商、成本、利润空间）
 
-**Report naming:**
-- Save as: `{产品类型}市场分析报告.md`
-- Example: `钛合金杯子市场分析报告.md`
-
-## Key Metrics Quick Reference
-
-**BSR (Best Seller Rank):**
-- < 1,000 = 月销 500+ 件
-- 1,000-10,000 = 月销 100-500 件
-- 10,000-50,000 = 月销 20-100 件
-- > 50,000 = 月销 <20 件
-
-**Rating Breakdown:**
-- 70%+ five-star = 优秀产品质量
-- 60-70% five-star = 正常水平
-- <60% five-star = 质量问题或期望不符
-- 10%+ one-star = 严重质量问题
-
-**Market Maturity:**
-- ratings_total >1000 = 成熟市场
-- ratings_total 100-1000 = 发展中市场
-- ratings_total <100 = 新兴市场或小众
-
-**Listing Quality:**
-- 7 images = 标准
-- 5+ feature bullets = 完整
-- A+ content = 专业卖家
+**Report naming:** `{产品类型}市场分析报告.md`
 
 ## Cross-Skill Integration
 
 **TikTok/Instagram → Scout → Supplier 完整链路：**
 
-1. **TikTok/Instagram** - 发现趋势产品
-   ```bash
-   scout tiktok trending --has-product
-   # 或
-   scout instagram reels "产品关键词"
-   ```
-
-2. **Scout (Amazon)** - 验证市场需求
+1. **Discover** (TikTok/Instagram) → Find trending products
+2. **Validate** (Scout Amazon) → Verify market demand
    ```bash
    scout search "product name" --limit 15
    scout product <top_asin>
    ```
-
-3. **Scout (1688)** - 找供应商和成本
+3. **Source** (Scout 1688) → Find suppliers and cost
    ```bash
-   scout supplier-search "产品关键词" --limit 10
-   ```
+   # Method A: Image search (recommended for visual match)
+   scout supplier-search-image "https://amazon-image-url"
 
-4. **决策** - 综合分析：
-   - TikTok/Instagram 验证内容热度
-   - Amazon 验证购买需求和竞争
-   - 1688 验证供应链和利润空间
-   - 三者都通过 → 值得做
+   # Method B: Keyword search
+   scout supplier-search "产品关键词"
 
-**Proactive suggestion after cross-skill analysis:**
-"我已经分析了：
-- TikTok 内容热度（X 个热门视频）
-- Amazon 市场需求（价格 $Y, BSR Z）
-- 1688 供应商成本（批发价 ¥W，起订 Q 个）
+   # Best: Try both
+   ```
+4. **Decide** →综合分析三者数据，都通过→值得做
 
-要不要生成一份完整的产品机会分析报告？"
+**Proactive suggestion after cross-skill analysis:**
+"我已经分析了TikTok热度、Amazon市场需求、1688供应商成本。要不要生成一份完整的产品机会分析报告？"

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

@@ -49,8 +49,8 @@ scout tiktok trending --region UK --time-period 7d --limit 20
 
 | 你的目标 | 最佳命令 | 补充命令 | 组合逻辑 |
 |---------|---------|---------|---------|
-| **发现爆款产品** | `shop-search` 按销量排序 | `trending --has-product` | 销量+热度双验证 |
-| **找内容灵感** | `trending` | `video-insights` | 看趋势视频的文案和 hook |
+| **发现爆款产品** | `shop-search` 按销量排序 | `search-videos --has-product` | 销量+视频热度双验证 |
+| **找内容灵感** | `trending` | `video-insights` | 发现热门话题，深入分析文案 |
 | **验证产品需求** | `search-videos "产品" --has-product` | `shop-search "产品"` | 视频数量=热度，销量=真实需求 |
 | **竞品分析** | `search-videos "品牌"` | `shop-search "品牌"` | 内容策略+价格策略 |
 | **网红合作** | `creators` | `creator-products` | 找人+看历史推广 |
@@ -62,7 +62,8 @@ scout tiktok trending --region UK --time-period 7d --limit 20
 
 当用户说：
 - "帮我找TikTok网红" / "找美妆博主" → `scout tiktok creators`
-- "TikTok上什么产品火" / "最近有什么爆款" → `scout tiktok trending --has-product`
+- "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"`
@@ -101,12 +102,12 @@ scout tiktok shop-search "coffee maker" --region US --limit 10 --format text
 scout tiktok trending --region US --time-period 7d --has-product --limit 20
 ```
 
-**返回数据**：`views`, `likes`, `comments`, `shares`, `productUrl`, `description`, `creator`, `videoUrl`（视频直接下载链接，使用 `wget -O "filename.mp4" "<videoUrl>"` 下载）
+**返回数据**：`id`, `url`, `creator`, `description`, `createdAt`, `duration`
 
-**分析逻辑**：
-- 多个视频推同一产品 = 趋势信号强
-- 评论问"哪里买" = 购买意向高
-- likes/views >5% = 内容质量好
+**使用场景**：
+- 快速查看当前热门视频话题和创作者
+- 发现热门内容的创意灵感
+- 需要详细数据时，用返回的 URL 调用 `video-insights` 获取完整信息
 
 #### 3. 搜索视频 - `scout tiktok search-videos`
 
@@ -132,13 +133,14 @@ scout tiktok search-videos "coffee maker" --region US --has-product --limit 20
 scout tiktok video-insights "https://tiktok.com/@user/video/123456789"
 ```
 
-**返回数据**：`video`（完整数据）, `transcript`（视频字幕，分析 Hook 和文案）, `comments`（用户评论，提取情感和购买意向）
+**返回数据**：`video`（完整数据）, `transcript`（视频字幕，仅当视频有字幕时返回）, `comments`（用户评论）
 
 **分析重点**：
-1. Transcript 前 3 秒 - 开头 Hook
-2. Comments 高频词 - "where to buy", "I need this"
-3. Likes/Views >5% - 优秀内容
-4. Shares - 传播性强
+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`
 
@@ -200,7 +202,8 @@ scout tiktok hashtags --region US --limit 30
 ## 选品方法论：数据交叉验证
 
 TikTok 选品的关键是交叉验证：
-- 📹 **视频热度**（`trending`, `search-videos`）= 内容端的热度
+- 📹 **视频热度**（`search-videos`）= 内容端的热度（views/likes 数据）
+- 🎯 **热门话题**（`trending`）= 发现当前趋势和话题方向
 - 💰 **销量数据**（`shop-search`, `shop-product`）= 交易端的验证
 
 ### 信号强度判断
@@ -213,15 +216,15 @@ TikTok 选品的关键是交叉验证：
 
 ### 典型验证流程
 
-**流程1：trending 发现 → shop-search 验证**
+**流程1：search-videos 发现 → shop-search 验证**
 ```bash
-# 1. 看到热门视频推某产品
-scout tiktok trending --region US --has-product
+# 1. 搜索产品相关视频，按热度排序
+scout tiktok search-videos "产品名" --region US --has-product --limit 20
 
 # 2. 验证销量
 scout tiktok shop-search "产品名" --region US
 
-# 3. 判断：sold_count >5000 = 强信号
+# 3. 判断：高 views/likes + sold_count >5000 = 强信号
 ```
 
 **流程2：shop-search 发现 → search-videos 学习**
@@ -353,5 +356,5 @@ scout tiktok creator-products @competitor_influencer
 3. **Engagement Rate > Follower Count**：小网红高互动比大V低互动效果好
 4. **跨 Skill 联动**：TikTok 发现趋势 → scout 验证市场 → scout supplier-search 找供应商
 5. **TikTok Shop 数据最可靠**：销量数据 > 视频热度，真实交易数据是最强验证
-6. **视频下载**：`trending` 和 `search-videos` 返回的 `videoUrl` 是可直接下载的 .mp4 链接，使用 `wget -O "filename.mp4" "<videoUrl>"` 下载
+6. **视频下载**：`search-videos` 和 `video-insights` 返回的 `videoUrl` 是可直接下载的 .mp4 链接（临时链接，几小时后过期），使用 `wget -O "filename.mp4" "<videoUrl>"` 下载
 7. **Region 参数使用**：美国和英国的趋势完全不同，建议明确指定 `--region` 匹配目标市场

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.7.9",
+  "version": "0.8.0",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",
@@ -42,11 +42,11 @@
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.1.55",
+    "@optima-chat/ads-cli": "latest",
     "@optima-chat/bi-cli": "latest",
     "@optima-chat/comfy-cli": "latest",
     "@optima-chat/commerce-cli": "latest",
-    "@optima-chat/ads-cli": "latest",
-    "@optima-chat/scout-cli": "latest",
+    "@optima-chat/scout-cli": "^0.8.0",
     "open": "^10.1.0",
     "ws": "^8.18.3",
     "zod": "^3.23.8"