按需报表
同步的数据不够时，直接向亚马逊申请报表——申请、等待、下载——并设置定期报表计划。
一句话
亚马逊提供的任何报表类型，AI 都可以申请生成、轮询到完成并读取文档。适合没有同步的报表，或你需要最新数据的时候。
申请、等待、下载
申请报表
reports_createReport 按报表类型和日期范围提交申请。AI 根据你的描述选择报表类型——“All Listings 报表”“品牌分析搜索查询表现”。
等亚马逊生成
亚马逊在后台生成报表，从几秒到很多分钟不等。reports_getReport 查询状态，完成后下载文档。
复用已有报表
reports_getReports 列出亚马逊已为该店铺生成的报表；reports_cancelReport 取消仍在排队的报表。
定期报表
reports_createReportSchedule 让亚马逊按固定周期生成报表；reports_getReportSchedules、reports_getReportSchedule 和 reports_cancelReportSchedule 列出、读取和停止计划。
可以这样问
“从亚马逊申请一份最新的库存报表。”
“拉品牌分析的搜索查询表现报告，看我的 ASIN 在这些词上的点击份额。”
“下载我最新的结算报表。”
一次申请的两种调用方式
MCP——你说：“给我一份最新的 All Listings 报表。” AI 调用 reports_createReport，再调用 reports_getReport 直到完成。
在 AI 客户端中（MCP）
{
"name": "reports_createReport",
"arguments": {
"store": "myStore-US",
"reportType": "GET_MERCHANT_LISTINGS_ALL_DATA"
}
}在代码中（Tool API）
curl -X POST https://api.sellersheetai.com/api/v1/tools/reports_createReport \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","reportType":"GET_MERCHANT_LISTINGS_ALL_DATA"}'定期计划需要写权限
创建或取消定期计划会改动卖家账户的设置，所以该店铺需要写权限（见掌控你的 AI）。单次申请和下载报表都是读取。
本页用到的工具
| 工具 | 权限 | 作用（英文） |
|---|---|---|
reports_cancelReport | read | Cancel a report Amazon has not started yet (processingStatus IN_QUEUE); an IN_PROGRESS report can no longer be cancelled. |
reports_cancelReportSchedule | destructive | Cancel a recurring report schedule. |
reports_createReport | read | Submit one SP-API report request; returns reportId at once. |
reports_createReportSchedule | write | Set up a recurring Amazon report. |
reports_getReport | read | Get one report's status; when DONE it returns a presigned download URL (data.documentUrl), never the rows — download and process the file yourself (no inline document, preview or s |
reports_getReports | read | List the SP-API reports Amazon already holds for the store. |
reports_getReportSchedule | read | Fetch one report schedule by its reportScheduleId. |
reports_getReportSchedules | read | List active report schedules for one or more reportTypes. |
常见问题
用已同步的还是按需申请？
先用已同步的——立即返回。见已同步报表。
AI 怎么知道报表的字段？
amazon-report 技能带有常用报表的类型、选项和字段名。见安装技能。
有 GraphQL 方式吗？
有——Data Kiosk。