amazon-bestsellers-summary

---

---

痛点

你是否经历过这些分析困境？

场景	结果
手动收集 Amazon Top50 产品数据	耗时数天，数据零散难以整合
不知道如何分析市场竞争格局	缺乏系统框架，分析流于表面
用户评论数据量大且杂乱	无法提炼有价值的用户洞察
A+ 内容素材分散	难以总结竞品内容策略

Amazon-Bestsellers-Summary 提供全流程自动化解决方案：从爬虫抓取 → 分块提取 → 四维度分析 → 汇总报告，一条命令完成所有工作。

---

核心功能

四维度分析体系

┌───────────────────────────────────────────────────────────────┐
│  Marketplace 维度：市场竞争格局分析                            │
│  Reviews 维度：用户评论情感与需求洞察                          │
│  A+ Content 维度：产品详情页内容策略分析                       │
│  Fine-Grained 维度：Top50 逐商品细分类与机会判断               │
└───────────────────────────────────────────────────────────────┘

维度	分析内容
Marketplace	价格分布、评分分布、排名变化、品牌集中度、新品机会
Reviews	情感分析、用户痛点、需求趋势、好评/差评关键词
A+ Content	模块结构、视觉策略、Comparison Table、品牌故事、A+ 质量分层
Fine-Grained	细分类标签（L1/L2）、证据链、分布统计、标签空档与拥挤区

---

工作流程

flowchart LR
    U["用户请求<br/>Bestsellers URL"]

    subgraph P1["Phase 1: CRAWL"]
        direction TB
        A1["crawl_bestseller_list<br/>类目列表页 + rankings.jsonl"]
        A2["crawl_product_details<br/>商品详情页 ASIN 去重<br/>+ 自动提取 listing / A+ 图"]
        A1 --> A2
    end

    subgraph P2["Phase 2: CHUNK"]
        direction TB
        B["Chunker Agent<br/>黄金样本（Top1+Top25）<br/>+ 分块提取 {rank}_{ASIN}/"]
        BA["Audit Agent<br/>审查 chunks 完整性<br/>报告结果→Orchestrator 处理"]
        B --> BA
    end

    subgraph P3["Phase 3: ANALYZE"]
        direction TB
        C1["Marketplace Analyst<br/>市场竞争"]
        C2["Reviews Analyst<br/>评论洞察"]
        C3["A+ Analyst<br/>A+ 内容策略<br/>读 aplus-images/"]
        C4["Fine-Grained Analyst<br/>细分类判定<br/>读 listing-images/"]
    end

    subgraph P4["Phase 4: SUMMARY"]
        F["Summary Report<br/>四维度综合判断"]
    end

    U --> A1
    A2 --> B
    BA --> C1 --> F
    BA --> C2 --> F
    BA --> C3 --> F
    BA --> C4 --> F

关键设计：

• 类目以 Browse Node ID (codied) 命名：从 Bestsellers URL 尾部抽取的纯数字，如 11058221，作为 category_slug，禁止模型自己起名
• URL 必须包含类目名：Amazon 不接受纯数字 ID 的 URL（/gp/bestsellers/11058221/ 无法访问），必须提供完整 URL 如 /gp/bestsellers/beauty/11058221/
• products/ 是全局 ASIN 仓库：按 ASIN 去重，MCP 默认跳过已爬过的 ASIN，不会重复请求
• categories/{browse_node_id}/rankings.jsonl：append-only 排名日志，每次运行追加一行，可追踪排名变化
• 图片由 MCP 统一负责：crawl_product_details 时自动提取 listing + A+ 图到 products/{ASIN}/ 下，agent 只读取不下载

---

插件结构

amazon-bestsellers-summary/
├── .claude-plugin/
│   └── plugin.json                                  # 插件元数据
├── agents/                                          # Agent 定义
│   ├── amazon-bestsellers-orchestrator.md           # 顶层编排器
│   ├── amazon-product-chunker.md                    # 数据分块提取
│   ├── amazon-chunker-audit.md                      # chunks 完整性审查
│   ├── amazon-bestsellers-marketplace-analyst.md    # 市场分析
│   ├── amazon-bestsellers-reviews-analyst.md        # 评论分析
│   ├── amazon-bestsellers-aplus-analyst.md          # A+ 内容分析
│   └── amazon-bestsellers-fine-grained-analyst.md   # 细分类分析
├── skills/                                          # Skill 定义
│   ├── amazon-chunker/                              # 分块技能
│   ├── amazon-extractor/                            # 数据提取技能
│   ├── amazon-test-chunker/                         # TDD & Golden Fixture
│   ├── amazon-bestsellers-marketplace-dim/          # 市场维度技能
│   ├── amazon-bestsellers-reviews-dim/              # 评论维度技能
│   ├── amazon-bestsellers-aplus-dim/                # A+ 维度技能
│   └── amazon-bestsellers-fine-grained-dim/         # 细分类维度技能
├── scraper/                                         # MCP Server + 爬虫
│   ├── mcp_server.py                                # MCP 服务入口（4 个工具）
│   ├── category_spider.py                           # 类目列表页爬虫
│   ├── product_spider.py                            # 商品详情页爬虫（ASIN 去重）
│   ├── extract_listing_images.py                    # Listing 图提取
│   ├── extract_aplus.py                             # A+ 图 + 结构化内容提取
│   ├── downloader.py                                # 通用图片下载工具
│   └── requirements.txt                             # Python 依赖
├── chunker/                                         # chunker 主代码（由 chunker agent 产出至 workspace）
└── README.md

MCP 工具

scraper/mcp_server.py 对外暴露 4 个工具：