查看与搜索 Listing
搜索整个商品目录，找出被抑制或报错的 Listing，把全部结果拉进 Google 表格审核——也能查亚马逊上的任何 ASIN。
一句话
告诉 AI 你关心哪些 Listing——按关键词、ASIN、SKU、状态或问题——它会搜索你的目录、说明哪里出了问题，还能把清单写进表格供你逐条处理。
日常工作中
找出有问题的 Listing
“列出所有被抑制或有警告的 Listing。” listings_searchListingsItems 按状态和问题严重程度（ERROR 即被抑制）筛选你的目录，并返回亚马逊给出的原因。
细看某个 SKU
listings_getListingsItem 返回亚马逊此刻对这个 SKU 的记录：属性、报价、状态和问题。
批量审核
listings_fetch_attributes_by_skus（你的 SKU）和 listings_fetch_attributes_by_asins（任意 ASIN）一次拉取一批完整属性——在表格里做对比审核的起点。见属性与发布队列。
查亚马逊上的任何商品
catalogItems_searchCatalogItems 按关键词或编码（ASIN、UPC、EAN）搜索亚马逊目录；catalogItems_getCatalogItem 返回某个 ASIN 的详情——竞品也可以。listings_getListingsRestrictions 告诉你某个 ASIN 能不能卖、能以什么成色卖。
可以这样问
“列出我所有有问题或被抑制的 Listing。”
“写进表格，被抑制的放在最前面。”
AI 会逐条列出问题和亚马逊给的原因——缺主图、受限类目待审批、缺商品描述——并把这些行写进你指定的表格。
搜索的两种调用方式
同一个工具、同样的参数——通过 AI 客户端，或者从你自己的代码。
MCP——你说：“我哪些 Listing 被抑制了？” AI 带问题筛选条件调用 listings_searchListingsItems，翻完所有结果页，逐条解释。
在 AI 客户端中（MCP）
{
"name": "listings_searchListingsItems",
"arguments": {
"store": "myStore-US",
"with_issue_severity": [
"ERROR"
],
"included_data": [
"summaries",
"issues"
]
}
}在代码中（Tool API）
curl -X POST https://api.sellersheetai.com/api/v1/tools/listings_searchListingsItems \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","with_issue_severity":["ERROR"],"included_data":["summaries","issues"]}'本页用到的工具
构建时从工具目录读取，每个工具带有自己的权限标签。
| 工具 | 权限 | 作用（英文） |
|---|---|---|
listings_searchListingsItems | read | Search and filter the seller's own listings catalog — the entry point for a suppressed-listing audit (with_issue_severity ['ERROR'] and included_data ['summaries', 'issues'], then |
listings_getListingsItem | read | Get the SELLER'S SUBMITTED attributes, status, and issues for a single listing SKU. |
listings_fetch_attributes_by_skus | read | Bulk fetch + flatten Amazon listings attributes for N OWNED SKUs in ONE call. |
listings_fetch_attributes_by_asins | read | Bulk fetch + flatten Amazon catalog attributes for N ASINs in ONE call. |
catalogItems_searchCatalogItems | read | Search Amazon's live catalog by keywords or by identifiers — what shoppers see, not one seller's submission. |
catalogItems_getCatalogItem | read | Get Amazon's LIVE catalog data for a single ASIN — the reconciled version that shoppers see on the detail page. |
listings_getListingsRestrictions | read | Check whether you are approved to sell an ASIN in a given condition. |
常见问题
AI 怎么翻到第二页之后？
它把每次结果里的翻页 token 传给下一次调用。见分页。
找到问题了，怎么修？
在发布队列表格里改属性后提交——见属性与发布队列——或让 AI 用 patch 修改单个属性（创建 Listing）。