ahang1598 亚马逊前台搜索市场格局分析
输入一个关键词，用 linkfox-amazon-search 搜默认相关性排序的 首页或前 3 页，去广告并重算自然位后，再用 linkfox-keepa-product-request（history=1）批量补充深度字段，固定跑完整链路：
- 38 维市场格局 + 升级版新品清单
- 类目上下文画像（买家看标题 vs 主图各关心什么）
- 每条 ASIN 增强（title / imageUrl 结构化 + 对比维取值 + Keepa 字段）
- 三交付：HTML 报告 + 增强 JSON / 动态对比表
双数据源：SERP 提供搜索位次与基础字段；Keepa 补充品牌/卖家/BSR/利润/上架时间/12月销量趋势。
核心特点
- 双数据源：
linkfox-amazon-search（SERP）+linkfox-keepa-product-request（深度字段） - 38 维分析：竞争格局 15 维 + 进入门槛 13 维 + 趋势与生命周期 10 维
- Keepa 降级：Keepa 不可用时自动降级为纯 SERP 6 段分析
- 自然位重算：
position为页内相对名次；按 page 顺序去广告后连续编号organic_rank - 月销缺失规则：
monthlySalesUnits缺失记为 50；revenue 缺失用50 × extractedPrice估算 - 广告过滤：分析基于自然结果，不含
sponsored: true - 标题/主图必做：按类目生成 context_profile，增强每个 ASIN，输出代码 + 表格
参数概览
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
| keyword | string | 是 | 搜索关键词（需翻译为目标站点语言） | - |
| amazonDomain | string | 是 | 亚马逊站点域名（如 amazon.com） | - |
| language | string | 否 | 语言代码 | 按 amazonDomain 推断 |
| keepaDomain | string | 否 | Keepa 站点 ID | 按 amazonDomain 映射 |
站点映射：amazon.com→en_US（keepa 1），amazon.co.uk→en_GB（keepa 2），amazon.de→de_DE（keepa 3），amazon.fr→fr_FR（keepa 4），amazon.co.jp→ja_JP（keepa 5），amazon.ca→en_CA（keepa 6），amazon.it→it_IT（keepa 8），amazon.es→es_ES（keepa 9）。
用户未指定站点时，用 AskUserQuestion 询问。
工作流程（固定全流程，不拆路由）
Step 1 — 拉前台搜索
sort: "relevanceblender"。前 3 页并行（各 15 积分，共 45 积分）。
Step 2 — 合并、去广告、重算 organic_rank
按 page 顺序、页内 position 升序、跳过 sponsored、连续编号、ASIN 去重。
Step 3 — Keepa 批量补充（~540 积分）
python scripts/batch_keepa_fetch.py <merged_products.json> --domain <keepa_domain_id> [--inline]
按 5 个一批调用 Keepa API（history=1），补充品牌/卖家/BSR/利润/上架时间/12月销量趋势等字段。24h 本地缓存。
降级：Keepa 不可用时跳过，后续使用纯 SERP 数据。
Step 4 — 合并 SERP + Keepa
按 ASIN 合并，Keepa 字段平铺到产品对象。价格/月销优先用 SERP。
Step 5 — 类目上下文画像 + ASIN 增强
生成 context_profile + enrichment（含 keepa_available 标记）。
Step 6 — 运行 38 段聚合脚本
python scripts/aggregate_competition.py <merged_with_keepa.json> [--inline] [--fixed-buckets] [--buckets <file.json>]
Step 7 — 交付（HTML + JSON + 对比表）
调用 linkfox-report-generator 生成 HTML，增强 JSON 和对比表落盘 data 目录。
38 段定义
A. 竞争格局（15 维）
| # | 名称 | 图表 | 数据源 | 商业含义 |
|---|---|---|---|---|
| 1 | 页流量占比 | 表/柱 | SERP | 首页是否垄断流量 |
| 2 | 自然位集中度 | 帕累托 | SERP | 头部垄断还是长尾分散 |
| 3 | 价格分布 | 柱+线双Y | SERP+Keepa | 货与量是否同价带 |
| 4 | 评分数分布 | 柱+线双Y | SERP | 评论门槛 |
| 5 | 评分分布 | 柱+线双Y | SERP | 星级是否拉开差距 |
| 6 | 变体覆盖 | 纯KPI | SERP+Keepa | 多变体链接占比 |
| 7 | 品牌集中度 | 表/饼 | Keepa | 品牌 ASIN 数占比 |
| 8 | 品牌销量份额 | 表/饼 | Keepa | 品牌销量占比 |
| 9 | 头部品牌垄断系数 | 纯KPI | Keepa | CR3/CR5 |
| 10 | 卖家集中度 | 表/饼 | Keepa | 卖家 ASIN 数占比 |
| 11 | 配送方式占比 | 饼 | Keepa | FBA/FBM/AMZ 占比 |
| 12 | 变体复杂度分布 | 柱 | Keepa | 变体数量分桶 |
| 13 | 卖家数量分布 | 柱 | Keepa | 卖家数分桶 |
| 14 | 多卖家竞争占比 | 纯KPI | Keepa | sellerNum>1 占比 |
| 15 | 类目分布 | 表 | Keepa | 子类目聚合 |
B. 进入门槛（13 维）
| # | 名称 | 图表 | 数据源 | 商业含义 |
|---|---|---|---|---|
| 16 | 评论门槛(Top10) | 纯KPI | ratings | Top10 平均评分数 |
| 17 | 评论中位数 | 纯KPI | ratings | 评分数中位数 |
| 18 | 新品评论增长速度 | 散点 | ratings/availableDate | 月均评论增长 |
| 19 | 价格门槛 | 纯KPI | extractedPrice | P25/P50/P75 |
| 20 | BSR门槛(Top10) | 纯KPI | Keepa salesRank | Top10 平均 BSR |
| 21 | BSR中位数 | 纯KPI | Keepa salesRank | BSR 中位数 |
| 22 | 利润率分布 | 柱 | Keepa profit | 利润率分桶 |
| 23 | FBA费用分布 | 柱 | Keepa fbaFees | FBA 费用分桶 |
| 24 | 佣金率分布 | 柱 | Keepa referralFeePercentage | 佣金率分布 |
| 25 | 危险品占比 | 纯KPI | Keepa isHazmat | 危险品占比 |
| 26 | 成人产品占比 | 纯KPI | Keepa isAdultProduct | 成人产品占比 |
| 27 | 上架时间分布 | 柱 | Keepa availableDate | 按上架月数分桶 |
| 28 | 新品占比 | 纯KPI | Keepa availableDate | 上架<6月占比 |
C. 趋势与生命周期（10 维）
| # | 名称 | 图表 | 数据源 | 商业含义 |
|---|---|---|---|---|
| 29 | 月销量趋势 | 折线 | Keepa history | 当前 vs 1/3/6/12月前 |
| 30 | 市场总销量趋势 | 折线 | Keepa history | 市场总量月度走势 |
| 31 | BSR趋势 | 折线 | Keepa salesRank | 当前 vs 30/90/180天 |
| 32 | BSR波动度 | 纯KPI | Keepa salesRank | CV |
| 33 | 新品起量速度 | 散点 | Keepa | 新品销量增长 |
| 34 | 产品生命周期阶段 | 表 | Keepa 综合 | 导入/成长/成熟/衰退 |
| 35 | 市场成熟度 | 纯KPI | Keepa 综合 | 平均上架月数+评论数 |
| 36 | 头部vs新品销量对比 | 柱 | SERP+Keepa | Top10 vs 新品 |
| 37 | 价格离散度 | 纯KPI | extractedPrice | CV |
| 38 | 销量离散度 | 纯KPI | units | CV |
附录：新品清单（升级）
- 有 Keepa：
availableDate< 6 月 - 无 Keepa：
ratings < 100（代理） - 排序：
organic_rank升序
Keepa 字段可用性
详见 references/keepa-fields.md。
展示规则
- 所有位次分析使用
organic_rank，不用原始position跨页排序 - 帕累托累计占比单调递增，右 Y 轴最大 100%
- 分布图：柱=商品数，线=销量占比%
- 趋势图：折线，X 轴=时间（月/天），Y 轴=销量/BSR
- 散点图：X 轴=上架月数/时间，Y 轴=评论增长/销量增长
- 饼图：FBA/FBM/AMZ、品牌份额等占比
- 数字千分位，百分比 1 位小数
- 色板：
['#4f46e5','#06b6d4','#8b5cf6','#f59e0b','#10b981','#ef4444','#ec4899','#6366f1']
报告必须披露的边界
- 样本 = 默认排序前 3 页自然结果（已去广告）
- 自然位次 = 按页序去广告后连续编号，非亚马逊官方 rank / BSR
- 月销缺失按 50 件计；销额缺失按 50×现价估算；注明原始销量覆盖率
- 是否含变体依据 SERP options + Keepa variationNum
- 新品清单：有 Keepa 数据时以 availableDate<6 月为主口径，无 Keepa 数据时以 ratings<100 为代理
- Keepa 数据覆盖率 = 成功 ASIN 数 / 总 ASIN 数
- BSR/利润/FBA费用/品牌/卖家等维度仅在 Keepa 数据可用时呈现
限制
- 每次 3 页 SERP：45 积分
- Keepa 批量：~48 ASINs / 5 = 10 批次，约 540 积分
- 总计约 585 积分
- Keepa 不可用时降级为纯 SERP 6 段分析（45 积分）
- 每页条数不固定，过滤广告后自然结果数量随词变化
- 实时前台快照 + Keepa 最近更新数据，非完全同步
适用与不适用
适用：关键词首页或前 3 页自然竞争结构；品牌份额与垄断系数；FBA/FBM 结构；卖家集中度；BSR 门槛与趋势；利润率与 FBA 费用分布；上架时间与新品分析；12 月销量趋势与生命周期阶段；定价带与销量是否错位；自然位集中度；标题/主图同质化与偏题形态；按类目对齐的 ASIN 对比表。
不适用：关键词级搜索量/趋势（用 ABA 工具）；广告/PPC 数据；评论内容分析；全类目份额（非前3页范围）；历史价格曲线（用 keepa-product-series）。