从 eBay Listing 到商品库,再到 Excel
下面使用 0.2.25 版真实商品库界面,载入两条虚构教学记录拍摄,不是真实 eBay 采集实测。CSV/Excel 文件由该版本扩展的导出器生成,用于核对输出格式,不代表所有 eBay 页面均兼容。先用一件真实商品验证你的工作流程。
- 01
选择并保存 Listing
在已授权的 eBay 列表页勾选商品,点击“加入商品库”。等待任务结束,核对成功和失败数量;失败商品应单独重试。
- 02
检查当前规格
打开商品库的“查看详情”,对照来源页核对 Item ID、当前选择、价格和完整性说明。可选尺码不等于已采集到全部变体。
- 03
导出 CSV 或 Excel
在商品库勾选记录,选择 CSV 或 Excel,再导出。每个可用变体一行,无变体商品保留一行;缺失值留空。


| id | variants.id | variants.options.Size | price | variants.sku |
|---|---|---|---|---|
| 123456789012 | 987654321000 | M | 18.50 | |
| 234567890123 | 24.99 |
两件商品产生两行,按两件商品计导出额度。空 SKU 不应替换成 Item ID;CSV/Excel 也不是 Seller Hub 库存报告或可直接导入其他店铺的模板。
阅读批量采集步骤与故障排查1. 采集一件 eBay 商品
- 01
打开详情页并授予站点访问权限
访问网址包含 /itm/ 的 eBay.com 商品详情页。若面板未出现,点击插件图标,再点击「打开采集面板」(Open export controls),按 Chrome 提示授权当前站点。已授权的支持页面会自动打开采集抽屉;列表上的一张卡片不等于完整详情页。
- 02
先在 eBay 选择规格并等待价格更新
选择尺码、颜色等选项,等待页面上的名称、选项和价格更新完成。在 SKUGrab 中按需展开「更多」,点击「查看规格明细」,核对当前规格和币种。页面列出多个尺码,不代表已经采集了每个尺码。
- 03
保存到本地商品库
点击「采集商品」保存当前快照,不下载文件。进入「商品库 → 查看详情」检查记录。商品 ID 应与 eBay 链接中的 Listing 编号一致;若链接含数字形式的 var 参数,快照应保留对应的当前变体 ID。
- 04
选择格式并导出
在「导出格式」中选择 CSV、Excel 或 JSON,再点击导出按钮。单个 JSON 文件以商品名称命名,直接导出也会先保存商品。若按钮不可用,先按下方排查步骤检查任务和访问权限。
2. 了解实际采集的字段
- 商品与规格标识
- id 为 eBay 商品 / Listing 编号,url 为来源地址。variants.id 来自数字 var 参数,未公开时为 null。商品编号与变体 ID 都不是卖家内部 SKU。
- 标题、描述和图片
- 采集标题、可访问的描述文字和图片 URL。可读取数据未包含描述时,该字段可能为空。图片以链接形式导出,不会嵌入表格,也不会生成图片压缩包。
- 价格和币种
- price 是当前明确报价的十进制字符串,与 currency 配合使用。未知价格在 JSON 中为 null,在表格中留空;不把价格区间当成当前规格价格。不默认价格包含运费或税,也不把未知币种当作 USD。
- 选项与变体
- options 保存当前页面已加载的选项标签,variants 保存当前选择。不遍历全部隐藏尺码/颜色组合,也不提供卖家私有 SKU、库存数量或结构化 item specifics 属性表。
- 采集时间与完整性
- capturedAt 是采集时间;completeness.level 与 completeness.notes 解释数据边界。保存的记录是当时快照,不会自动追踪实时价格。
3. 将 eBay 商品导出为 CSV 或 Excel
"id","title","currency","variants.id","variants.options.Size","variants.price","variants.sku"
"123456789012","Example cotton T-shirt","USD","987654321000","M","18.50",""需要比较商品或整理资料时可选择 Excel;下游工具要求文本表格时选择 CSV;需要原始嵌套结构或重新导入 SKUGrab 商品库时保留 JSON。CSV 与 Excel 只用于导出,不是商品库备份或导入格式。
进入商品库,按 eBay 筛选并勾选记录,选择 CSV 或 Excel 后导出。所选商品会合并为一个文件。表头来自实际 JSON 字段路径,例如 id、title、price、currency、variants.options.Size;不同记录组合的表头可能不同。每个变体占一行并重复商品字段,当前 eBay 采集器通常每条 Listing 保存一个当前规格。
示例展示虚构商品的部分 CSV 列:当前选择尺码 M,因此只有一行。页面可以提供 L,但本次快照没有经核实的 L 行。卖家 SKU 留空是预期结果;实际导出还包含其他字段。
4. 从结果页批量采集多个 Listing
- 01
加载并选择商品
在 eBay.com 结果页或受支持的商品列表打开「批量选择」,勾选识别到的商品卡片,或点击「全选已加载商品」。加载新卡片后再次「扫描商品卡片」。不会自动翻页或遍历整店。
- 02
选择批量输出格式
选择 CSV 或 Excel,将采集结果合并为一张表;选择 JSON,则一个 ZIP 中每件商品对应一份 JSON。启动导出后查看任务进度和跳过数量。每批最多 100 件,同时需符合剩余导出额度。
- 03
核对规格和最终文件
批量任务在临时后台标签页读取所选卡片 URL,不会沿用另一标签页手动选择的规格。需要特定尺码、颜色或 var 编号时,请打开对应详情页单独导出。使用结果前,抽查若干行与来源商品是否一致。
5. 在 JSON 中区分商品 ID 和规格 ID
{
"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."
]
}
}对于 /itm/123456789012?var=987654321000,顶层 id 是商品编号 123456789012,variants[0].id 为当前规格编号 987654321000。示例将 M 和 L 作为可选标签,但只采集了 M;不能用 M 的价格推算 L。
再次采集相同来源站点的同一 Listing 会替换商品库记录,即使选择了另一变体。需要保留多个观察结果时,分别保存导出文件。涉及数据完整性的研究,建议同时保留原始 JSON 和表格。
6. 使用数据之前先核对
- 将商品 ID、来源 URL 和标题与目标 Listing 对照。
- 核对已选择尺码/颜色、当前价格和明确的币种。
- 检查 capturedAt 与完整性提示;可用状态未知不等于无货。
- 比较最终表格行或 JSON 文件数与实际成功包含的商品数,不直接等同于勾选数。
- 需要查看图片时单独打开图片 URL;链接单元格并非内嵌图片。
- 导入其他系统前,将编号保留为文本,缺失字段继续留空。
这些快照可用于选品研究、Listing 比较和本地参考资料整理。导入其他系统前需自行映射并检查字段;它不是 eBay Seller Hub 库存报表,也不是现成的店铺迁移模板。
采集或导出失败时怎么排查
- 没有采集按钮
- 确认是 eBay.com 的 /itm/ 商品详情页;目前不支持其他地区的 eBay 域名。检查 Chrome 站点访问权限,并通过插件图标重新打开面板。扩展更新后刷新商品页,让页面加载新版脚本。
- 导出按钮被禁用
- 检查是否有批量任务运行或浏览器下载未完成。进入商品库「任务与下载」并核对浏览器下载记录,再决定是否重试。若仍卡住,向支持提供扩展版本和公开商品链接。
- 只能选择 JSON
- CSV 与 Excel 需要扩展 v0.2.11 或以上版本。请检查已安装的扩展版本;更新或刷新官网不会更新插件。
- 缺少价格、选项或描述
- 等待所选规格加载后重新预览。有些字段未在可读取数据中公开,应保持为空;反复采集不能获取卖家私有 SKU。
- 页面要求登录或验证
- 请自行完成网站正常的登录或验证流程,再重新操作。SKUGrab 不绕过 CAPTCHA 或访问限制;失败或取消的任务不能视为下载成功。
eBay 采集与导出常见问题
不用写代码,如何采集 eBay 商品?
安装 SKUGrab,打开 eBay.com 商品详情页并授权访问,选择需要的规格后预览,再选择 CSV、Excel 或 JSON 导出。多商品可在受支持结果页勾选已加载卡片。
可以把 eBay Listing 导出为 Excel 或 CSV 吗?
可以,需要 SKUGrab v0.2.11 或以上版本。在商品库勾选商品并选择 CSV 或 Excel,会生成动态表头的合并文件。采集的是公开商品页,不是卖家后台库存报表。
能采集所有变体和库存数量吗?
不能保证。当前采集器记录显示的当前规格与已加载选项,不枚举隐藏组合,不获取卖家私有 SKU,也不推断库存数量。
包含已售商品或历史销量吗?
不提供已售商品研究、交易报表、销售历史或自动价格监控。公开商品快照只能用于其实际字段能够支持的分析。
采集和导出 eBay 商品免费吗?
当前浏览器每个 UTC 日有 20 件免费导出额度,免费版也需要通过 Google 登录。每件实际包含的商品在下载完成后计一次额度,表格行数不影响计数。
可以下载 eBay 商品图片吗?
导出包含可读取的图片 URL,不下载图片文件,也不会把图片嵌入 Excel 工作簿。