创建 Listing
按商品类型自己的结构在亚马逊上架新品——找到类型，填好必填属性，先校验，再提交。
一句话
AI 找到商品类型、读取它的结构、和你一起填属性，用亚马逊的校验预览检查一遍，然后才创建 Listing。
一步一步
找到商品类型
“我要上架一款新瑜伽垫。” productTypeDefinitions_searchDefinitionsProductTypes 按关键词找到对应的亚马逊商品类型。
看亚马逊要求什么
productTypeDefinitions_getDefinitionsProductType 返回该类型的完整结构——每个属性、哪些必填、允许的取值。
发布之前先校验
listings_validate_rows 对你的数据行运行亚马逊的校验预览，返回会出现的问题——不会上线任何内容。
创建或修改 Listing
listings_putListingsItem 创建 Listing（或整体替换）；listings_patchListingsItem 只修改现有 Listing 中你指定的属性。一次处理很多 SKU，用发布队列——见属性与发布队列。
可以这样问
“在运动类目下为一款新瑜伽垫创建 Listing——先用亚马逊的校验检查一遍。”
“列出商品类型 SPORTING_GOODS 的必填属性。”
查结构的两种调用方式
同一个工具、同样的参数——通过 AI 客户端，或者从你自己的代码。
MCP——你描述商品；AI 调用 productTypeDefinitions_searchDefinitionsProductTypes，推荐最匹配的类型，问过你再继续。
在 AI 客户端中（MCP）
{
"name": "productTypeDefinitions_searchDefinitionsProductTypes",
"arguments": {
"store": "myStore-US",
"keywords": "yoga mat"
}
}在代码中（Tool API）
curl -X POST https://api.sellersheetai.com/api/v1/tools/productTypeDefinitions_searchDefinitionsProductTypes \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","keywords":"yoga mat"}'需要写权限
创建、替换或 patch Listing 都会改动你的卖家账户，所以该店铺需要写权限（见掌控你的 AI）。搜索商品类型和读取结构只需读权限。
本页用到的工具
构建时从工具目录读取，每个工具带有自己的权限标签。
| 工具 | 权限 | 作用（英文） |
|---|---|---|
productTypeDefinitions_searchDefinitionsProductTypes | read | Search for Amazon product types that have definitions available. |
productTypeDefinitions_getDefinitionsProductType | read | Retrieve an Amazon product type's definition — its attribute groups, requirements and a link to its JSON Schema. |
listings_validate_rows | write | Validate rows of the LEGACY Create Listing sheet (combined headers, config in rows 1–2) with Amazon's VALIDATION_PREVIEW. |
listings_putListingsItem | destructive | Create a listing, or fully replace an existing one — PUT replaces every attribute, so for a targeted change use listings_patchListingsItem. |
listings_patchListingsItem | destructive | Patch attributes on an existing listing (JSON Patch) without replacing it — the tool for fixing a suppressed listing or changing price, inventory, title or images. |
listings_deleteListingsItem | destructive | Delete this seller's listing for a SKU (offer and submitted attributes); the ASIN's catalog page stays. |
常见问题
能一次上架很多商品吗？
可以——为商品类型准备一张发布队列表格，作为一个 Feed 提交。见属性与发布队列。
整体替换 Listing 安全吗？
listings_putListingsItem 会用你提交的内容替换整个 Listing，所以 AI 会先拉取当前属性（查看与搜索 Listing）。只改一个字段，用 patch。