📦 Amazon Store 授权

Amazon 店铺授权与管理 本 skill 负责亚马逊卖家店铺的 OAuth 授权、已授权店铺列表、访问令牌获取与刷新，是拉取报告、查询库存、同步订单等所有下游操作的前置依赖。 📌 Related skill：如需拉取亚马逊店铺报告（库存/订单/销售/财务等），请切换至 linkfox-amazon-store-report。该 skill 依赖本 skill 提供的授权与令牌能力。

Core Concepts Selling Partner API 是亚马逊官方卖家接口。本 skill 负责 OAuth 2.0 授权流程与令牌生命周期管理：

• 授权流程：生成授权 URL → 用户在 Amazon 完成授权 → Amazon 回调并附带授权码 → 系统用授权码换取令牌 → 令牌安全保存。
• 店铺名（sellerName）必填：调用 /spApi/authorizeUrl 前必须获取非空店铺名，用于“已授权店铺列表”标记，禁止留空。
• 令牌生命周期：accessToken 通常 1 小时过期；refreshToken 用于续签新 accessToken。

Data Fields Authorization URL Response

• authorizeUrl string 浏览器打开的 Amazon 授权链接

Authorized Store Item

• sellerId string Amazon Seller ID
• sellerName string 店铺名（授权时必填）
• region string 市场区域代码 NA/EU/FE

Store Tokens

• accessToken string 调用接口凭证
• refreshToken string 续签 accessToken
• expiresIn integer 过期秒数
• tokenType string 通常为 "bearer"

Supported Regions NA 北美：美国、加拿大、墨西哥 EU 欧洲：英国、德国、法国、意大利、西班牙、荷兰等 FE 远东：日本、澳大利亚、新加坡、印度 默认区域 NA。

API Usage 经 LinkFox 网关调用，详见 references/api.md。

Available Scripts

• scripts/authorize_url.py 生成授权 URL（sellerName 必填）
• scripts/authorized_stores.py 列出已授权店铺
• scripts/refresh_token.py 刷新访问令牌
• scripts/store_tokens.py 查询店铺令牌（供下游 skill 使用）

Usage Scenarios Scenario 1 授权新店铺 用户：「我要授权我的亚马逊北美站点」 步骤：

• 询问 sellerName
• 调用 /spApi/authorizeUrl，传入 region 与 sellerName
• 返回 authorizeUrl，用户浏览器完成授权
• 可选调用 /spApi/authorizedStores 确认成功

Scenario 2 查看已授权店铺 用户：「列一下我已授权的亚马逊店铺」 步骤：调用 /spApi/authorizedStores，按 sellerId、region 排序展示

Scenario 3 刷新过期令牌 用户：「我店铺的令牌过期了，帮我刷新」 步骤：调用 /spApi/refreshToken，传入 sellerId（可选 region），返回新令牌并更新数据库

Scenario 4 查询店铺令牌 用户：「获取北美站点 A123 店铺的访问令牌」 步骤：调用 /spApi/storeTokens，传入 sellerId 与 region，返回令牌信息

Scenario 5 任何店铺操作前置流程 用户提出涉及卖家数据请求时：

• 列出已授权店铺
• 用户选择店铺
• 获取对应令牌
• 将 accessToken 交给下游 skill 执行具体操作

Display Rules

• 必须先有 sellerName 再生成授权链接
• 仅展示数据，不做业务建议
• 不明文显示完整令牌，仅展示前 10 字符掩码
• 授权失败时按错误码解释并给出建议
• 授权成功后可展示店铺基本信息

Important Limitations

• sellerName 必填且非空
• accessToken 1 小时过期，需及时刷新
• 每次授权与区域绑定，不同区域需分别授权
• 用户只能管理自己授权的店铺
• 系统回调 URL 必须在授权方白名单

User Expression & Scenario Quick Reference 适用： “授权我的亚马逊店铺” → 新店铺授权 “看看已授权的亚马逊店铺” → 列出已授权店铺 “令牌过期了” → 刷新令牌 “获取 XXX 店铺的访问令牌” → 查询令牌 “绑定我的亚马逊账号” → 新店铺授权

不适用： 拉取亚马逊报告 → 使用 linkfox-amazon-store-report listing 管理、订单处理、库存管理、广告投放 → 其他 skill

Boundary 本 skill 仅负责“授权+管店铺+管令牌+为下游准备 accessToken”。用户做具体业务时，先执行 Scenario 5 前置流程，再切换对应下游 skill，不得直接调 Amazon 接口。

Quick Reference APIs /spApi/authorizeUrl 生成授权链接（需 sellerName） /spApi/authorizedStores 查询已授权店铺列表 /spApi/refreshToken 刷新令牌 /spApi/storeTokens 获取店铺令牌

详细参数、错误码见 references/api.md；授权流程图见 references/authorization-flow.md；示例见 references/quick-start.md。

Feedback 功能不符、结果不符、用户不满或赞赏、任何改进点，按 references/api.md 规范调用 Feedback API 自动上报，勿打断主流程。

更多高质量跨境技能，请访问 LinkFox Skills。