Agent Skills
返回列表
🏢

Amazon Ads 授权与广告账户管理

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/linkfox-ai-linkfox-amazon-ads-auth-107。

技能介绍

要解决什么问题

在对接 Amazon Ads API 时,业务侧往往卡在入口:要用 LWA OAuth 完成授权、为各 marketplace 发现 profileId,并让访问令牌在约 1 小时 的有效期内可被下游安全复用。广告活动管理、报告拉取等能力都依赖同一套授权与账号维度,若把「取 token」和「选店」混在一处,很容易在 401 后反复试错或把长授权链从聊天窗口复制坏。

技能如何工作

本技能定位为 下游 skill 的前置依赖(如 linkfox-amazon-ads-manager、linkfox-amazon-ads-report),核心覆盖授权 URL 生成、授权后 token 存储与 profile 同步、已授权账号列表,以及 access token 刷新。

典型流程:

  • 新授权:先向用户索取非空的 accountName,再调用 authorize_url.py 生成 URL;用户于安全网络环境在浏览器完成授权后,系统保存 token 并同步 profile。
  • 一次授权多 profile:每个站点(US/UK/JP 等)对应一个 profileId;下游经 developerProxy 传入 profileId(及 region),由服务端注入 token,不要先通过 store_tokens.py 取 raw token 再自行拼装请求。
  • 令牌过期:下游返回 HTTP 401 时,用 refresh_token.py 续签后重试 proxy,仍只需 profileId。
  • 选店:用户用自然语言说「美国站」「我的店铺」时,Agent 应通过 authorized_stores.py 等解析 profileId,避免让用户背数字 ID;多账号同站点时需用 accountName 澄清。

脚本落盘与摘要输出策略(SESSION_ID、禁止写 /tmp)用于在大响应场景下按需用 jq 读本地 JSON,减少上下文膨胀。API 形态为 POST /amazonAds/{authorizeUrl|storeTokens|authorizedStores|refreshToken},字段与错误码见 references/api.md。

适用边界与注意点

  • 本技能不做:查/改广告活动、拉带指标的报告、店铺订单库存财务——分别交给对应下游或 linkfox-amazon-store-* 系列。
  • store_tokens.py 仅用于查看授权/令牌状态,不是下游 token 来源。
  • 授权链接约 270 字符,须从剪贴板或 ~/.cache/linkfox/last_authorize_url.txt 复制,避免终端软换行污染 client_id。
  • 回调 profile_sync_failed 通常表示广告后台未建经理账户并关联广告账户,需在 Amazon Ads 控制台处理后再授权。
  • 本工具 不消耗积分;若遇 401/402 或 API Key、余额类异常,按 references/onboarding.md 排查。

使用场景

  • 新接 Amazon Ads API,需生成授权链接并在浏览器完成 LWA 授权后同步各站点 profile
  • 已有多店铺授权,要用自然语言选「美国站」并解析 profileId 供广告管理 skill 调 developerProxy
  • 下游拉报告返回 HTTP 401,需按 profileId 刷新 access token 后不重登用户地重试
  • 上线前核对哪些 accountName 已授权、对应 countryCode 与 region,避免误用错店 token

适合人员

  • 维护 LinkFox/自研 Agent 广告链路的工程师,需要把授权与选店从业务 skill 里拆成稳定前置模块
  • 运营多站点 Amazon 广告的投手,要在对话里说站点名而非背 profileId,再交给报告或管理 skill 执行
  • 刚遇到授权 URL 400 或 profile_sync_failed、需要按 SKILL 排错文档定位经理账户与复制链问题的实施同学
  • 只读集成广告账户状态(令牌是否有效、过期时间),明确不碰改价建组的跨境 ERP 对接开发