跳到主要内容

让你的 AI Agent 连接 Amazon Selling Partner API

对比亚马逊商品目录条目,校验拟提交的 Listing 修改,查看已授权站点的库存。

每月 20,000 次免费应用调用(付费服务另计)

试试这些 Amazon Selling Partner API 任务

将提示词复制到已安装 oo Skill 的 Agent,补充页面链接和原始笔记后执行。

oo SkillAmazon Selling Partner API

对比商品目录条目

按关键词或商品标识符搜索,并对比同一站点的商品属性、图片和变体。

/oo Amazon Selling Partner API: 在亚马逊[站点]搜索[关键词]。对比返回商品的尺寸、材质和变体,保留 ASIN,并标出缺失的商品信息。

保存前检查 Listing 修改

读取当前 Listing,并预览拟提交的属性修改,找出校验问题。

/oo Amazon Selling Partner API: 读取亚马逊站点[站点 ID]中的 SKU [SKU]。使用商品类型[商品类型]和我提供的属性值,预览这些修改:[修改内容]。报告校验问题,不要保存更新。

检查 FBA 库存

查看指定卖家 SKU 的可用、预留和入库数量。

/oo Amazon Selling Partner API: 查看亚马逊站点[站点 ID]中 SKU [SKU 列表]的 FBA 库存。包含详细数量,区分可用、预留和入库库存,并标出低于[库存阈值]的商品。

开始使用 Amazon Selling Partner API

  1. 安装 OOMOL

    在 Agent 中配置 oo CLI 和 oo Skill。

    安装 OOMOL →
  2. 连接 Amazon Selling Partner API

    使用你自己的公开 SP-API 应用及其 Login with Amazon 凭据连接卖家账户。

    连接 Amazon Selling Partner API→
  3. 向 Agent 交代任务

    使用 /oo,说明要读取的页面、修改的内容和保存位置。

    连接指南 →
  • 一个已发布或处于草稿状态的公开 SP-API 应用,以及能够授权该应用的卖家账户。
  • 从 https://solutionproviderportal.amazon.com/ 获取该应用的 SP-API Application ID、LWA Client ID 和 LWA Client Secret。
  • 将连接器回调地址登记为应用的 OAuth Redirect URI,并在亚马逊申请所需操作对应的应用角色。
  • 选择登录 Seller Central 使用的国家,系统会自动选择 API 区域。不同销售区域需要分别连接。
  • 草稿应用请在“草稿应用版本”中填写 beta,已发布应用留空。私有应用的自授权采用另一种授权流程。

Amazon Selling Partner API 工具

Amazon Selling Partner API 将卖家账户连接到商品目录、Listing 和 FBA 库存操作。提供站点和 SKU 信息,即可让助手对比商品、检查 Listing 问题或汇总库存。

查找已授权站点

列出卖家在当前连接区域的站点及参与状态。

搜索亚马逊商品目录

搜索商品目录条目并获取所需的商品数据集。

检查和维护卖家 Listing

搜索 Listing、查看问题、预览修改、创建或更新 Listing,以及删除指定 Listing。

查看 FBA 库存

读取站点库存摘要,支持按 SKU、详情需求和变化时间筛选。

9 个工具

List Marketplace Participations

列出已连接卖家在当前区域的亚马逊站点及参与状态。

amazon_sp_api.list_marketplace_participations

Search Catalog Items

按商品标识符或关键词搜索亚马逊商品目录。最多可翻页获取 1,000 个匹配的 ASIN。

amazon_sp_api.search_catalog_items

Get Catalog Item

按 ASIN 获取亚马逊商品目录条目,并返回所选站点和数据集。

amazon_sp_api.get_catalog_item

Search Listings Items

按标识符、商品关系、日期、状态或问题严重程度搜索卖家 Listing。最多可翻页获取 1,000 个匹配的 SKU。

amazon_sp_api.search_listings_items

Get Listings Item

获取卖家 Listing,以及所选的属性、报价、实时库存可用情况和处理问题。

amazon_sp_api.get_listings_item

Put Listings Item

创建或完整更新卖家 Listing。省略的已有属性可能被移除;局部修改请使用 patch_listings_item。VALIDATION_PREVIEW 仅校验提交内容,不保存更改。

amazon_sp_api.put_listings_item

Patch Listings Item

通过 add、replace、merge 或 delete 局部更新 Listing 属性。删除属性实例需提供选择器值。VALIDATION_PREVIEW 仅校验而不保存;ACCEPTED 的提交后续仍可能出现处理问题。

amazon_sp_api.patch_listings_item

Delete Listings Item

删除卖家在单个亚马逊站点的 Listing。返回的提交状态表明亚马逊是否已接受删除请求并开始处理。

amazon_sp_api.delete_listings_item

Get Inventory Summaries

读取单个站点的 FBA 库存摘要。查询库存变化时,翻页需保留 startDateTime,并在 30 秒内使用 nextToken。增量筛选不检测入库数量变化。

amazon_sp_api.get_inventory_summaries

常见问题

可以只检查 Listing 修改而不保存吗?

可以。请明确要求校验预览。创建和局部更新操作支持 VALIDATION_PREVIEW,会校验所提供的 Listing 数据,不保存更改。

返回 ACCEPTED 就表示 Listing 修改已生效吗?

ACCEPTED 表示亚马逊已接受提交并开始处理。之后可读取 Listing 的问题和当前详情确认结果。若需保留其他属性,请使用局部更新;完整更新可能移除未提交的已有属性。

为什么连接成功后仍可能无法调用某些操作?

访问权限取决于亚马逊为应用批准的角色,以及卖家的站点权限。应用角色需要在亚马逊配置,不是在连接时以 OAuth scope 的形式选择。

增量库存查询会包含所有库存变化吗?

按变化时间筛选不会检测待发货、已发货和接收中的入库数量变化。需要这些数量时,请查询当前的详细库存。

可以调用其他 SP-API 接口吗?

通用代理可使用连接的访问令牌,向当前区域的 SP-API 发送普通请求。Restricted Data Token 交换、无需卖家授权的调用、文件传输及多步骤任务需要另行处理。