LinkFox 亚马逊店铺报告自动化技能评估
核心用法
本技能提供亚马逊卖家后台报告的端到端自动化获取能力，覆盖请求→轮询→下载→解压→预览全流程。支持 95+ 种官方报告类型，包括库存报告（GET_MERCHANT_LISTINGS_ALL_DATA）、订单报告（GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL）、销售流量报告（GET_SALES_AND_TRAFFIC_REPORT）、FBA报告、财务结算报告（GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE）及 Brand Analytics 品牌分析类报告等。
使用时必须通过 linkfox-amazon-store-auth 完成店铺授权与令牌管理，主脚本 get_report.py 会自动处理令牌获取、报告轮询（默认30秒间隔）、文件下载解压，并在完成后启动本机短时HTTP服务生成 extractedFileHttpUrl 供浏览器直接下载已解压文件。
显著优点
1. 全流程自动化：单命令完成从请求到本地可预览文件的完整链路，无需手动处理 gzip 解压
2. 报告类型全覆盖：95+ 种官方报告类型，含 Brand Analytics 等高阶数据
3. 智能轮询机制：自动处理 IN_QUEUE/IN_PROGRESS/DONE/FATAL 等状态转换
4. 本机HTTP直链：默认启动限时本地服务，浏览器友好下载体验
5. 多区域支持：NA/EU/FE 三大区域及细分 marketplace 站点
潜在缺点与局限性
1. 强依赖约束：必须前置安装 linkfox-amazon-store-auth，无降级方案
2. Token 时效限制：accessToken 1小时过期，长耗时报告可能需重新取令牌
3. API 速率限制：Reports API 仅 0.0222 req/s，高频请求易触发限流
4. 报告生成时效：部分财务报告需 10-30 分钟，需调大 maxAttempts
5. 本机服务局限：extractedFileHttpUrl 仅限同一台机器访问，限时 5 分钟（可配置）
6. 权限门槛：Brand Analytics 需品牌备案，部分报告仅限 Vendor 账号
适合人群
- 亚马逊卖家运营人员需定期批量拉取经营数据
- 数据分析师需自动化获取结构化销售/库存/财务数据
- 跨境电商 ERP/BI 系统对接 Amazon SP-API 的开发者
- 需替代手动 Seller Central 下载的中大型卖家
常规风险
- 403/FATAL 失败：API 权限不足、未加入 Brand Registry 或店铺不支持该报告类型时直接失败，无自动降级
- 依赖链断裂：若授权 skill 异常，整个报告流程阻塞
- 数据泄露风险：本地 HTTP 服务虽限时，但需在可信环境运行
- 路径白名单限制：后端需预先配置
reports/2021-06-30/reports等路径前缀允许规则