# 按需报表 (https://sellersheetai.com/zh/docs/mcp-api/workflows/reports-ondemand)

> 同步的数据不够时，直接向亚马逊申请报表——申请、等待、下载——并设置定期报表计划。



<Callout title="一句话">
  亚马逊提供的任何报表类型，AI 都可以申请生成、轮询到完成并读取文档。适合没有同步的报表，或你需要最新数据的时候。
</Callout>

## 申请、等待、下载 [#申请等待下载]

<Steps>
  <Step>
    ### 申请报表 [#申请报表]

    `reports_createReport` 按报表类型和日期范围提交申请。AI 根据你的描述选择报表类型——“All Listings 报表”“品牌分析搜索查询表现”。
  </Step>

  <Step>
    ### 等亚马逊生成 [#等亚马逊生成]

    亚马逊在后台生成报表，从几秒到很多分钟不等。`reports_getReport` 查询状态，完成后下载文档。
  </Step>

  <Step>
    ### 复用已有报表 [#复用已有报表]

    `reports_getReports` 列出亚马逊已为该店铺生成的报表；`reports_cancelReport` 取消仍在排队的报表。
  </Step>
</Steps>

## 定期报表 [#定期报表]

`reports_createReportSchedule` 让亚马逊按固定周期生成报表；`reports_getReportSchedules`、`reports_getReportSchedule` 和 `reports_cancelReportSchedule` 列出、读取和停止计划。

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

> “从亚马逊申请一份最新的库存报表。”

> “拉品牌分析的搜索查询表现报告，看我的 ASIN 在这些词上的点击份额。”

> “下载我最新的结算报表。”

## 一次申请的两种调用方式 [#一次申请的两种调用方式]

**MCP**——你说：“给我一份最新的 All Listings 报表。” AI 调用 `reports_createReport`，再调用 `reports_getReport` 直到完成。

<ToolCall tool="reports_createReport" args="{ reportType: &#x22;GET_MERCHANT_LISTINGS_ALL_DATA&#x22; }" lang="zh" />

<Callout type="warn" title="定期计划需要写权限">
  创建或取消定期计划会改动卖家账户的设置，所以该店铺需要写权限（见[掌控你的 AI](/zh/docs/mcp-api/control)）。单次申请和下载报表都是读取。
</Callout>

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

<ToolList domains="[&#x22;reports&#x22;]" lang="zh" />

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

### 用已同步的还是按需申请？ [#用已同步的还是按需申请]

先用已同步的——立即返回。见[已同步报表](/zh/docs/mcp-api/workflows/reports)。

### AI 怎么知道报表的字段？ [#ai-怎么知道报表的字段]

`amazon-report` 技能带有常用报表的类型、选项和字段名。见[安装技能](/zh/docs/start/skills)。

### 有 GraphQL 方式吗？ [#有-graphql-方式吗]

有——[Data Kiosk](/zh/docs/mcp-api/workflows/datakiosk)。