# 创建 Listing (https://sellersheetai.com/zh/docs/mcp-api/workflows/listings-create)

> 按商品类型自己的结构在亚马逊上架新品——找到类型，填好必填属性，先校验，再提交。



<Callout title="一句话">
  AI 找到商品类型、读取它的结构、和你一起填属性，用亚马逊的校验预览检查一遍，然后才创建 Listing。
</Callout>

## 一步一步 [#一步一步]

<Steps>
  <Step>
    ### 找到商品类型 [#找到商品类型]

    “我要上架一款新瑜伽垫。” `productTypeDefinitions_searchDefinitionsProductTypes` 按关键词找到对应的亚马逊商品类型。
  </Step>

  <Step>
    ### 看亚马逊要求什么 [#看亚马逊要求什么]

    `productTypeDefinitions_getDefinitionsProductType` 返回该类型的完整结构——每个属性、哪些必填、允许的取值。
  </Step>

  <Step>
    ### 发布之前先校验 [#发布之前先校验]

    `listings_validate_rows` 对你的数据行运行亚马逊的校验预览，返回会出现的问题——不会上线任何内容。
  </Step>

  <Step>
    ### 创建或修改 Listing [#创建或修改-listing]

    `listings_putListingsItem` 创建 Listing（或整体替换）；`listings_patchListingsItem` 只修改现有 Listing 中你指定的属性。一次处理很多 SKU，用发布队列——见[属性与发布队列](/zh/docs/mcp-api/workflows/listings-attributes)。
  </Step>
</Steps>

## 可以这样问 [#可以这样问]

> “在运动类目下为一款新瑜伽垫创建 Listing——先用亚马逊的校验检查一遍。”

> “列出商品类型 SPORTING_GOODS 的必填属性。”

## 查结构的两种调用方式 [#查结构的两种调用方式]

同一个工具、同样的参数——通过 AI 客户端，或者从你自己的代码。

**MCP**——你描述商品；AI 调用 `productTypeDefinitions_searchDefinitionsProductTypes`，推荐最匹配的类型，问过你再继续。

<ToolCall tool="productTypeDefinitions_searchDefinitionsProductTypes" args="{ keywords: &#x22;yoga mat&#x22; }" lang="zh" />

<Callout type="warn" title="需要写权限">
  创建、替换或 patch Listing 都会改动你的卖家账户，所以该店铺需要写权限（见[掌控你的 AI](/zh/docs/mcp-api/control)）。搜索商品类型和读取结构只需读权限。
</Callout>

## 本页用到的工具 [#本页用到的工具]

构建时从工具目录读取，每个工具带有自己的权限标签。

<ToolList tools="[&#x22;productTypeDefinitions_searchDefinitionsProductTypes&#x22;, &#x22;productTypeDefinitions_getDefinitionsProductType&#x22;, &#x22;listings_validate_rows&#x22;, &#x22;listings_putListingsItem&#x22;, &#x22;listings_patchListingsItem&#x22;, &#x22;listings_deleteListingsItem&#x22;]" lang="zh" />

## 常见问题 [#常见问题]

### 能一次上架很多商品吗？ [#能一次上架很多商品吗]

可以——为商品类型准备一张发布队列表格，作为一个 Feed 提交。见[属性与发布队列](/zh/docs/mcp-api/workflows/listings-attributes)。

### 整体替换 Listing 安全吗？ [#整体替换-listing-安全吗]

`listings_putListingsItem` 会用你提交的内容替换整个 Listing，所以 AI 会先拉取当前属性（[查看与搜索 Listing](/zh/docs/mcp-api/workflows/listings-view)）。只改一个字段，用 patch。