LinkFox Amazon 店铺报告获取技能评估
核心用法
本 skill 提供亚马逊卖家后台报告的端到端自动化获取，覆盖 Report API 全生命周期：请求 → 轮询 → 下载 → 解压 → 本地预览。支持 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 系列等。
核心执行脚本 scripts/get_report.py 实现全自动流程：内部调用依赖 skill 获取 accessToken → 向 /spApi/developerProxy 发起报告请求 → 按配置间隔轮询 processingStatus → DONE 后获取下载 URL → 下载并解压 gzip TSV → 默认启动本机短时 HTTP 服务（默认 300 秒）供浏览器下载已解压文件。输出包含 downloadPath（本地绝对路径）、localFileUri（file:// 协议 URI）、extractedFileHttpUrl（限时本机 HTTP 链接）等字段。
显著优点
1. 全流程自动化：无需手动处理 Reports API 的复杂状态机，轮询间隔、重试次数可配置（默认 30s/20 次）
2. 报告类型覆盖全面：95+ 种类型，涵盖卖家运营核心数据场景
3. 多区域支持：NA/EU/FE 三大区域，支持多 marketplace ID 同时请求
4. 灵活的 reportOptions 支持：Brand Analytics 的 reportPeriod/asins、销售流量的 dateGranularity 等参数均有独立配置文档
5. 本地化输出友好：除文件路径外，额外提供 HTTP 直链便于非技术用户浏览器下载
潜在缺点与局限性
1. 强制依赖单一外部 skill：必须预先安装 linkfox-amazon-store-auth，且无法自主完成授权/令牌管理；依赖缺失时整个流程阻断
2. 本机 HTTP 服务限制：extractedFileHttpUrl 仅限同一台机器访问，团队协作场景下实用性受限
3. Rate limit 约束：Reports API 约 0.0222 req/s（约 1 次/45 秒），高频调用需自行控制并发
4. Token 有效期敏感：accessToken 1 小时过期，超长报告（如财务结算报告可能需 10-30 分钟生成）存在超时风险，虽脚本内部自动刷新但极端场景仍可能中断
5. 无内置数据解析：仅完成下载解压，TSV/JSON 解析需用户自行处理
适合人群
- 亚马逊卖家运营人员：需定期拉取库存、订单、财务数据做内部分析
- 跨境电商数据分析师：需要自动化数据 pipeline 源头
- ERP/工具开发者：集成 Amazon SP-API Reports 功能，不愿自建轮询与下载逻辑
常规风险
1. 授权权限风险：Brand Analytics、Vendor 类报告需对应账号权限；403 错误常见原因为未加入品牌备案或账号类型不符
2. 数据合规风险：财务报告含敏感交易信息，本地 HTTP 服务虽限时但仍需注意内网安全
3. 报告失败处理：文档明确禁止自动 fallback 到其他报告类型，失败时需人工介入决策
4. 依赖维护风险：若 linkfox-amazon-store-auth 更新导致接口变动，本 skill 同步失效
安全等级：S（依赖外部授权，但敏感操作均在本地完成，HTTP 服务限时）
来源可信度：T2（LinkFox 商业技能，有明确文档与版本管理）