# 查看与搜索 Listing (https://sellersheetai.com/zh/docs/mcp-api/workflows/listings-view)

> 搜索整个商品目录，找出被抑制或报错的 Listing，把全部结果拉进 Google 表格审核——也能查亚马逊上的任何 ASIN。



<Callout title="一句话">
  告诉 AI 你关心哪些 Listing——按关键词、ASIN、SKU、状态或问题——它会搜索你的目录、说明哪里出了问题，还能把清单写进表格供你逐条处理。
</Callout>

## 日常工作中 [#日常工作中]

<Steps>
  <Step>
    ### 找出有问题的 Listing [#找出有问题的-listing]

    “列出所有被抑制或有警告的 Listing。” `listings_searchListingsItems` 按状态和问题严重程度（ERROR 即被抑制）筛选你的目录，并返回亚马逊给出的原因。
  </Step>

  <Step>
    ### 细看某个 SKU [#细看某个-sku]

    `listings_getListingsItem` 返回亚马逊此刻对这个 SKU 的记录：属性、报价、状态和问题。
  </Step>

  <Step>
    ### 批量审核 [#批量审核]

    `listings_fetch_attributes_by_skus`（你的 SKU）和 `listings_fetch_attributes_by_asins`（任意 ASIN）一次拉取一批完整属性——在表格里做对比审核的起点。见[属性与发布队列](/zh/docs/mcp-api/workflows/listings-attributes)。
  </Step>

  <Step>
    ### 查亚马逊上的任何商品 [#查亚马逊上的任何商品]

    `catalogItems_searchCatalogItems` 按关键词或编码（ASIN、UPC、EAN）搜索亚马逊目录；`catalogItems_getCatalogItem` 返回某个 ASIN 的详情——竞品也可以。`listings_getListingsRestrictions` 告诉你某个 ASIN 能不能卖、能以什么成色卖。
  </Step>
</Steps>

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

> “列出我所有有问题或被抑制的 Listing。”

> “写进表格，被抑制的放在最前面。”

AI 会逐条列出问题和亚马逊给的原因——缺主图、受限类目待审批、缺商品描述——并把这些行写进你指定的表格。

## 搜索的两种调用方式 [#搜索的两种调用方式]

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

**MCP**——你说：“我哪些 Listing 被抑制了？” AI 带问题筛选条件调用 `listings_searchListingsItems`，翻完所有结果页，逐条解释。

<ToolCall tool="listings_searchListingsItems" args="{ with_issue_severity: [&#x22;ERROR&#x22;], included_data: [&#x22;summaries&#x22;, &#x22;issues&#x22;] }" lang="zh" />

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

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

<ToolList tools="[&#x22;listings_searchListingsItems&#x22;, &#x22;listings_getListingsItem&#x22;, &#x22;listings_fetch_attributes_by_skus&#x22;, &#x22;listings_fetch_attributes_by_asins&#x22;, &#x22;catalogItems_searchCatalogItems&#x22;, &#x22;catalogItems_getCatalogItem&#x22;, &#x22;listings_getListingsRestrictions&#x22;]" lang="zh" />

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

### AI 怎么翻到第二页之后？ [#ai-怎么翻到第二页之后]

它把每次结果里的翻页 token 传给下一次调用。见[分页](/zh/docs/mcp-api/paging)。

### 找到问题了，怎么修？ [#找到问题了怎么修]

在发布队列表格里改属性后提交——见[属性与发布队列](/zh/docs/mcp-api/workflows/listings-attributes)——或让 AI 用 patch 修改单个属性（[创建 Listing](/zh/docs/mcp-api/workflows/listings-create)）。