用途:一站式拉取亚马逊广告报告,覆盖 SP/SB/SD 全部报告类型(以 references/report-types/ 下 .md 为准,ST/DSP 暂未覆盖)。脚本经 developerProxy 传 profileId,自动完成报告创建、等待(约 2–10 分钟)、下载和解压,返回可读结构化数据。
主要能力:单脚本 get_report.py 覆盖 SP/SB 全部 adProduct;check_auth_dependency.py 检测依赖。脚本不做列与分组的业务判断,需 agent 先查 references/report-types/ 对应 .md,再显式传入 adProduct/groupBy/columns。
使用方式:依赖 linkfox-amazon-ads-auth(未安装 exit 42)。多账号须先调 authorized_stores.py 拉授权清单,按站点匹配 profileId;单候选静默使用,多候选须用 accountName 向用户澄清,0 候选引导授权,严禁让用户直接报 profileId。调用:python scripts/get_report.py '<JSON 参数>' [--inline]。API 端点 POST /amazonAds/developerProxy。输出默认写入 <cwd>/linkfox/<日期>/<session>/data/,≤8KB 全量打印,>8KB 仅摘要,--inline 强制全量。
适用场景:按用户意图选 reportTypeId(如花费→spCampaigns,搜索词→spSearchTerm),支持轮询已有 reportId 恢复超时任务,HTTP 425 重复请求自动转轮询。
限制:日期跨度多数 31 天,回溯窗口 SP 95 天、SB 60 天,数据延迟约 12 小时;空数据不等于报错。超时返回 STILL_PROCESSING(exit 2)非失败,须询问用户是否续等。失败不得自动换词或试探。不消耗算力。Brand Analytics、报告删除修改、实体元数据、授权 token 均不在本技能范围。连续 400/403/404/429 会触发 450/453/454/459 保护冷却,须停止重试并说明。