LinkFox Amazon Store Report 综合评估
核心用法
本技能是亚马逊卖家后台报告的端到端自动化获取解决方案，完整覆盖报告生命全周期：请求 → 轮询状态 → 下载 → 解压 → 本地预览。支持 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搜索词报告等。
用户只需提供基础的店铺信息（sellerId、region、marketplaceIds）和目标报告类型，内置脚本 get_report.py 即可自动完成：从依赖技能获取 accessToken、提交报告请求、智能轮询处理状态（默认30秒间隔）、下载压缩文件、解压为可读TSV/CSV格式，并最终在本地启动短时HTTP服务，生成 extractedFileHttpUrl 供同一台机器的浏览器直接下载已解压文件。
显著优点
1. 全流程零干预：无需手动登录 Seller Central、无需处理gzip解压、无需关注API轮询细节
2. 报告类型覆盖极广：95+ 种官方报告类型，涵盖卖家运营所需的全部结构化数据维度
3. 本地化友好输出：自动解压 + 本机HTTP临时服务，浏览器即可下载，避免终端用户处理压缩文件
4. 智能依赖管理：内置 check_auth_dependency.py 脚本，自动检测前置技能 linkfox-amazon-store-auth 的安装状态
5. 灵活的参数控制：支持自定义时间范围、轮询间隔、最大尝试次数，适应不同报告的生成耗时差异
潜在缺点与局限性
1. 强依赖前置技能：必须依赖 linkfox-amazon-store-auth 完成店铺授权和令牌管理，无独立授权能力
2. 仅限已授权店铺：无法为未在 LinkFox 体系内完成 OAuth 授权的店铺拉取报告
3. 单区域单店铺限制：单次调用针对特定 sellerId + region 组合，多店铺需多次执行
4. 轮询时间成本：部分财务报告或大数据量报告可能需要10-30分钟生成，需调大 maxAttempts
5. 本地HTTP服务时效性：extractedFileHttpUrl 仅在运行脚本的同一台机器、在服务保持时间内（默认300秒）有效
6. API限流约束：Reports API 速率限制约0.0222 req/s，高频调用需自行控制节奏
适合人群
- 亚马逊FBA卖家：需要定期获取库存、订单、销售流量数据做运营分析
- 跨境电商运营团队：需自动化数据报表流程，替代手动下载 Seller Central 报告
- 财务/结算人员：需要自动获取 settlement report 进行账务对账
- 品牌备案卖家：需要获取 Brand Analytics 搜索词报告、ABA数据
- 数据分析师/开发者：需要将亚马逊店铺数据接入本地BI系统或数据仓库
常规风险
- 授权失效风险：accessToken 1小时过期，但脚本内部会自动获取最新令牌
- 报告生成失败：部分报告类型（如 Brand Analytics）需要品牌备案权限，否则返回403或FATAL
- 数据隐私注意：报告包含完整订单、客户信息，本地存储路径需做好访问控制
- 成本消耗：调用消耗 LinkFox 积分，但失败/空结果不会自动重试消耗额外积分
- 路径依赖风险：技能加载路径因运行环境（Claude/Cursor/OpenClaw/Hermes）而异，依赖检测脚本已内置多路径探测逻辑