name: category-landscape description: 品类全景分析，计算CR5/HHI市场集中度，生成风险预警汇总和优先行动清单，输出《品类认知校准表》 version: 1.3.0

author: nkkj-BrainHack

品类格局分析 (Category Landscape Analysis)

技能名称

category-landscape

技能目的

品类全景分析，计算CR5/HHI市场集中度，生成风险预警汇总和优先行动清单，输出《品类认知校准表》。

输入参数

参数	类型	必填	说明
keywords	string[]	是	品类核心关键词列表（如 ["reed diffuser", "aroma diffuser"]）
domain	integer	否	Amazon站点，默认1（美国站）
topN	integer	否	分析的产品数量，默认100

执行流程

对每个关键词调用 product-search 搜索 Top N 产品
批量调用 asin-sales-volume 获取各产品月销量
调用 category-tree 定位品类类目ID
调用 keyword-search 获取核心关键词搜索量和竞争度
调用 keyword-search-trend 获取关键词趋势（判断品类增长/衰退）
数据计算：
- CR5: 前5品牌销售额占品类总销售额的比例
- HHI: 赫芬达尔-赫希曼指数（各品牌市场份额平方和 × 10000）
- 市场规模: 品类月销量总和、月销售额总和
- 价格带分布: 按价格区间统计产品数量和销量占比
- 品牌集中度: Top 10 品牌的市场份额
- 评分分布: 品类整体评分水平
- 增长判断: 基于搜索趋势判断品类处于增长/成熟/衰退期
风险预警汇总（新增）：
- 品牌集中度风险 / 低销量风险 / 评分风险 / 价格战风险 / 库存风险 / 合规风险
- 每项风险标注级别(high/medium/low)和具体描述
优先行动清单（新增）：
- 条件触发式优先级: Listing优化→SKU聚焦→促销→产品迭代→库存→差异化
输出《品类认知校准表》

调用的底层 Skill

voc/product-search — 产品搜索
voc/asin-sales-volume — 销量数据
voc/category-tree — 类目定位
voc/keyword-search — 关键词搜索量
voc/keyword-search-trend — 关键词趋势

返回格式

{
  "marketOverview": {
    "totalProducts": 100,
    "totalMonthlySales": 125000,
    "totalMonthlyRevenue": 3750000,
    "avgPrice": 30.0,
    "medianPrice": 27.99,
    "avgRating": 4.3,
    "categoryStage": "成长期"
  },
  "concentration": {
    "cr5": 35.2,
    "cr10": 52.8,
    "hhi": 850,
    "interpretation": "品类集中度较低，市场分散，新品牌有进入机会"
  },
  "topBrands": [
    { "brand": "NEST", "marketShare": 12.5, "productCount": 8, "avgPrice": 42.00, "avgRating": 4.6 },
    { "brand": "Paddywax", "marketShare": 8.3, "productCount": 6, "avgPrice": 28.00, "avgRating": 4.4 }
  ],
  "priceBands": [
    { "range": "$10-$20", "productCount": 20, "salesShare": 15, "avgRating": 4.0 },
    { "range": "$20-$30", "productCount": 35, "salesShare": 40, "avgRating": 4.3 },
    { "range": "$30-$50", "productCount": 30, "salesShare": 35, "avgRating": 4.5 },
    { "range": "$50+", "productCount": 15, "salesShare": 10, "avgRating": 4.6 }
  ],
  "searchTrend": {
    "mainKeyword": "reed diffuser",
    "monthlySearchVolume": 45000,
    "trendDirection": "rising",
    "growthRate": 18.5
  },
  "calibrationTable": "| 指标 | 数值 | 解读 |\n|------|------|------|\n| CR5 | 35.2% | 集中度低，竞争分散 |\n| HHI | 850 | 非垄断市场 |\n| ...",
  "riskAlerts": [
    { "level": "medium", "title": "价格战风险", "description": "低价带产品占比20%且增速快，可能引发价格战" },
    { "level": "low", "title": "品牌集中度低", "description": "CR5=35.2%，市场分散，新品牌有进入机会但竞争激烈" }
  ],
  "priorityActions": [
    { "action": "优化Listing关键词布局", "priority": 1, "trigger": "品类增长期+搜索量上升" },
    { "action": "聚焦黄金价格带SKU", "priority": 2, "trigger": "黄金带销量占比>35%" },
    { "action": "设置多件折扣替代降价", "priority": 3, "trigger": "价格战风险检测" }
  ]
}

核心业务场景

品类认知校准表生成（CR5/HHI + 价格带分布 + 增长趋势 → 报告直接可用）
市场规模量化（月销量总和 × 均价 = 品类月销售额）
风险预警汇总（价格战风险/集中度风险/增长衰退风险自动检测）

依赖

Amazon VOC API: https://server.fmode.cn/api/voc-ecom/forward（统一转发，认证已内置）
内置 CR5/HHI 集中度算法 + 价格带五分位划分

工作坊记忆集成

当处于 VOC 工作坊流程中时，本技能支持从记忆文件自动读取参数：

参数	记忆来源	字段路径
keywords	`memory/brand-context.json`	`.categoryKeywords`
domain	`memory/brand-context.json`	`.amazonDomain`

执行完毕后，将完整输出写入 memory/stage-1-output.json（v2 schema），需填充：

categoryLandscape.marketOverview — 市场规模全量指标
categoryLandscape.concentration — CR5/CR10/HHI + topBrands
categoryLandscape.priceBands — 价格带分布 + 黄金价格带 + 空白机会
categoryLandscape.searchTrend — 搜索趋势 + 季节性 + YoY增长
categoryLandscape.competitiveLandscape — 进入壁垒/成熟度/FBA率/视频率/A+率
categoryLandscape.healthScore — 四维健康度评分(0-100)
categoryLandscape.riskAlerts — 风险预警列表
categoryLandscape.priorityActions — 优先行动建议

同时更新 memory/workshop-progress.json 中 session-1.status = "completed"。

参考规范：workshop/voc-report-schema-spec.md Stage 1 章节。

对应工作坊环节

Day1 上午 09:00-12:00「教虾认品类」— 输出《品类健康度评分》+《品类认知校准表》

SKILL.md 5.8 KB 永久連結 文件歷史 原始文件