Amazon 店铺 Listings 与 API
将以下提示词粘贴到你的 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 写读能力补齐