用途:面向亚马逊卖家,实现店铺报告从请求到下载解压的端到端自动化,覆盖库存、订单、销售与流量、财务结算、FBA、退货、Brand Analytics 等 95+ 种报告类型。
主要能力:通过脚本或 /spApi/developerProxy 接口完成报告生命周期——请求报告、轮询处理状态(IN_QUEUE/IN_PROGRESS/DONE/FATAL/CANCELLED)、获取下载链接、下载并解压;输出本地绝对路径 downloadPath、文件名 fileName、本机 file URI,并默认启动短时本机 HTTP 服务生成 extractedFileHttpUrl,供同机浏览器下载已解压文件。常用报告类型如 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。
使用方式:先做依赖检查,读取 linkfox-amazon-store-auth/SKILL.md,或运行 python scripts/check_auth_dependency.py(缺失时以 exit code 42 退出并输出 DEPENDENCY_MISSING)。授权与选店铺交由该依赖技能,确定 sellerId 与 region(NA/EU/FE),再执行 python scripts/get_report.py '<JSON 参数>',可传 reportType、marketplaceIds、dataStartTime、dataEndTime、pollInterval、maxAttempts 等。手动流程可用 reports/2021-06-30 相关路径。
适用场景:按指定报告类型和站点、时间段拉取库存、订单、销售流量、财务、FBA、Brand Analytics 等报告并下载到本地。
限制:必须依赖 linkfox-amazon-store-auth,未安装需先安装;服务端令牌约 1 小时过期,可刷新后重试;Reports API 约 0.0222 req/s,默认 30s 轮询;部分财务报告可能需 10–30 分钟;后端路径白名单须允许 reports/2021-06-30/reports;用户指定报告失败时不得自动换类型;不输出 raw token;本机 HTTP 链接仅同一台电脑、限时有效。本技能不消耗算力。