📦 Amazon Ads Auth — Amazon Ads 身份验证

Amazon Ads 授权与广告账户管理 Amazon Ads 的授权（LWA OAuth）、profile 发现、访问令牌管理。下游 skill 的前置依赖。 下游：linkfox-amazon-ads-entity（实体查询）、linkfox-amazon-ads-report（报告）。

核心概念 授权流程：生成 URL → 用户浏览器授权 → 系统存 token + 同步 profile 一次授权多 profile：每个 marketplace（US/UK/JP…）一个 profileId；下游调用必须带 profileId accountName 必填：调 authorize_url.py 前必须问用户要一个非空账号名 accessToken 1 小时有效；过期后下游返回 HTTP 401，可用 refresh_token.py 续签

可用脚本 脚本 作用 authorize_url.py 为新账号生成授权 URL（accountName 必填） authorized_stores.py 列出已授权的账号 × 站点（按 profileId 聚合） profiles.py 列 profile 列表（refresh=true 穿透上游刷新） refresh_token.py 刷新 accessToken store_tokens.py 查 token（供下游使用） 入参、响应字段、错误码见 references/api.md。

支持区域 NA（美加墨巴） / EU（英德法意西荷印度中东等） / FE（日澳新）。默认 NA。

使用场景

• 新授权账号

问用户要 accountName（非空字符串，用于识别） 调 authorize_url.py 拿 URL → 给用户在浏览器打开 授权完成后系统自动存 token + 同步 profile 可选：调 authorized_stores.py 确认

• 列已授权账号

调 authorized_stores.py，展示 profileId / accountInfoName / countryCode / region。

• 刷新过期令牌

下游返回 HTTP 401 或含 expired / unauthorized 时，调 refresh_token.py（传 profileId 或 authRecordId）。

• 给下游解析 profileId（高频）

用户只说自然语言（"美国站"、"我的店铺"），不要让用户报 profileId 数字。

用户上下文 Agent 动作 只授权 1 个账号 按 countryCode 直接定位，不问 授权 ≥ 2 个账号 + 只说站点 按 accountName 向用户澄清 同时给出 accountName + 站点 直接定位 显式给出 profileId 数字 直接用 站点关键词映射参考（以 authorized_stores 真实 countryCode 兜底）： 美国 / US → US；英国 / UK → UK；日本 / JP → JP；德国 / DE → DE 静默原则：映射成功时不播报 profileId 数值；仅在歧义或失败时向用户开口。

调用原则 先问 accountName 再调 authorize_url.py 不输出完整 accessToken / refreshToken；脚本已做掩码，不要在摘要里还原 授权失败按错误码解释原因；不擅自重试

常见问题 授权链接打开报 400，client_id 看起来被污染 现象：URL 里 client_id 中间出现空格 / +，Amazon 报 StegoRuntimeOAuth2ClientManager:getClientDefinition。 原因：授权链接 ~270 字符，从终端 / 聊天窗口复制时被软换行插入空格。 解决：authorize_url.py 成功后会同步写到剪贴板 + ~/.cache/linkfox/last_authorize_url.txt，从这两处复制；浏览器地址栏 Ctrl+V 即可。建议无痕窗口打开。

授权回调页显示 profile_sync_failed 原因：当前 Amazon 账号未在广告后台创建"经理账户（Manager Account）"并关联广告账户。 解决：登录 Amazon Ads 控制台 → Manager accounts → 关联账户，重新授权。

Not Applicable 查广告活动 / 组 / 关键词 / 商品广告 / 定向 → linkfox-amazon-ads-entity 拉广告报告（含指标） → linkfox-amazon-ads-report 修改 / 创建 / 删除广告 → 本系列为只读 店铺订单 / 库存 / 财务 → linkfox-amazon-store-*

反馈： 自动检测和报告反馈通过 Feedback API，当以下情况发生时： 该 skill 的功能或目的与实际行为不符 该 skill 的结果不符合用户的意图 用户对该 skill 表示不满或赞赏 您认为可以改进的任何内容 按照 references/api.md 中指定的方式调用反馈 API，不要打断用户的流程。 更多高质量的专业跨境电商技能，请访问 LinkFox Skills。