如何采集 eBay 商品数据

1. 先确认 Listing 与需要的规格

1. 安装并启用 eBay.com

   从 Chrome 商店安装 SKUGrab 后，访问 eBay.com 商品详情页。在扩展弹窗点击「打开采集面板」（Open export controls），按浏览器提示授权网站访问。随后，SKUGrab 工具条会在已启用的受支持页面自动出现。

2. 先在 eBay 选择规格

   Listing 有尺码、颜色等选项时，先选择需要的值，等待价格更新。点击 SKUGrab「更多 → 查看规格明细」，核对规格与价格。只有 URL 包含数字形式的 var 参数时，才保存对应变体 ID。

3. 导出或保存到本地

   点击「导出 JSON」，下载一份以商品命名的 JSON。点击「采集商品」只保存不下载，再通过「商品库 → 查看详情」检查 JSON 与当前规格。直接导出也会先保存到本地。

2. 分清 Listing 标识、选项与价格

Listing 标识

id 是 eBay 商品 / Listing ID。variants[0].id 来自 URL 中的数字 var 参数，没有则为 null。两种编号都与卖家 SKU 不同。

公开规格

options 保存页面已加载的 Size、Color 等可选项名称；variants[0].options 记录当前选择。不单独导出结构化 item specifics 属性表，也不导出隐藏组合或卖家 SKU。

价格与可用状态

price 是配合 currency 使用的十进制字符串，未知时为 null。不会将价格区间当成当前变体价格。可用状态可能为 null，也不能用它代表库存数量。

描述与图片

导出包含 title、可读取的描述文字和图片 URL。可访问页面数据未提供描述时，description 可能为空。图片只保存链接，不下载图片文件。

3. 用批量 ZIP 比较多个 Listing

在受支持的 eBay 结果页或商品列表，点击「批量选择」。用商品图片上的控件勾选，或使用「全选已加载商品」。需要更多商品时先加载卡片，再点击「扫描商品卡片」。只扫描已加载且能识别的卡片，不自动翻页。

点击「导出所选商品 · ZIP」。临时后台标签页按所选卡片 URL 读取商品，完成后关闭。每条实际包含的 Listing 对应一份 JSON，请查看任务中跳过的商品数。批量任务不会沿用另一个标签页手动选择的规格；特定规格需要在详情页单独导出。

4. 读懂 Listing JSON

{
  "schemaVersion": 1,
  "platform": "ebay",
  "id": "123456789012",
  "url": "https://www.ebay.com/itm/123456789012?var=987654321000",
  "title": "Example cotton T-shirt",
  "description": "Illustrative listing description.",
  "currency": "USD",
  "price": "18.50",
  "images": [
    "https://example.com/demo-shirt.jpg"
  ],
  "options": [
    {
      "name": "Size",
      "values": [
        "M",
        "L"
      ]
    }
  ],
  "variants": [
    {
      "id": "987654321000",
      "sku": null,
      "title": "M",
      "options": {
        "Size": "M"
      },
      "price": "18.50",
      "currency": "USD",
      "available": null,
      "url": "https://www.ebay.com/itm/123456789012?var=987654321000"
    }
  ],
  "capturedAt": "2026-10-02T08:00:00.000Z",
  "completeness": {
    "level": "partial",
    "notes": [
      "Illustrative current selection: unloaded variations, seller SKU and stock quantities are unknown."
    ]
  }
}

顶层 id 标识 Listing，variants[0].id 对应 URL 中的 var。页面列出 M 和 L，但快照只记录 M；这里没有经过确认的 L 价格。sku: null 和 available: null 表示未知。复用数据前，请依据 completeness 提示理解这份局部规格快照。

5. 验证保存的快照

• 核对 Listing ID、名称和来源 URL，确认是目标商品。
• 将当前选项和显示价格与页面比较，明确核对货币。
• 阅读 completeness.notes，区分可用状态未知与不可用。
• 分析前检查 ZIP 内的 JSON 数量，以及是否有跳过的 Listing。

可在商品库按 eBay 筛选，或搜索名称和 ID。勾选记录后点击「导出 JSON / ZIP」：一条下载 JSON，多条下载 ZIP，使用相同的导出额度。再次采集同一 Listing 会替换记录，即使选择了另一变体；需要保留不同快照时，请保存导出文件。数据留在浏览器与下载文件中，不上传商品数据。

Listing 无法读取时怎么处理

缺少控件时，网站可能尚未启用或授权。重新打开扩展弹窗检查访问权限。列表没有可识别卡片时，加载更多商品再扫描。选项或价格缺失时，等待详情页加载完成后，直接检查该商品。

登录、CAPTCHA 或验证页会停止采集，请自行按网站正常流程完成。SKUGrab 不绕过访问限制。ZIP 中断时，重试前先查看浏览器下载记录。后台重启后需重新发起批量任务。联系支持时，提供公开 URL、扩展版本和浏览器版本。

eBay 采集常见问题