Agent Skills
返回列表
🏢

Amazon 店铺 Listings 与 API

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/linkfox-ai-linkfox-amazon-store-listings-107

技能介绍

要解决什么问题

在亚马逊卖家后台或自研系统里,刊登(Listing)往往要对接 Selling Partner API(SP-API) 的 Listings Items 与 Product Type Definitions 等路径:按 卖家 SKU 查单条、按条件分页检索、用 JSON Patch 局部改属性,或 PUT 全量创建/更新。还要在上线前查 刊登限制(ASIN 维度)和 product type 的 schema。本技能把上述能力封装成可脚本化的调用,并统一走 LinkFox 的 POST /spApi/developerProxy,由服务端解析店铺 token(依赖 linkfox-amazon-store-auth 先完成选店)。

技能如何工作

调用时传入 sellerId、region(NA / EU / FE)及对应 Query/Body,网关向上游转发 GET / PATCH / PUT / DELETE。仓库内提供与官方操作一一对应的 Python 脚本,例如:

  • get_listings_item.py / search_listings_items.py:单条与列表检索(列表路径不含 SKU 尾段)
  • patch_listings_item.py / put_listings_item.py / delete_listings_item.py:写操作(PUT/DELETE 要求 marketplaceIds 仅一个)
  • get_listings_restrictions.py、search_definitions_product_types.py、get_definitions_product_type.py:限制与类目 schema

响应会落盘到项目目录下的 JSON;体积极大时 stdout 只打摘要,可用 jq 等从文件按需抽取字段,避免整包 JSON 进对话上下文。调用会消耗积分,文档要求失败或空结果时不要自动换词、翻页或连续试探。

边界与注意点

  • 必须先安装 linkfox-amazon-store-auth,check_auth_dependency.py 退出码 42 表示缺依赖。
  • searchListingsItems 中 identifiers、variationParentSku、packageHierarchySku 互斥;searchDefinitionsProductTypes 中 keywords 与 itemName 互斥。
  • PATCH 的 JSON Patch delete 与 deleteListingsItem 不是一回事;Vendor 对部分 patch 或 LISTING_OFFER_ONLY 可能返回 400。
  • 网关路径需在运维侧对 listings/.../items、restrictions、definitions/.../productTypes 等分别放行白名单。

使用场景

  • 按卖家 SKU 拉取单个 marketplace 上的 listing 详情与 issues,核对后台与 API 返回是否一致
  • 用 createdAfter、withStatus 等条件分页 searchListingsItems,导出当前在售 SKU 列表做库存对账
  • 上架前对目标 ASIN 调用 getListingsRestrictions,确认是否因类目或条件类型被限制刊登
  • 选定 productType 后 getDefinitionsProductType 取 schema,再 putListingsItem 按 LISTING 要求提交 attributes

适合人员

  • 负责多站点刊登维护的亚马逊运营,需要用 API 批量查改 SKU 而非纯后台点选
  • 对接 ERP 或刊登工具的后端工程师,要在网关后统一转发 Listings 与 Definitions 路径
  • 类目合规同学,需在改价改属性前确认 ASIN 刊登限制与 product type 字段约束
  • 已接入 LinkFox Amazon Store 授权链路的团队,要把 report/auth 之外的 listings 写读能力补齐