@optima-chat/optima-agent 0.5.12 → 0.6.0

package/.claude/settings.local.json

@@ -77,7 +77,15 @@
       "Bash(chmod:*)",
       "Bash(npm whoami:*)",
       "Bash(tsx test-scripts/test-headless-progress.ts:*)",
-      "Bash(DEBUG_STREAM=1 node dist/bin/optima.js:*)"
+      "Bash(DEBUG_STREAM=1 node dist/bin/optima.js:*)",
+      "Bash(git describe:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(./scripts/test-headless.sh:*)",
+      "Bash(./scripts/test-headless-simple.sh:*)",
+      "Bash(env)",
+      "Bash(gh pr list:*)",
+      "Bash(gh pr view:*)",
+      "Bash(gh pr diff:*)"
     ],
     "deny": [],
     "ask": []

package/.claude/skills/instagram/SKILL.md

@@ -0,0 +1,295 @@
+---
+name: instagram
+description: Instagram influencer marketing and content research. Use when user needs to find Instagram creators (Instagram网红/博主/KOL), analyze Instagram Reels (短视频/Reels/热门视频), research influencer profiles (主页分析/账号数据), or competitive analysis (竞品分析/对手研究).
+---
+
+# Instagram - Influencer Marketing & Content Research
+
+## 典型场景
+
+当用户说：
+- "帮我找Instagram博主" / "找美妆网红" → `scout instagram reels "美妆"` 通过内容找创作者
+- "分析XX的Instagram账号" / "@username数据怎么样" → `scout instagram profile @username`
+- "搜索瑜伽相关的Reels" → `scout instagram reels "yoga" --limit 30`
+- "这个Reel为什么火" + URL → `scout instagram reel-insights <url>`
+- "看看XX发了什么内容" → `scout instagram creator-reels @username`
+
+### 场景决策表
+
+| 用户需求 | 推荐命令 | 关键参数 |
+|---------|---------|---------|
+| 找网红合作 | `instagram reels "关键词"` 再 `profile` 分析候选人 | `--min-plays` 筛选高播放 |
+| 账号质量评估 | `instagram profile @username` | 看 followers/following 比例、验证状态 |
+| 内容策略研究 | `instagram reels "话题"` + `reel-insights` | 分析高播放 Reels 的共同点 |
+| 竞品分析 | `instagram profile @competitor` + `creator-reels` | 看他们的内容策略和表现 |
+| 网红内容审查 | `instagram creator-reels @username --limit 30` | 评估内容质量和一致性 |
+
+## 核心命令
+
+### 1. 分析账号 - `scout instagram profile`
+
+**用途**：评估网红账号质量和可信度
+
+```bash
+scout instagram profile @username
+scout instagram profile beautyguru  # 可以不加 @
+```
+
+**返回数据**：
+- `username`, `fullName` - 账号信息
+- `followers`, `following`, `totalPosts` - **关键**，判断账号规模和活跃度
+- `verified` - **重要**，平台认证
+- `isPrivate` - 是否私密（私密账号无法合作）
+- `category` - 账号分类（Beauty, Fashion, Fitness 等）
+- `biography`, `externalUrl` - 个人简介和联系方式
+
+**质量判断**：
+- **followers/following 比例**：
+  - >10:1 = 优质账号（1M粉丝，10K关注）
+  - 2-10:1 = 正常账号
+  - <2:1 = 可能互粉或买粉
+- **verified = true** = 平台认证，可信度高
+- **totalPosts**：
+  - >500 = 老账号，内容稳定
+  - 100-500 = 正常
+  - <100 = 新账号或不活跃
+- **category 匹配** = 品类契合度
+
+### 2. 搜索 Reels - `scout instagram reels`
+
+**用途**：找话题相关的内容和创作者
+
+```bash
+# 找瑜伽相关的 Reels
+scout instagram reels "yoga" --limit 30
+
+# 找高播放的咖啡 Reels
+scout instagram reels "coffee" --min-plays 100000 --limit 20
+```
+
+**返回数据**：
+- `creator` - 创作者信息（username, fullName）
+- `plays`, `likes`, `comments` - 互动数据
+- `caption` - 标题文案
+- `url` - Reel 链接
+
+**分析逻辑**：
+- **plays 数据** - 有时为 null（Instagram 不总是显示播放数）
+- **likes/plays >3%** = 高互动（如果有 plays 数据）
+- **caption 长度** - 长文案（>100 字）通常是教程型，短文案是快消费
+- **从搜索结果中找到多个创作者** → 用 `profile` 分析他们
+
+### 3. 获取创作者 Reels - `scout instagram creator-reels`
+
+**用途**：看某个网红发了什么内容，评估内容质量
+
+```bash
+scout instagram creator-reels @username --limit 30
+```
+
+**返回数据**：
+- `reels` - Reel 列表
+  - `shortcode` - Reel ID
+  - `plays`, `likes`, `comments` - 互动数据
+  - `caption` - 文案
+  - `url` - 链接
+
+**分析用途**：
+1. **评估内容一致性** - 看最近 20-30 个 Reels 的主题是否聚焦
+2. **计算平均互动** - 避免只看单个爆款，要看整体表现
+3. **找爆款内容** - 找 likes 最高的几个，用 `reel-insights` 深入分析
+4. **发布频率** - 最近 30 个 Reels 的时间跨度，判断更新频率
+
+**质量判断**：
+- **一致性高**（同一品类）= 垂直网红，受众精准
+- **一致性低**（各种话题都发）= 泛娱乐，转化率低
+- **平均 likes 稳定** = 粉丝忠诚度高
+- **平均 likes 波动大** = 依赖算法推荐，不稳定
+
+### 4. Reel 深度分析 - `scout instagram reel-insights`
+
+**用途**：分析爆款 Reel 的成功要素
+
+```bash
+scout instagram reel-insights "https://instagram.com/reel/ABC123/"
+```
+
+**返回数据**：
+- `reel` - 完整数据（plays, likes, comments, shares）
+- `transcript` - **关键**，视频字幕/语音识别
+- `comments` - Top 评论，提取用户反馈
+
+**分析重点**：
+1. **Transcript 分析**：
+   - 前 3-5 秒说了什么（Hook）
+   - 有无明确的 CTA（call to action）
+   - 教程型 vs 娱乐型
+2. **Comments 分析**：
+   - 正面/负面情感比例
+   - 是否有"Where to buy"等购买意向
+   - 用户标记朋友 = 传播潜力
+3. **互动率**：
+   - likes/plays >5% = 优秀
+   - comments/plays >0.5% = 高互动
+
+## 工作流程
+
+### 流程1：找网红合作
+
+```bash
+# 1. 搜索相关内容，找到活跃创作者
+scout instagram reels "fitness workout" --min-plays 50000 --limit 30
+# 记录高表现创作者的 username
+
+# 2. 分析候选网红的账号
+scout instagram profile @candidate1
+scout instagram profile @candidate2
+# 看 followers, verified, category
+
+# 3. 审查他们的内容质量
+scout instagram creator-reels @candidate1 --limit 30
+# 看内容一致性、平均互动
+
+# 4. 分析他们的爆款内容
+scout instagram reel-insights "https://instagram.com/reel/xxx"
+# 学习他们的内容风格
+
+# 5. 建立合作候选名单
+```
+
+### 流程2：内容策略研究
+
+```bash
+# 1. 找话题下的高表现 Reels
+scout instagram reels "coffee making" --min-plays 100000 --limit 20
+
+# 2. 深入分析前 5 个爆款
+scout instagram reel-insights "reel_url_1"
+scout instagram reel-insights "reel_url_2"
+# ...
+
+# 3. 提取共同模式：
+# - Hook 怎么做的
+# - 视觉风格
+# - 文案长度
+# - 音乐选择（从 URL 访问）
+
+# 4. 应用到自己的内容策略
+```
+
+### 流程3：竞品分析
+
+```bash
+# 1. 分析竞品账号整体情况
+scout instagram profile @competitor
+
+# 2. 获取他们的所有 Reels
+scout instagram creator-reels @competitor --limit 50
+
+# 3. 分析他们的爆款（找 likes 最高的）
+scout instagram reel-insights "竞品爆款 URL"
+
+# 4. 总结他们的策略：
+# - 发布频率（从 reels 时间判断）
+# - 内容类型占比（教程/产品展示/生活方式）
+# - 互动率水平
+
+# 5. 找差异化机会
+```
+
+### 流程4：跨平台对比（Instagram vs TikTok）
+
+```bash
+# 1. Instagram 数据
+scout instagram reels "portable blender" --limit 20
+
+# 2. TikTok 数据（切换到 tiktok skill）
+scout tiktok search-videos "portable blender" --has-product --limit 20
+
+# 3. 对比：
+# - 内容数量（哪个平台更活跃）
+# - 平均互动（哪个平台效果好）
+# - 商业化程度（TikTok 通常更高）
+# - 受众差异（Instagram 更高端/年长）
+
+# 4. 决策内容策略
+```
+
+## 数据解读关键
+
+### 账号质量评分
+
+| 指标 | 优秀 | 良好 | 一般 | 差 |
+|------|------|------|------|-----|
+| followers/following | >10:1 | 5-10:1 | 2-5:1 | <2:1 |
+| verified | ✓ | - | - | - |
+| totalPosts | >500 | 200-500 | 100-200 | <100 |
+| isPrivate | false | - | - | true |
+
+**决策**：
+- verified = true 优先考虑（可信度高）
+- followers/following <2:1 谨慎（可能买粉）
+- totalPosts <100 且 followers >10K = 红旗（可能刷数据）
+- isPrivate = true 无法合作（内容不可见）
+
+### Reel 表现评估
+
+**互动率基准**（如果有 plays 数据）：
+- likes/plays >5% = 优秀
+- likes/plays 3-5% = 良好
+- likes/plays 1-3% = 一般
+- likes/plays <1% = 差
+
+**评论率**：
+- comments/plays >0.5% = 高互动
+- comments/plays 0.2-0.5% = 正常
+- comments/plays <0.2% = 低互动
+
+**没有 plays 数据时**：
+- 看 likes 绝对值，与创作者 followers 对比
+- likes/followers >5% = 优秀
+- likes/followers 2-5% = 良好
+- likes/followers <2% = 一般
+
+### 内容策略判断
+
+**从 creator-reels 结果判断**：
+
+1. **内容类型分布**：
+   - 教程类（caption 长，有步骤）
+   - 产品展示（caption 短，突出视觉）
+   - 生活方式（个人化，情感向）
+
+2. **发布频率**：
+   - 每天 1+ 条 = 高频（需要团队支持）
+   - 每周 3-5 条 = 正常
+   - 每周 <3 条 = 低频（可能兼职）
+
+3. **互动稳定性**：
+   - 标准差小 = 粉丝忠诚，算法稳定
+   - 标准差大 = 依赖单个爆款，不稳定
+
+## Instagram vs TikTok 差异
+
+| 维度 | Instagram | TikTok |
+|------|-----------|--------|
+| 内容风格 | 更精致、高端 | 更真实、接地气 |
+| 受众年龄 | 25-40 岁为主 | 18-30 岁为主 |
+| 商业化 | 品牌合作为主 | 带货链接更直接 |
+| 内容生命周期 | 更长（会被重新推荐） | 更短（趋势性强） |
+| 算法特点 | 看重粉丝关系 | 看重新鲜感 |
+
+**策略建议**：
+- **品牌建设** → Instagram（高端受众，长期价值）
+- **快速带货** → TikTok（年轻受众，冲动消费）
+- **跨平台** → 内容需要调整风格，不能直接搬运
+
+## 重要提醒
+
+1. **plays 数据不总是有**：Instagram 不是所有 Reels 都显示播放数，这很正常
+2. **没有 plays 时用 likes**：用 likes/followers 比例评估表现
+3. **limit 最大 60**：reels 搜索最多返回 60 个结果
+4. **Private 账号**：无法获取内容，合作前确认账号是 public
+5. **跨 Skill 联动**：
+   - Instagram 找网红 → profile 评估 → TikTok 对比
+   - Instagram 发现内容 → scout 验证产品市场 → scout supplier-search 找供应商

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

@@ -33,7 +33,6 @@ Use this skill when:
 
 **Exception - Direct report mode:**
 - User explicitly requests: "给我一份XX市场分析报告"
-- User wants fast results without discussion
 - In this case, skip conversation and generate report directly
 
 ## Quick Start - First Step
@@ -80,11 +79,11 @@ scout search "QUERY" --limit NUMBER
 - Product list with ASIN, title, price, rating, reviews, recent sales
 - Market overview data for competitive analysis
 
-**When to use:**
-- Initial market research
-- Finding product categories or niches
-- Comparing multiple products
-- Identifying market trends
+**Key metrics to analyze:**
+- Price range and distribution
+- Recent sales ("10K+ bought in past month" = high demand)
+- Ratings_total (review count indicates market maturity)
+- Average rating (competitive quality baseline)
 
 ### 2. Get Product Details: `scout product`
 
@@ -104,19 +103,18 @@ scout product ASIN
 - Rating breakdown, BSR, listing quality indicators
 - Feature bullets, images, description, categories
 
-**When to use:**
-- Deep-dive competitor analysis
-- Following up on search results
-- Evaluating specific products
-- Analyzing listing quality
-
 **Key data to extract:**
-- BSR (Best Seller Rank) - Indicates sales volume and market position
-- Rating breakdown - Five-star/one-star percentages reveal satisfaction level
-- Top reviews - Extract user pain points and satisfaction drivers
-- Feature bullets - Identify competitive selling points
-- Images count - Assess listing quality (7 images is standard)
-- Specifications - May include BSR in multiple categories
+- **BSR (Best Seller Rank)** - Sales volume indicator (lower = better)
+  - BSR < 1,000 = very high sales
+  - BSR 1,000-10,000 = good sales
+  - BSR > 50,000 = low sales
+- **Rating breakdown** - Five-star/one-star percentages
+  - 70%+ five-star = excellent satisfaction
+  - 10%+ one-star = quality issues
+- **Top reviews** - User pain points and satisfaction drivers
+- **Feature bullets** - Competitive selling points
+- **Images count** - 7 is standard, fewer = poor optimization
+- **Specifications** - May include BSR in multiple categories
 
 ### 3. Search 1688 Suppliers: `scout supplier-search`
 
@@ -138,23 +136,18 @@ scout supplier-search "KEYWORD" --limit NUMBER --format FORMAT
 - Supplier details: name, location, years in business, seller type (manufacturer vs. trader)
 - Tags: shipping policies (退货包运费), payment terms (先采后付), certifications (实力商家)
 
-**When to use:**
-- After Amazon market research - find potential suppliers for cost analysis
-- User asks about costs, margins, or sourcing
-- Calculating profit margins (Amazon price - 1688 wholesale cost)
-- Identifying manufacturing vs. trading suppliers
-- Before generating final report - include supplier data for complete analysis
-
-**Example:**
-```bash
-scout supplier-search "咖啡机" --limit 10
-```
+**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%)
 
 ## Research Workflow
 
 ### Interactive Research Flow (Recommended):
 
-**Phase 1: Initial Discovery & Discussion (5-10 minutes)**
+**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:
@@ -162,13 +155,10 @@ scout supplier-search "咖啡机" --limit 10
    - "看起来高端保温款竞争少，要不要深入看看这个方向？"
    - "你更关注哪些产品？我可以详细分析"
 
-**Phase 2: Deep Dive & Refinement (10-15 minutes)**
+**Phase 2: Deep Dive & Refinement**
 4. **Targeted Analysis** → Based on user feedback, run `scout product` on relevant ASINs
 5. **Extract Insights** → Share key findings (BSR, reviews, pain points)
-6. **Iterate & Explore** → User may request:
-   - Different keywords
-   - Specific competitor analysis
-   - Alternative product categories
+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:
@@ -187,23 +177,24 @@ scout supplier-search "咖啡机" --limit 10
 10. **Ask**: "要不要我详细分析几个供应商？" or proceed to report
 
 **Phase 3: Report Generation (Proactive Suggestion)**
-7. **Gauge Completion** → After sufficient data gathering, **proactively suggest**:
+11. **Gauge Completion** → After sufficient data gathering, **proactively suggest**:
    - "我已经收集了足够的数据，要不要我整理成一份完整的市场分析报告？"
    - "我可以生成一份详细报告，包括市场规模、竞品分析、进入策略和财务预测"
-8. **Generate Report** → Create comprehensive markdown report with all findings
-9. **Save & Iterate** → Offer to save report and refine based on feedback
+12. **Generate Report** → Create comprehensive markdown report with all findings
+13. **Save & Iterate** → Offer to save report and refine based on feedback
 
 ---
 
-**Alternative: Quick Research Flow**
+### Alternative: Quick Research Flow
 
 When user explicitly requests a report upfront ("给我一份XX市场分析报告"):
 1. Run 3-4 diverse keyword searches
 2. Analyze top 3-5 products with `scout product`
-3. Generate comprehensive report directly
-4. Offer follow-up discussion after report delivery
+3. Search 1688 suppliers for cost analysis
+4. Generate comprehensive report directly
+5. Offer follow-up discussion after report delivery
 
-### Multi-Keyword Research Strategy:
+### Multi-Keyword Research Strategy
 
 **Example: Researching titanium cups**
 ```bash
@@ -219,38 +210,8 @@ scout search "camping titanium" --limit 10
 - Cross-validate market size across searches
 - Discover related products and categories
 
-### Analysis Framework:
-
-When analyzing results, consider:
-
-**Market Viability:**
-- Are there existing products? How many competitors?
-- Price range and average price point
-- Market saturation (high ratings_total = established market)
-- **BSR (Best Seller Rank)** - Key market size indicator
+## Complete Example: Interactive Research Session
 
-**Demand Indicators:**
-- "10K+ bought in past month" = high demand
-- High ratings_total = proven demand
-- Recent sales trends
-- **BSR rank** - Lower BSR = higher sales volume
-
-**Competitive Landscape:**
-- Top products' ratings and review counts
-- Price positioning opportunities
-- Feature gaps or improvement opportunities
-- **Rating breakdown** - Five-star vs one-star percentage
-- **Listing quality** - Images count, feature bullets, A+ content
-
-**Entry Barriers:**
-- Established brands vs. new sellers
-- Average review count of top products
-- Price competition level
-- **Top reviews analysis** - User pain points and satisfaction drivers
-
-## Examples
-
-### Example 1: Business Opportunity Evaluation (Interactive Flow)
 **User**: "我想开个店卖钛合金杯子，你觉得合适吗"
 
 **Assistant Phase 1 - Initial Scan:**
@@ -307,9 +268,31 @@ scout search "titanium tumbler" --limit 10
 
 **Assistant**: "找到了！titanium tumbler 搜索结果更聚焦保温款，竞品只有 5-6 个，价格 $60-110。
 
+**现在帮你查一下 1688 供应商成本，看看利润空间？**"
+
+**User**: "好的"
+
+**Assistant Phase 2.5 - Supplier Sourcing:**
+```bash
+scout supplier-search "钛合金保温杯" --limit 10
+```
+
+**Assistant**: "找到供应商数据：
+- 批发价区间：¥180-450（约 $25-65）
+- 起订量：多数 50-100 个
+- 头部供应商：8年工厂，¥280 批发价，起订 50 个
+
+**利润空间分析：**
+- Amazon 售价：$70-90
+- 1688 批发价：¥280（约 $40）
+- 运费+关税：约 $15
+- 总成本：约 $55
+- 毛利率：约 25-40%
+
 我现在收集了足够的数据：
 - 4 个关键词搜索
 - 5 个产品深度分析
+- 供应商成本分析
 - 明确的市场空白（保温款）
 
 **要不要我把这些整理成一份完整的市场分析报告？可以包括：**
@@ -331,152 +314,89 @@ scout search "titanium tumbler" --limit 10
 
 报告已保存为 `钛合金杯子市场分析报告.md`，需要补充哪些信息吗？"
 
-### Example 2: Market Research
-**User**: "帮我研究一下无线鼠标市场"
-
-**Assistant**:
-```bash
-scout search "wireless mouse" --limit 20
-scout search "gaming mouse wireless" --limit 10
-```
-
-"我看了一下无线鼠标市场：
-- 价格从 $10 到 $150，主流在 $20-40
-- 明显分为三个细分市场：办公轻便型、游戏型、静音型
-- 游戏鼠标竞争最激烈，但价格也最高
-
-你想专注哪个细分？"
+## Competitor Analysis Checklist
 
-**User**: "办公用的静音鼠标"
+When user asks to analyze a specific product (e.g., "帮我分析一下这个产品 B0788F3R8X"), follow this analysis framework:
 
-**Assistant**:
-```bash
-scout search "silent mouse wireless" --limit 15
-scout product [TOP_3_SILENT_MOUSE_ASINS]
-```
-
-"找到了！静音鼠标竞争比游戏鼠标少很多，价格 $15-35。要深入分析吗？"
-
-### Example 3: Quick Product Validation
-**User**: "咖啡机现在好卖吗？"
-
-**Assistant**:
-```bash
-scout search "coffee maker" --limit 15
-```
-
-"咖啡机市场很活跃！
-- 头部产品都是 '10K+ bought in past month'，需求很强
-- 价格 $30-150，主要集中在 $40-80
-- 但竞争也很激烈 - 前 10 名评论数都在 10,000+ 以上
-
-这是成熟市场，有需求但进入难度大。你是想自己做品牌，还是代理现有品牌？"
-
-### Example 4: Competitor Deep-Dive
-**User**: "帮我分析一下这个产品 B0788F3R8X"
-
-**Actions:**
 ```bash
 scout product B0788F3R8X
 ```
 
 **Analysis Checklist:**
-- ✅ **BSR & Market Position**: Check BSR in specifications, estimate sales volume
-- ✅ **Customer Satisfaction**:
+- ✅ **BSR & Market Position**
+  - Check BSR in specifications
+  - Estimate sales volume from BSR
+  - Compare with category averages
+- ✅ **Customer Satisfaction**
   - Rating breakdown (five-star %, one-star %)
   - Total reviews count (market maturity indicator)
-- ✅ **Listing Quality**:
+  - Review trends over time
+- ✅ **Listing Quality**
   - Images count (7 is standard)
   - Feature bullets count and quality
   - Product description completeness
-- ✅ **User Feedback Deep-Dive**:
+  - A+ content presence
+- ✅ **User Feedback Deep-Dive**
   - Top 3 positive mentions (from top_reviews)
   - Top 3 complaints/pain points (from top_reviews)
   - Improvement opportunities
-- ✅ **Competitive Advantages**:
+  - Common feature requests
+- ✅ **Competitive Advantages**
   - Unique selling points in feature_bullets
-  - Price positioning
-  - Brand strength
+  - Price positioning vs. competitors
+  - Brand strength and trust signals
+  - Differentiation factors
 
-### Example 5: Complete Market Research + Supplier Sourcing
-**User**: "我想卖咖啡机，帮我做市场调研"
+## Analysis Framework
 
-**Phase 1 - Amazon Market Research:**
-```bash
-scout search "coffee maker" --limit 15
-scout product B08BHXG144  # Top seller analysis
-```
+### Market Viability Assessment
 
-**Assistant**: "咖啡机市场很活跃：
-- 价格区间：$30-150，主流在 $60-80
-- 头部产品月销 1000+ 件，需求强劲
-- 竞争激烈但市场容量大
+| 指标 | 优秀市场 | 正常市场 | 风险市场 |
+|------|---------|---------|---------|
+| 竞品数量 | 10-50 | 5-10 或 50-100 | <5 或 >100 |
+| 头部产品评论数 | 100-1000 | 50-100 或 1000-5000 | <50 或 >5000 |
+| 价格区间 | 宽（有差异化空间） | 中等 | 窄（价格战） |
+| BSR 范围 | 1K-10K | 10K-50K | >50K |
 
-**现在帮你查一下 1688 供应商成本，看看利润空间**"
+**决策逻辑**：
+- **优秀市场** = 有需求、有空间、竞争适中
+- **正常市场** = 需要差异化或资源投入
+- **风险市场** = 需求不明或红海竞争
 
-**Phase 2 - Supplier Sourcing:**
-```bash
-scout supplier-search "咖啡机" --limit 10
-```
+### Demand Indicators
 
-**Assistant**: "找到供应商数据：
-- 批发价区间：¥120-580（约 $17-80）
-- 起订量：多数 2-10 台
-- 头部供应商：容凯严选工厂，¥429-599，起订 2 台
+**High Demand Signals:**
+- ✅ "10K+ bought in past month" 标签
+- ✅ 多个产品 ratings_total > 500
+- ✅ BSR < 10,000 in category
+- ✅ 搜索结果超过 30 个相关产品
 
-**利润空间分析：**
-- Amazon 售价：$60-80
-- 1688 批发价：¥429（约 $60）
-- 运费+关税：约 $10-15
-- 毛利率：约 15-25%（扣除平台费用后）
+**Low Demand Signals:**
+- ⚠️ 少于 10 个搜索结果
+- ⚠️ 头部产品 ratings_total < 50
+- ⚠️ BSR > 100,000
+- ⚠️ 没有 "bought in past month" 标签
 
-市场有需求，成本可控，利润空间合理。要详细分析吗？"
+### Competitive Landscape
 
-**User**: "好的，生成报告吧"
-
-**Phase 3 - Generate Report with Supplier Data:**
-[Creates comprehensive report including both Amazon market analysis AND 1688 supplier costs]
-
-## Output Format
-
-Commands return structured JSON with product data and metadata. Key fields:
-- **Search**: `results[]` (asin, title, price, rating, ratings_total, recent_sales) + `metadata`
-- **Product**: `data.product` (full details, rating_breakdown, BSR in specifications) + `metadata`
+**进入难度评估：**
 
-## Best Practices
+| 维度 | 容易进入 | 中等难度 | 困难进入 |
+|------|---------|---------|---------|
+| 头部产品评论数 | <200 | 200-2000 | >2000 |
+| 品牌集中度 | 无知名品牌 | 少数品牌 | 大品牌垄断 |
+| 价格竞争 | 差异化定价 | 价格区间宽 | 价格战 |
+| 评分分布 | <4.5 平均分 | 4.5-4.7 | >4.7（难超越） |
 
-### 1. Conversational First, Report Later
-**Principle:** Build understanding through dialogue, then document in report.
+### Report Generation Guidelines
 
-**Why this matters:**
-- Users often don't know exactly what they want initially
-- Early conversation reveals true goals and constraints
-- Interactive exploration uncovers better insights than solo research
-- Report becomes more valuable when it answers user's actual questions
-
-**In practice:**
-- Start with 1-2 quick searches, share highlights (not full data dump)
-- Listen for what user cares about: price sensitivity, time to market, differentiation
-- Adjust research direction based on reactions
-- Think of yourself as a consultant, not a data processor
-
-### 2. Recognize When to Suggest Report
-**Strong signals - Proactively suggest report:**
+**When to suggest report:**
 - ✅ 3+ searches completed with diverse keywords
 - ✅ 3-5 products analyzed in detail (with BSR, reviews, etc.)
-- ✅ User asks synthesizing questions:
-  - "所以你觉得呢？" "值得做吗？" "你的建议是什么？"
-  - "总结一下" "整体怎么样" "帮我分析分析"
-- ✅ Conversation covers core dimensions: market size, competition, pricing, differentiation
+- ✅ User asks synthesizing questions: "所以你觉得呢？" "值得做吗？" "总结一下"
 - ✅ Clear opportunity or risk identified that should be documented
-- ✅ Research session lasted 10-15 minutes (multiple rounds of Q&A)
 
-**Weak signals - Continue exploring:**
-- User still asking specific questions about individual products
-- Only 1-2 searches done, limited data
-- User exploring different categories (still deciding direction)
-
-**How to suggest (Natural & Consultative):**
+**How to suggest report (use this natural template):**
 ```
 "我已经分析了 X 个搜索和 Y 个竞品，发现了一些有意思的模式。
 
@@ -499,97 +419,75 @@ Commands return structured JSON with product data and metadata. Key fields:
 - Continue exploration or answer follow-up questions
 - Offer report again later if more data gathered
 
-### 3. Report Structure & Quality
-**When generating report, include:**
-- **Executive Summary** - 核心结论前置
+**Report must include:**
+- **Executive Summary** - 核心结论前置（适合进入？风险是什么？）
 - **Market Analysis** - 基于搜索数据的市场概况
-- **Competitor Deep-Dive** - 基于 product details 的竞品分析
-  - Must include: BSR, rating breakdown, top reviews insights
+- **Competitor Deep-Dive** - 基于 product details 的竞品分析（BSR, rating breakdown, top reviews insights）
 - **Opportunity Assessment** - SWOT 或机会/挑战分析
 - **Entry Strategy** - 产品定位、定价、差异化策略
 - **Financial Projections** (optional) - 如果用户需要投资决策
-- **Data Appendix** - 关键数据汇总表
+- **Supplier Analysis** (if Phase 2.5 completed) - 1688 供应商、成本、利润空间
 
 **Report naming:**
 - Save as: `{产品类型}市场分析报告.md`
 - Example: `钛合金杯子市场分析报告.md`
 
-### 4. Look for Patterns
-- Common price points across competitors
-- Feature trends in top products
-- Customer pain points in reviews (from top_reviews)
-- Rating breakdown patterns (high five-star vs one-star issues)
-
-### 5. Assess Opportunity
-- High demand (BSR, sales data) + Low competition (ratings count) = Good opportunity
-- High demand + High competition = Difficult but proven market
-- Low demand = Risky
-
-### 6. Present Insights
-- Use user's language (Chinese if they asked in Chinese)
-- Include specific examples and data evidence
-- Provide actionable recommendations
-- Explain reasoning with data
-
-### 7. Iterate & Refine
-- After presenting report, ask: "需要补充哪些信息？"
-- Offer follow-up analysis: "要不要看看相关品类？"
-- Point out data limitations honestly
-
-### 8. Amazon + 1688 Integrated Analysis
-**Principle:** Complete market research includes both demand analysis (Amazon) and supply chain research (1688).
-
-**When to search 1688:**
-- ✅ After identifying promising products on Amazon
-- ✅ User asks about costs, margins, or sourcing
-- ✅ Before generating final report (include supplier data for complete picture)
-- ✅ User explicitly asks about suppliers or wholesale prices
-
-**How to present:**
-- Compare Amazon prices vs. 1688 wholesale costs
-- Calculate rough profit margins (consider shipping, tariffs, platform fees)
-- Highlight MOQ constraints (minimum order quantity)
-- Identify manufacturing vs. trading suppliers (生产加工 vs. 贸易商)
-
-**Example flow:**
-1. Search Amazon → Identify $60-80 price point for coffee makers
-2. Search 1688 → Find ¥429 ($60) wholesale price, MOQ 2 units
-3. Calculate margin → ~20% after fees and shipping
-4. Recommendation → Feasible opportunity with reasonable margins
-
-**Proactive suggestion:**
-After sufficient Amazon research, proactively offer:
-"我已经分析了 Amazon 市场，要不要我帮你查一下 1688 供应商成本，看看利润空间？"
-
-## Tips
-
-**Sales & Demand:**
-- "10K+ bought in past month" = high demand indicator
-- **BSR (Best Seller Rank)**: Lower number = higher sales
-  - BSR < 1,000 in category = very high sales
-  - BSR 1,000-10,000 = good sales
-  - BSR > 50,000 = low sales
-- Compare ratings_total across competitors to gauge market maturity
+## Key Metrics Quick Reference
 
-**Market Entry Assessment:**
-- Lower ratings_total on top results = easier market entry
-- High sales (BSR) + Low reviews = newer market opportunity
-- High sales + High reviews = established but proven market
+**BSR (Best Seller Rank):**
+- < 1,000 = 月销 500+ 件
+- 1,000-10,000 = 月销 100-500 件
+- 10,000-50,000 = 月销 20-100 件
+- > 50,000 = 月销 <20 件
 
-**Customer Satisfaction:**
-- Check rating_breakdown percentages:
-  - 70%+ five-star = excellent satisfaction
-  - 10%+ one-star = quality issues or high expectations
-- Recent reviews often reveal current product issues or trends
-- Top reviews expose pain points and satisfaction drivers
+**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 is Amazon standard - fewer suggests poor optimization
-- 5+ feature bullets with clear benefits
-- A+ content presence indicates professional seller
-
-**Research Strategy:**
-- Use multiple search queries to get complete market view
-- Search related keywords (e.g., "titanium cup" + "titanium mug" + "titanium tumbler")
-- Cross-validate findings across different searches
-- Analyze top 3-5 products in each search for patterns
+- 7 images = 标准
+- 5+ feature bullets = 完整
+- A+ content = 专业卖家
+
+## Cross-Skill Integration
+
+**TikTok/Instagram → Scout → Supplier 完整链路：**
+
+1. **TikTok/Instagram** - 发现趋势产品
+   ```bash
+   scout tiktok trending --has-product
+   # 或
+   scout instagram reels "产品关键词"
+   ```
+
+2. **Scout (Amazon)** - 验证市场需求
+   ```bash
+   scout search "product name" --limit 15
+   scout product <top_asin>
+   ```
+
+3. **Scout (1688)** - 找供应商和成本
+   ```bash
+   scout supplier-search "产品关键词" --limit 10
+   ```
+
+4. **决策** - 综合分析：
+   - TikTok/Instagram 验证内容热度
+   - Amazon 验证购买需求和竞争
+   - 1688 验证供应链和利润空间
+   - 三者都通过 → 值得做
+
+**Proactive suggestion after cross-skill analysis:**
+"我已经分析了：
+- TikTok 内容热度（X 个热门视频）
+- Amazon 市场需求（价格 $Y, BSR Z）
+- 1688 供应商成本（批发价 ¥W，起订 Q 个）
+
+要不要生成一份完整的产品机会分析报告？"

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

@@ -0,0 +1,262 @@
+---
+name: tiktok
+description: TikTok influencer marketing and trend discovery. Use when user needs to find TikTok creators (TikTok网红/达人/创作者), discover viral products (爆款/热销/带货), analyze trending videos (热门视频/趋势), research hashtags (话题/标签/#), or competitive analysis (竞品/对手分析).
+---
+
+# TikTok - Influencer Marketing & Trend Discovery
+
+## 典型场景
+
+当用户说：
+- "帮我找TikTok网红" / "找美妆博主" → `scout tiktok creators`
+- "TikTok上什么产品火" / "最近有什么爆款" → `scout tiktok trending --has-product`
+- "搜索XX相关的视频" → `scout tiktok search-videos "XX"`
+- "这个视频数据怎么样" + URL → `scout tiktok video-insights <url>`
+- "TikTok热门话题" / "有什么热门标签" → `scout tiktok hashtags`
+- "看看XX网红推广什么产品" → `scout tiktok creator-products @username`
+
+### 场景决策表
+
+| 用户需求 | 推荐命令 | 关键参数 |
+|---------|---------|---------|
+| 找网红合作 | `tiktok creators` | `--follower-count` 筛选粉丝规模，`--sort engagement_rate` 按互动率排序 |
+| 发现爆款产品 | `tiktok trending --has-product` | `--region` 指定市场，`--time-period 7d` 近期趋势 |
+| 研究产品热度 | `tiktok search-videos "产品名" --has-product` | 找带货视频，验证商业化程度 |
+| 分析爆款视频 | `tiktok video-insights <url>` | 获取字幕和评论，分析成功要素 |
+| 内容策略研究 | `tiktok hashtags` | 找热门话题，结合搜索视频看内容格式 |
+| 竞品分析 | `tiktok search-videos "品牌名"` | 找竞品推广视频，分析营销策略 |
+
+## 核心命令
+
+### 1. 查找创作者 - `scout tiktok creators`
+
+**用途**：找网红合作，按粉丝数和互动率筛选
+
+```bash
+# 找中等规模高互动网红（最适合合作）
+scout tiktok creators --follower-count "100K-1M" --sort engagement_rate --limit 20
+
+# 找大V网红
+scout tiktok creators --follower-count "1M-10M" --country US --limit 10
+
+# 按地区和受众筛选
+scout tiktok creators --country GB --audience-country US --limit 20
+```
+
+**返回数据**：
+- `username`, `displayName` - 账号信息
+- `followers`, `totalVideos`, `totalLikes` - 规模指标
+- `engagementRate` - **最重要**，衡量粉丝活跃度
+- `avgViews` - 平均播放量
+- `verified` - 认证状态
+- `profileUrl` - 主页链接
+
+**关键指标**：
+- **互动率 >5%** = 优质网红（粉丝活跃）
+- **互动率 2-5%** = 正常水平
+- **互动率 <2%** = 粉丝质量差或僵尸粉
+- **avgViews / followers > 1** = 内容质量好，算法推荐多
+
+### 2. 热门视频 - `scout tiktok trending`
+
+**用途**：发现正在火的产品和内容
+
+```bash
+# 找美国近7天的热门带货视频
+scout tiktok trending --region US --time-period 7d --has-product --limit 20
+
+# 找英国24小时内爆火内容
+scout tiktok trending --region GB --time-period 24h --limit 30
+```
+
+**返回数据**：
+- `views`, `likes`, `comments`, `shares` - 互动数据
+- `productUrl` - 产品链接（如果有）
+- `description` - 视频文案
+- `creator` - 创作者信息
+
+**分析逻辑**：
+- **多个视频推同一产品** = 趋势信号强
+- **评论问"哪里买"** = 购买意向高
+- **likes/views >5%** = 内容质量好
+- **有 productUrl** = 已商业化，市场验证
+
+### 3. 搜索视频 - `scout tiktok search-videos`
+
+**用途**：研究特定产品/话题的视频
+
+```bash
+# 找咖啡机相关的所有视频
+scout tiktok search-videos "coffee maker" --limit 30
+
+# 只找带货视频（验证商业化）
+scout tiktok search-videos "coffee maker" --has-product --limit 20
+```
+
+**--has-product 参数的意义**：
+- 有产品链接 = 已经有人在卖 = 市场验证
+- 如果搜到很多带货视频 = 竞争激烈
+- 如果只有几个带货视频 = 机会窗口
+
+### 4. 视频深度分析 - `scout tiktok video-insights`
+
+**用途**：分析爆款视频的成功要素
+
+```bash
+scout tiktok video-insights "https://tiktok.com/@user/video/123456789"
+```
+
+**返回数据**：
+- `video` - 完整数据（views, likes, comments, shares）
+- `transcript` - **关键**，视频字幕，分析 Hook 和文案
+- `comments` - 用户评论，提取情感和购买意向
+
+**分析重点**：
+1. **Transcript 前 3 秒** - 开头 Hook 是什么
+2. **Comments 里的高频词** - "where to buy", "I need this" = 强购买意向
+3. **Likes/Views 比例** - >5% 是优秀内容
+4. **Shares** - 高分享 = 传播性强
+
+### 5. 热门话题 - `scout tiktok hashtags`
+
+**用途**：找热门话题，优化内容策略
+
+```bash
+scout tiktok hashtags --region US --limit 30
+```
+
+**返回数据**：
+- `name` - 话题名称
+- `views` - 浏览量（>10B = 超级热门）
+- `trending` - 是否正在趋势中
+
+**使用建议**：
+- 浏览量 >10B = 主流话题，竞争激烈
+- 浏览量 1-10B = 细分话题，精准流量
+- `trending: true` = 正在爆发，时效性强
+
+### 6. 创作者产品提取 - `scout tiktok creator-products`
+
+**用途**：看某个网红推广什么产品
+
+```bash
+scout tiktok creator-products @username --sort popular --limit 30
+```
+
+**返回数据**：
+- `products` - 产品URL列表
+- `fromVideo` - 产品出现在哪个视频，视频表现如何
+
+**分析用途**：
+1. **找网红前** - 看他推广过什么，判断品类契合度
+2. **竞品分析** - 看竞品找了哪些网红
+3. **产品验证** - 如果多个网红都推同一产品 = 供应商可靠或产品好卖
+
+## 工作流程
+
+### 流程1：发现爆款产品 → 验证 → 采购
+
+```bash
+# 1. 发现趋势产品
+scout tiktok trending --region US --has-product --time-period 7d --limit 20
+
+# 2. 深入分析爆款视频（选播放量最高的）
+scout tiktok video-insights "https://tiktok.com/video/xxx"
+# 看评论是否有强购买意向，transcript 看卖点
+
+# 3. 验证 Amazon 市场（切换到 scout skill）
+scout search "product name" --limit 10
+# 看市场规模、竞争、价格区间
+
+# 4. 找 1688 供应商（使用 scout 的 supplier-search 命令）
+scout supplier-search "产品关键词" --limit 10
+# 计算利润空间
+```
+
+### 流程2：网红营销选号
+
+```bash
+# 1. 找目标粉丝规模的网红
+scout tiktok creators --follower-count "100K-1M" --sort engagement_rate --limit 20
+
+# 2. 看他们推广过什么（判断品类契合度）
+scout tiktok creator-products @top_creator_1 --limit 30
+scout tiktok creator-products @top_creator_2 --limit 30
+
+# 3. 分析他们的爆款视频（学习内容风格）
+scout tiktok video-insights "https://tiktok.com/video/xxx"
+
+# 4. 建立候选名单，联系合作
+```
+
+### 流程3：竞品分析
+
+```bash
+# 1. 搜索竞品品牌名
+scout tiktok search-videos "competitor brand" --limit 30
+
+# 2. 找到他们的推广视频，分析内容策略
+scout tiktok video-insights "竞品视频URL"
+
+# 3. 提取他们合作的网红
+# 从搜索结果中记录 creator usernames
+
+# 4. 分析他们的网红选择策略
+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 性价比最高
+- 看 totalVideos，少于 50 可能是新号或不稳定
+
+### 视频表现判断
+
+**互动率**：
+- Likes/Views >5% = 优秀
+- Likes/Views 3-5% = 良好
+- Likes/Views <3% = 一般
+
+**评论率**：
+- Comments/Views >0.5% = 高互动
+- Comments/Views <0.2% = 低互动
+
+**购买意向信号（从 comments）**：
+- "Where to buy" / "Link?" = 强购买意向
+- "I need this" / "Ordering now" = 已转化
+- "@朋友" 标记 = 传播潜力
+
+### 产品趋势判断
+
+**强趋势信号**：
+- ✅ trending 中有 3+ 个视频推同一产品
+- ✅ 搜索该产品，有 10+ 个带货视频
+- ✅ 评论区高频询问购买链接
+- ✅ Amazon 有对应产品且评论数 >100
+
+**弱信号/风险**：
+- ⚠️ 只有 1-2 个视频，可能是偶然
+- ⚠️ 评论区负面反馈多
+- ⚠️ Amazon 没有对应产品（难转化）
+- ⚠️ 视频播放高但无产品链接（纯内容向，不好变现）
+
+## 重要提醒
+
+1. **Region 很重要**：美国和英国的趋势完全不同，务必指定 `--region` 匹配目标市场
+2. **Time Period 选择**：
+   - `24h` - 抓最新趋势，但可能是昙花一现
+   - `7d` - 稳定趋势，最推荐
+   - `30d` - 长期趋势，但可能已经过时
+3. **--has-product 筛选**：找产品机会必须加这个参数，否则很多纯内容向视频
+4. **Engagement Rate > Follower Count**：小网红高互动比大V低互动效果好
+5. **跨 Skill 联动**：TikTok 发现趋势 → scout 验证市场 → scout supplier-search 找供应商，这是完整链路

package/package.json

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