核心功能
linkfox-amazon-store-report 是一款面向亚马逊卖家的专业数据自动化工具，提供 95+ 种官方报告的全流程无人值守获取：从报告请求、状态轮询、压缩包下载到自动解压，最终生成本地可访问的已解压文件链接。
显著优点
1. 端到端自动化：单条命令完成「请求→轮询→下载→解压→预览」完整链路，无需人工监控处理状态
2. 报告类型全覆盖：支持库存、订单、销售流量、FBA、财务结算、Brand Analytics、ABA搜索词等 95+ 种官方报告
3. 智能本地服务：完成后自动启动短时 HTTP 服务，生成 extractedFileHttpUrl，方便浏览器直接下载已解压文件
4. 依赖隔离设计：授权/令牌管理由独立 skill 负责，本 skill 专注报告业务，架构清晰
5. 多场景脚本支持：提供 get_report.py 推荐脚本与 check_auth_dependency.py 依赖检查工具
潜在缺点与局限性
- 强依赖约束：必须前置安装
linkfox-amazon-store-auth，未安装时无法执行任何报告任务 - 本机服务限制：
extractedFileHttpUrl仅限同一台机器访问，且默认 300 秒后自动失效 - API 速率限制：Reports API 约 0.0222 req/s，轮询间隔默认 30 秒，大型报告可能需要较长等待
- Token 生命周期：accessToken 1 小时过期，虽脚本内部自动刷新，但超长任务仍需关注
- 成本计费：每次调用消耗积分，失败不会自动重试或换关键词，需用户确认后继续
适合人群
- 亚马逊卖家及运营团队，需定期批量导出店铺数据
- 跨境电商 ERP 开发者，需集成官方报告获取能力
- 数据分析师，需自动化获取结构化运营数据
常规风险
- 权限失败：403 错误通常因缺少 API 权限或未加入 Brand Registry
- 报告类型不支持：
FATAL状态可能因店铺类型（SC/Vendor）或数据不足 - 数据安全：虽日志中会掩码 accessToken，但仍需确保运行环境可信
- 路径依赖：后端需配置
sp-api.developer-proxy.allowed-path-prefixes白名单
使用建议
首次使用前务必运行依赖检查，确认 linkfox-amazon-store-auth 已就绪；大型财务报告建议调高 maxAttempts 与 pollInterval；生产环境建议关闭 includeAmazonSourceUrl 避免暴露源地址。