核心用法
本技能提供亚马逊卖家后台报告的端到端自动化获取能力，覆盖 95+ 种报告类型：库存报告（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）、FBA库存报告、Brand Analytics搜索词报告等。
标准执行流程：
1. 强制依赖检查 → 确认 linkfox-amazon-store-auth 已安装
2. 选店铺取令牌 → 委托依赖 skill 完成授权
3. 识别报告类型 → 按用户需求匹配官方 reportType 枚举
4. 执行自动化脚本 → python scripts/get_report.py 自动完成：请求→轮询→下载→解压→预览
5. 交付结果 → 输出 extractedFileHttpUrl（本机限时HTTP下载）、downloadPath（本地绝对路径）、fileName
支持自定义时间范围（dataStartTime/dataEndTime）、轮询参数（pollInterval/maxAttempts），完成后默认启动本机短时HTTP服务供浏览器下载已解压文件。
显著优点
- 全自动化闭环：告别手动登录Seller Central、逐一点击下载、手动解压的繁琐流程
- 报告类型全面：覆盖库存、订单、销售、财务、FBA、退货、品牌分析等95+种官方报告
- 智能轮询机制：自动处理 IN_QUEUE/IN_PROGRESS/DONE/FATAL 状态，默认30秒安全间隔
- 本地化交付：生成
file://URI 和本机HTTP直链，直接可用Excel/Numbers打开 - Hermes/OpenClaw 深度适配：内置多平台路径探测，支持外部技能目录配置
潜在缺点与局限性
- 强依赖授权技能：必须预先安装
linkfox-amazon-store-auth，无法独立运行 - 权限门槛高：Brand Analytics报告需品牌备案，部分报告类型对店铺资质有要求
- 时效性限制：财务类报告可能需10-30分钟生成，需调大 maxAttempts
- API速率限制：Reports API 约0.0222 req/s，高频调用需控制节奏
- 本机HTTP限时：extractedFileHttpUrl 默认300秒后失效，非持久化存储
- 失败不自动降级：指定报告类型失败时不会自动尝试替代类型，需用户决策
适合人群
- 亚马逊运营人员：需定期拉取多店铺、多类型报告进行数据分析
- 跨境电商数据分析师：需批量获取结构化销售/财务数据进行BI整合
- ERP/工具开发者：需自动化获取Amazon SP-API报告作为数据源
- 财务对账人员：需自动获取结算报告进行账务核对
常规风险
- 令牌过期风险：accessToken 1小时过期，脚本内部自动刷新，但极端情况下可能中断
- 权限403错误：缺少API权限或未加入Brand Registry时报告请求会被拒绝
- FATAL状态失败：店铺不支持该报告类型或数据不足时生成失败
- 敏感数据本地暴露：下载的报告含真实销售数据，临时文件需及时清理
- 路径白名单限制：后端 allowed-path-prefixes 必须显式允许 reports/2021-06-30/reports 路径
安全等级说明：依赖外部授权服务且处理真实店铺数据，需确保运行环境可信。