核心用法
本 Skill 提供亚马逊 SP-API 报告的全流程自动化获取能力，覆盖库存、订单、销售流量、FBA、财务结算、Brand Analytics 等 95+ 种报告类型。执行路径为：请求报告 → 自动轮询状态 → 下载 → 解压 → 生成本地可访问链接，全程无需人工干预。
显著优点
- 端到端自动化：单次调用即可完成从请求到本地文件就绪的全过程，内置智能轮询（默认30秒间隔、20次重试，可配置）
- 报告类型全覆盖：支持
GET_MERCHANT_LISTINGS_ALL_DATA、GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL、GET_SALES_AND_TRAFFIC_REPORT、GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE等几乎所有亚马逊官方报告 - 本地化友好：完成后默认启动本机短时 HTTP 服务（300秒），生成
extractedFileHttpUrl供浏览器直接下载已解压文件，同时提供绝对路径和 file:// URI - 灵活配置：支持自定义时间范围、轮询参数、多站点批量获取
潜在缺点与局限性
- 强依赖前置组件：必须预先安装
linkfox-amazon-store-auth完成店铺授权与令牌管理，否则完全无法使用 - 单站速率限制：Reports API 限制约 0.0222 req/s（约45秒/次），高频请求需自行控制节奏
- 报告生成时效不定：部分财务报告需10-30分钟，需合理设置
maxAttempts - 本机 HTTP 服务局限：
extractedFileHttpUrl仅限同一台机器访问，且限时有效，非持久化存储方案 - Token 时效：accessToken 1小时过期，虽脚本自动刷新，但极端长任务存在中断风险
适合人群
- 亚马逊运营人员：需定期获取库存、订单、销售数据做分析
- 电商数据分析师：需要结构化原始报告进行 BI 加工
- 财务对账人员：自动化获取结算报告、退款数据
- 品牌卖家：需拉取 Brand Analytics 搜索词报告进行关键词研究
常规风险
- 权限风险：403 错误通常因缺少 API 权限或未加入 Brand Registry
- 报告失败处理：
FATAL状态可能因店铺类型不支持或数据不足，需人工判断重试或换类型 - 成本消耗：每次调用消耗积分，失败/空结果不会自动重试或换关键词，需用户确认后再继续
- 数据安全：脚本会本地落盘完整响应，含敏感商业数据，需注意工作目录权限管理