用途:处理 Amazon Ads 的授权(LWA OAuth)、profile 发现与访问令牌管理,是 linkfox-amazon-ads-manager(广告管理)、linkfox-amazon-ads-report(报告)等下游技能的前置依赖。
主要能力:生成授权 URL;列出已授权账号×站点(按 profileId 聚合);列 profile 列表;刷新 accessToken;查询授权/令牌状态;按 authRecordId 解绑广告连接。一次授权可自动发现并绑定同账号下所有可用站点的广告 profile,每个 marketplace 对应一个 profileId,下游调用必须携带 profileId。accessToken 有效期 1 小时,过期后下游返回 HTTP 401,可用 refresh_token.py 续签。
使用方式:API 端点 POST /amazonAds/{authorizeUrl|storeTokens|authorizedStores|refreshToken|cancelAuthorization};Python 脚本 python scripts/<脚本名>.py '<JSON 参数>' [--inline]。调 authorize_url.py 前必须先向用户确认一个非空账号名称(accountName)。下游业务技能经 developerProxy 传 profileId(+region),服务端注入 token,不要先取 raw token。响应默认落盘到 <cwd>/linkfox/<日期>/<session>/data/,大于 8 KB 时 stdout 只输出摘要,可用 --inline 强制全量打印。
适用场景:新账号授权、查询已授权账号、刷新过期令牌、为下游解析 profileId、解绑广告连接。支持区域 NA/EU/FE,默认 NA。
限制:本系列为只读,不修改/创建/删除广告;查广告活动、拉报告、店铺订单库存财务等应使用对应其他技能。授权链接约 270 字符,复制时易被插入空格导致 400,建议从剪贴板或 ~/.cache/linkfox/last_authorize_url.txt 复制。回调显示 profile_sync_failed 通常因未创建经理账户并关联广告账户。同一广告账号/profile 连续触发 400/403/404/429 时网关返回 450/453/454/459 并短暂冷却,需停止自动重试并按提示修正参数或授权。本工具不消耗算力。未配置 API Key 或遇 401/402 时按 onboarding 指引处理。