采集亚马逊畅销榜单(Best Sellers)前 2000 名的商品,输出榜单排名、商品名称、ASIN、价格、星级、评价数等明细字段
概览
把一个亚马逊站点的类目结构整理成一张可以逐层展开的清单:从一级大类目出发,逐级列出二级、三级等子类目,每个类目都带着自己的编号、父级编号、所处层级和从根到叶的完整名称路径。做选品分类、把自家商品映射到平台类目、或者为投放和竞品分析划定类目范围时,不必再靠人工一层层点开页面去抄。
结果以「一个类目一行」的表格给出,天然带着父子关系:想看某个大类下面有哪些细分,按父类目编号筛选即可;想还原完整的树,按类目路径排序就能看到每一层的归属。类目名称保留站点页面上的原文,便于与平台后台、榜单页面逐字对照。
数据说明
数据来自亚马逊公开畅销榜的类目导航,按一级类目逐层展开,同一次运行只覆盖一个站点。每个类目以「站点」和「类目编号」组合成唯一标识,同一类目重复采集时保持不变,可以直接合并去重。一级类目在榜单里只有英文标识而没有数字编号,因此一级记录的「类目编号」是它的英文标识,「父类目编号」记为 0;从二级开始才是数字编号。「下级数量」是本次运行实际采集到的直接子类目个数,不等于该类目在站点中的理论分支总数。
结果只包含公开榜单导航中出现的类目,未进入榜单导航的分类、以及已经下架或被合并的历史分类不在其中;类目下的商品数量、销量、竞争度等统计指标也不在结果里。分类名称反映运行当时榜单展示的写法,站点不同,名称所用的语言也不同。
结果长什么样
每一条记录就是一个类目节点。
| 类目编号 | 类目名称 | 父类目编号 | 层级 | 类目路径 | 下级数量 |
|---|---|---|---|---|---|
| electronics | Electronics | 0 | 1 | Electronics | 18 |
| 281407 | Accessories & Supplies | electronics | 2 | Electronics > Accessories & Supplies | 14 |
| 12954861 | Cables | 281407 | 3 | Electronics > Accessories & Supplies > Cables | 3 |
此外每条记录还带有「节点标识」「站点」「类目页面」「有下级」等字段。
应用场景
- 类目映射:用「类目编号」和「类目名称」把自有商品分类对应到平台类目,遇到同名类目时靠「类目路径」区分不同大类下的重名项。
- 细分市场梳理:按「层级」筛出二、三级类目,再用「下级数量」找出分支最多的方向,快速看出哪些大类下的细分最密集。
- 投放与分析范围划定:按「父类目编号」展开某个大类,配合「类目路径」导出一份可供投放或竞品分析使用的类目清单。
适用边界
单次默认输出 5000 个类目节点、可配置上限 50000 个,最深 6 层,一次运行只覆盖一个站点,且仅含公开榜单导航中可见的类目
- 适合用于
- 需要把某个亚马逊站点的类目整理成带层级和父子关系的清单,用于选品分类、类目映射或投放类目定位
- 需要按一级、二级、三级类目逐层查看分类结构,并把完整类目路径用于后续分析
- 不要用于
- 只需要某一个类目下的商品榜单或商品明细,用商品榜单类数据更直接
- 需要类目下的商品数量、销量或竞争度等统计指标,本应用只提供分类结构
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1结果为空或类目数量明显偏少时,先确认站点是否选对,再检查指定的一级类目是否存在
- 2遇到临时访问受限导致部分层级缺失,可稍后以较小范围重跑,已写回的类目节点会保留
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 亚马逊站点
marketplace必填string(enum)选择要采集类目树的站点,一次运行只输出一个站点的类目。默认美国站。可选值如 US(美国站) / DE(德国站) / UK(英国站) / JP(日本站) / FR(法国站) / IT(意大利站) / ES(西班牙站) / CA(加拿大站) …(共 12 项,试运行表单可搜索)默认值US示例US - 起始一级类目
root_node_ids选填array<string>只从指定的一级类目开始下钻,填类目的英文标识如 electronics;留空表示采集该站点的全部一级类目。数量最多 20 项 - 下钻层级
max_depth选填integer最多采到第几层类目,一级类目记为第 1 层。默认 3 层,最多 6 层。范围1–6默认值3 - 最多输出类目数
max_nodes选填integer单次运行最多写回多少个类目节点,默认 5000 个,最多 50000 个;数值越大耗时越长。范围1–50000默认值5000
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 节点标识
node_keystring站点与类目编号组合成的唯一标识,同一类目在不同次运行中保持不变示例US:electronics - 站点
marketplacestring该类目所属的亚马逊站点代码示例US - 类目编号
node_idstring类目的 Browse Node 编号;一级类目在榜单中只有英文标识,这里用该标识代替编号示例electronics - 类目名称
namestring该类目在所属站点页面上显示的名称,保留站点原文语言示例Electronics
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"node_key": "US:electronics",
"marketplace": "US",
"node_id": "electronics",
"name": "Electronics",
"parent_node_id": "0",
"level": 1,
"name_path": "Electronics",
"url": "https://www.amazon.com/gp/bestsellers/electronics",
"has_children": true,
"child_count": 18
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=海色心情/amazon-category-tree",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。