@optima-chat/optima-agent 0.9.35 → 0.9.37

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

@@ -232,6 +232,7 @@ scout search "open ear earbuds" --limit 15 --format json > /tmp/scout-result.jso
 用户可随时要求生成报告，保存到 `~/products/{slug}/reports/YYYY-MM-DD-{标题}.md`。
 
 报告类型对齐 IPD 交付物：
+- 市场管理(MM) → 品类分析报告
 - 概念阶段 → 产品立项书
 - 计划阶段 → 商业计划书
 - 开发阶段 → 产品规格书 + 供应商评估报告

package/.claude/skills/scout/references/concept.md

@@ -38,26 +38,36 @@
 
 ---
 
-### 2. Amazon 市场扫描
+### 2. Amazon 市场全景扫描
 
-**目的**：确认站内是否存在市场
+**目的**：全面了解市场，不遗漏重要竞品和子品类
 
-**具体命令**：
-- `scout search "主词" --limit 15`
-- 至少 2-3 组关键词覆盖主要同义词
+**步骤 A — 广度搜索（必须）**：
+- `scout search "主词" --limit 50`（拉满 50 条）
+- 至少 2-3 组关键词，每组 50 条，去重后应覆盖 30-100 个不重复 ASIN
+- `scout sp keywords-mine "关键词"` 获取精确月搜索量和转化率
+
+**步骤 B — 竞品全景补充（推荐）**：
+- 从搜索结果中选 1 个头部 ASIN，执行 `scout sp competitors <ASIN>` 拉取竞品列表（可获得更多竞品的销量/销额/利润数据）
+- 目标：覆盖该品类的 **Top 30-50 个竞品**，避免遗漏大品牌（如 JOYIN、Anker 等在搜索结果中可能排名靠后但实际份额很大）
+
+**步骤 C — 子品类聚类（必须）**：
+- 对搜索到的所有产品按**产品形态/功能/使用场景**做子品类分类
+- 不要只分 2-3 大类，要尽可能细分（目标 5-10 个子品类标签）
+- 示例：3D打印玩具 → 龙蛋、动物、蛇、齿轮球、螺旋锥、爪刀、手枪、动作人偶、解压感官...
+- 每个子品类标注：产品数量、价格区间、头部评论数、增长信号
+- **子品类聚类是发现细分机会的关键步骤，不能跳过**
 
 **分析要点**：
-- 产品数量（市场容量）
-- 价格分布（高/中/低档位占比）
-- 评分分布（平均星级、低分占比）
+- 市场总容量（产品总数 + 月总销量估算）
+- 价格分布（高/中/低档位各占多少）
+- 子品类分布（哪个子品类最大？哪个增长最快？哪个竞争最小？）
+- 品牌分布（有无大品牌垄断？中国卖家占比？）
 - "bought in past month" 频率（需求热度）
-- 品牌重复度（垄断程度）
 
 **落盘位置**：`data/searches/{date}-{keyword}.json` → 更新 `INDEX.md` + `market/MARKET.md`
 
-**可选补充**：`scout sp keywords-mine "关键词"` 获取精确月搜索量、PPC 竞价和转化率，比搜索结果中的 "bought in past month" 更精确
-
-**完成标准**：2-3 组关键词搜索覆盖主要同义词
+**完成标准**：覆盖 30+ 个不重复竞品，识别出 5+ 个子品类并标注各自规模
 
 ---
 
@@ -84,19 +94,23 @@
 
 ### 4. 竞争格局
 
-**目的**：初步判断竞争强度
+**目的**：全面判断竞争强度和竞争者构成
 
 **分析要点**：
-- 竞品总数
+- 竞品总数（步骤 2 全景扫描已获得）
 - 头部产品评论数（评论数越多 = 护城河越深）
-- 品牌垄断情况（前 10 名是否被 2-3 个品牌占据）
-- 品牌集中度（CR3/CR5）
-- 可选：`scout sp category "关键词"` 查类目 nodeIdPath，然后 `scout sp brands <nodeIdPath>` 获取量化的品牌集中度数据（各品牌 ASIN 数、销量份额、销额份额）
+- 品牌分布：
+  - `scout sp category "关键词"` → `scout sp brands <nodeIdPath>` 获取量化品牌集中度（CR3/CR5、各品牌 ASIN 数/销量份额/销额份额）
+  - 识别是否有本土大品牌（如 JOYIN、Crayola）占据显著份额
+- 卖家构成：
+  - `scout sp seller-countries <nodeIdPath>` 获取卖家国籍分布（中国卖家占比多少？有无本土卖家壁垒？）
+  - `scout sp seller-types <nodeIdPath>` 获取 FBA/FBM/Amazon 自营占比
+- 子品类竞争差异（步骤 2 聚类结果）：哪个子品类竞争最激烈？哪个最空白？
 - 参考 `metrics.md` 竞争指标表
 
 **落盘位置**：更新 `market/MARKET.md` 竞争格局部分
 
-**完成标准**：知道竞品数量、头部评论数、是否品牌垄断
+**完成标准**：知道竞品总数、品牌集中度（量化）、卖家国籍分布、各子品类竞争强度
 
 ---
 

package/.claude/skills/scout/references/market-management.md

@@ -94,7 +94,21 @@ scout tiktok search-videos "品类关键词"
 
 ---
 
-### 6. 立项触发
+### 6. 生成品类分析报告
+
+**生成品类分析报告**，保存到 `~/products/reports/YYYY-MM-DD-品类分析报告.md`。
+
+必含章节：
+- 扫描范围（评估了哪些品类方向）
+- 各品类 SPAN 评分（市场吸引力 + 竞争地位）
+- 优先级排序结果（P1/P2/P3/放弃）及理由
+- 与 PROFILE.md 的匹配度分析
+- CBB 复用度评估
+- 最终选择的方向和下一步行动
+
+---
+
+### 7. 立项触发
 
 **P1 机会 → 发起概念阶段：**
 - 从 ROADMAP.md 选取 P1 机会

package/.claude/skills/scout/references/planning.md

@@ -15,28 +15,40 @@
 
 **目的**：全面掌握竞争格局，为后续分析建立数据基础
 
-**具体命令**：
-- `scout product ASIN`（对每个竞品逐一执行）
-
-**选品策略**：选 TOP 3-5 竞品
+**选品策略**：从概念阶段全景扫描的 30-50 个竞品中，选 **5-8 个**做深度分析：
 - BSR 最低 2-3 个（品类领导者）
 - 增长最快 1-2 个（新锐挑战者）
 - 定位接近 1-2 个（直接竞争对手）
+- 每个重点子品类至少选 1 个代表
 
-**分析要点**：
-- 定价策略（原价、促销价、优惠券）
-- BSR 排名及品类层级
-- 评分分布（星级比例、评论总数）
-- Feature Bullets 卖点提炼
-- 图片数量与质量
-- A+ 页面有无及质量
-- 变体布局（颜色/尺寸/套装）
+**步骤 A — 产品详情**：
+- `scout product ASIN`（对每个竞品逐一执行）
+- 分析要点：定价策略（原价/促销/Coupon）、评分分布、Feature Bullets、图片数量与质量、A+ 页面、视频、变体布局
+
+**步骤 B — 流量关键词**：
+- `scout sp keywords <ASIN>` 反查竞品流量关键词（含搜索量、竞价、自然排名、广告排名）
+- 分析要点：广告词数量（badges 含 "ads"）、自然排名 vs 广告排名差异、流量集中度
+
+**步骤 C — 历史销量与季节性**（关键！概念阶段缺失的数据）：
+- `scout sp predict <ASIN>` 获取 14 个月销量预测数据
+- 对 5-8 个竞品都拉取，识别**季节性规律**（如复活节/黑五/圣诞波峰）
+- 分析要点：
+  - 月销量是否有明显的季节波峰？
+  - 波峰出现在哪个月？（决定上架时间）
+  - 淡季 vs 旺季销量差多少倍？（影响备货策略）
+  - 销量是增长趋势还是下降趋势？
+
+**步骤 D — Listing 能力矩阵**：
+- 对每个竞品记录以下能力项（从 `scout product` 结果提取）：
+
+| ASIN | A+ | 视频 | 图片数 | Bullets 质量 | 品牌注册 | Coupon/促销 |
+|------|----|----|-------|------------|---------|-----------|
 
-**推荐补充**：`scout sp keywords <ASIN>` 反查竞品流量关键词（含搜索量、竞价、自然排名、广告排名），了解竞品的流量结构
+- 这张表反映竞品的运营成熟度，A+ 和视频覆盖率高 = 竞争壁垒高
 
-**落盘位置**：`data/products/{ASIN}.json` → 更新 `INDEX.md` + `competitors/COMPETITORS.md`
+**落盘位置**：`data/products/{ASIN}.json` + `data/sellersprite/{ASIN}-predict.json` → 更新 `INDEX.md` + `competitors/COMPETITORS.md`
 
-**完成标准**：3-5 个竞品有完整数据
+**完成标准**：5-8 个竞品有完整数据（产品详情 + 流量关键词 + 历史销量 + Listing 能力）
 
 **竞品分析 Checklist（对每个竞品逐项检查）：**
 - ✅ BSR 和品类排名 — 估算销量

package/.claude/skills/scout/template/product/RESEARCH.md

@@ -17,17 +17,19 @@
 
 ### 概念阶段（产品立项书）
 - [ ] 趋势扫描（TikTok/Reddit/Twitter/Web Search 发现热度信号）
-- [ ] Amazon 市场扫描（关键词搜索覆盖）
-- [ ] 需求验证（月搜索量、BSR drops 估算月销）
-- [ ] 竞争格局（竞品数量、头部评论数、品牌集中度）
+- [ ] Amazon 市场全景扫描（多关键词 ×50 条 + 竞品补充，覆盖 30+ 竞品）
+- [ ] 子品类聚类（识别 5+ 子品类，标注各自规模和竞争度）
+- [ ] 需求验证（精确月搜索量、购买量、转化率）
+- [ ] 竞争格局（品牌集中度、卖家国籍分布、各子品类竞争强度）
 - [ ] SPAN 初步定位（市场吸引力 + 竞争地位）
 - [ ] 初步利润估算（毛利率 > PROFILE 最低毛利率?）
 - [ ] IP/合规初筛（商标、专利、认证要求）
 - **CDCP Gate**: 市场够大？利润够高？竞争可打？无 IP 风险？
 
 ### 计划阶段（商业计划书）
-- [ ] 头部竞品深挖（TOP 3-5 产品详情）
-- [ ] $APPEALS 竞品评分（TOP 3-5 竞品 8 维度打分）
+- [ ] 头部竞品深挖（5-8 个，含产品详情 + 流量关键词 + Listing 能力矩阵）
+- [ ] 历史销量与季节性分析（14 个月销量数据，识别波峰波谷）
+- [ ] $APPEALS 竞品评分（TOP 5 竞品 8 维度打分）
 - [ ] 用户痛点挖掘（差评聚类 → 差异化方向）
 - [ ] 历史趋势分析（Keepa BSR/价格/卖家数 → 生命周期判断）
 - [ ] 差异化策略（基于 $APPEALS 缺口确定产品定位）

package/.claude/skills/scout/template/product/competitors/COMPETITORS.md

@@ -18,9 +18,16 @@
 | L 生命周期成本 | | | | | |
 | S 社会接受度 | | | | | |
 
-## Listing 质量对比
-| ASIN | 图片数 | A+ | 视频 | Bullets 质量 | 优化空间 |
-|------|--------|----|----- |------------|---------|
+## Listing 能力矩阵
+| ASIN | 图片数 | A+ | 视频 | Bullets 质量 | 品牌注册 | Coupon/促销 | 优化空间 |
+|------|--------|----|----- |------------|---------|-----------|---------|
+
+## 季节性分析（14 个月历史销量）
+
+| ASIN | 产品名 | 波峰月份 | 波谷月份 | 旺季/淡季倍数 | 趋势方向 |
+|------|--------|---------|---------|-------------|---------|
+
+{基于 scout sp predict 数据，分析季节规律和最佳上架时间}
 
 ## 差异化机会总结
-{基于 $APPEALS 缺口 + 差评痛点，用户最在乎但竞品最弱的交叉维度}
+{基于 $APPEALS 缺口 + 差评痛点 + 子品类空白，用户最在乎但竞品最弱的交叉维度}

package/.claude/skills/scout/template/product/market/MARKET.md

@@ -15,11 +15,17 @@
 - BSR 分布:
 - 季节性:
 
+## 子品类分布
+
+| 子品类 | 产品数 | 价格区间 | 头部评论数 | 增长信号 | 竞争度 |
+|--------|--------|---------|-----------|---------|--------|
+
 ## 竞争格局
 - 竞品总数:
 - 头部品牌:
-- 平均评论数:
-- 品牌集中度:
+- 品牌集中度 (CR3/CR5):
+- 卖家国籍分布:
+- FBA/FBM 占比:
 
 ## SPAN 初步评分
 - 市场吸引力: /5

package/package.json

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