连接 Amazon 店铺后，StoreClaw 可以在您授权的范围内读取订单、库存、商品、评价等数据，用于经营分析、经营简报和自动化任务。
本文说明如何通过 Amazon 官方 OAuth 授权连接 StoreClaw。OAuth 是推荐连接方式，不需要手动创建应用或复制 LWA Client ID、LWA Client Secret、Refresh Token 等凭证。若您的账号暂时无法使用 OAuth，也可以使用手动凭证连接作为备用方式。
StoreClaw 仅在您授权的范围内读取 Amazon 店铺数据。连接过程不会修改、删除或发布您的 Amazon 店铺数据。
目前 StoreClaw 支持通过两种方式连接 Amazon 店铺：
- Amazon OAuth 授权（推荐）
- 手动凭证连接
推荐方式：通过 Amazon OAuth 授权连接
如果您的 StoreClaw 页面已经显示 Amazon 授权入口，建议优先使用 OAuth 授权。该方式不需要手动创建应用，也不需要复制 LWA Client ID、LWA Client Secret 或 Refresh Token，整体流程更短，也更不容易填错。
OAuth 授权前请确认
在开始操作前，请确认您满足以下条件：
- 您使用的是 Amazon 专业卖家账号（Professional Seller Account）。
- 您当前登录的是主账号，或者已被主账号授予应用授权权限。
- 您知道本次要连接的是哪个 Seller ID。
- 如果您运营多个 Seller ID，请确认当前登录账号对应的是要连接到 StoreClaw 的那个 Seller ID。
OAuth 授权流程
- 登录 StoreClaw，进入 连接器。
- 找到 Amazon，点击 连接 Amazon。
- 在弹窗中选择您售卖的区域，例如北美、欧洲或远东地区。
- StoreClaw 会根据您选择的区域，跳转至对应的 Amazon 卖家中心官方授权页面。
- 使用需要连接的 Amazon 卖家账号登录。
- 在 Amazon 授权页面选择要授权的卖家账号和市场。
- 确认授权范围后，点击同意授权。
- 授权完成后，页面会自动返回 StoreClaw。
- 回到 StoreClaw 后，确认 Amazon 连接状态显示为 已连接。
关于 Seller ID 与市场选择
Amazon 的联合授权页面可能会要求您选择一个市场，但 StoreClaw 的 Amazon 连接是按 Seller ID 维度管理的。
也就是说：
- 同一个 Seller ID 只需要完成一次授权。
- 只要 StoreClaw 获得该 Seller ID 的授权，就可以在授权范围内读取该 Seller ID 下的所有可访问市场数据。
- 如果一个 Seller ID 同时经营美国站、加拿大站、墨西哥站等市场，授权成功后，StoreClaw 会按该 Seller ID 识别并支持这些市场。
- 如果您有多个 Seller ID，从 Amazon 授权逻辑上通常需要分别授权。
因此，当 Amazon 授权页面只能单选市场时，请选择当前要连接的卖家账号下任一需要使用的市场继续授权。这个选择主要用于完成 Amazon 授权流程，不代表 StoreClaw 只能读取这一个市场。
当前支持范围
请注意：目前 StoreClaw 一个账号只能连接一个 Amazon Seller ID。
如果您同时运营多个 Seller ID，请优先选择当前最需要用于经营分析、简报和自动化任务的 Seller ID 完成授权。我们预计在下一个版本支持多个 Seller ID 分别授权，届时您可以为不同 Seller ID 分别建立连接。
授权完成后可以做什么
授权成功后，StoreClaw 可以在您授权的范围内读取 Amazon 数据，用于：
- 店铺经营分析
- 每日或每周经营简报
- 商品、库存、订单、评价等维度的诊断
- 自动化运营任务和异常提醒
StoreClaw 不会未经您确认修改 Listing、价格、库存、广告、促销或其他会影响店铺状态的内容。
可选方式：手动凭证连接
如果您的账号暂时无法使用 OAuth 授权，或者 StoreClaw 团队要求您使用手动方式排查连接问题，可以通过 Amazon SP-API 手动获取连接所需凭证。
手动连接通常需要完成以下 5 个阶段：
- 准备账号与资料。
- 完成开发者资料注册或审核。
- 创建应用。
- 获取 Seller ID、LWA Client ID、LWA Client Secret 和 Refresh Token。
- 将凭证填写到 StoreClaw。
提示：手动连接里最耗时的部分通常是亚马逊对开发者资料的审核。建议优先启动审核，等待期间再继续熟悉后续步骤。
手动连接前请确认
在开始操作前，请确认您满足以下条件：
- 您使用的是 Amazon 专业卖家账号（Professional Seller Account）。
- 您当前登录的是主账号，或者已被主账号授予开发应用权限。
- 您已明确本次要接入的 Seller ID。
- 您已明确本次要接入的站点区域，例如北美站（NA）、欧洲站（EU）或远东地区（FE）。
注意：StoreClaw 按 Seller ID 管理 Amazon 授权。如果同一个 Seller ID 下包含多个市场，StoreClaw 会在授权范围内支持读取该 Seller ID 下的所有可访问市场。
建议提前准备的信息
为了避免中途卡住，建议在正式开始前先准备好这些资料：
- 公司注册名称。
- 公司营业执照或商业登记信息，例如注册号、注册地址、法定代表人信息等。
- 法人或账号管理员的身份证件信息。
- 公司官网 URL。
- 企业邮箱和技术联系人姓名。
- 计划接入的 Amazon 店铺名与所属站点，例如北美站、欧洲站或远东地区。
- StoreClaw 使用 Amazon 数据的业务说明，例如用于店铺经营分析、库存分析、订单分析、商品表现分析、经营简报和自动化任务。
手动连接流程
阶段一：进入 Develop Apps
- 登录 Amazon Seller Central。
- 在顶部或侧边导航中找到 Apps and Services。
- 进入 Develop Apps。
- 如果您还没有开发者资料，需要先完成开发者资料填写和审核。
如果看不到 Develop Apps，请检查当前账号是否是主账号，或者是否拥有开发应用相关权限。
阶段二：完成开发者资料注册或审核
这是整个流程里最关键、也最可能耗时的部分。只有开发者资料通过审核后，您才能继续创建正式应用。
填写开发者资料
如果这是该账户第一次使用开发应用能力，系统会要求您完成开发者资料或新版 Solution Provider Portal 的入驻流程。
填写时请重点关注以下几部分：
- 联系信息（Contact Information）： 建议填写真实、稳定可收信的企业邮箱。
- 应用类型选择： 如页面要求选择应用类型，请参考下方“选择应用类型”说明。普通商家连接自己店铺时，通常选择 Private application / Private developer。
- 数据访问角色（Data Access / Roles）： 这些角色决定 StoreClaw 可以读取哪些数据。
- 安全问卷（Security Questionnaire）： Amazon 会询问数据加密、访问控制、日志保留、员工权限、泄露响应等问题。
选择应用类型
在 Amazon Solution Provider Portal 或开发者资料页面中，如果需要选择应用类型，请选择 Private application / Private developer。
该方式适用于商家为自己的 Amazon 店铺创建内部接入应用，并将授权信息用于 StoreClaw 读取已授权的店铺数据。
不要选择 Public application，除非您要开发一个面向其他 Amazon 卖家的公开应用，并计划通过 OAuth 授权流程和 Amazon 相关审核面向外部卖家提供服务。
简单来说：
- 如果您只是要把自己的 Amazon 店铺连接到 StoreClaw，请选择 Private application / Private developer。
- 如果您是软件服务商，要开发一个给多个 Amazon 卖家使用的公开应用，才需要考虑 Public application。
选择数据访问角色
数据访问角色决定 StoreClaw 可以读取哪些 Amazon 店铺数据。建议根据您希望 StoreClaw 分析的业务范围选择角色。
对于 StoreClaw 的基础经营分析、库存分析、订单简报和商品分析，建议优先选择以下角色：
- Product Listing（商品目录）： 用于读取商品和 Listing 信息。
- Pricing（商品定价）： 用于读取商品价格、销售价和价格相关数据。
- Inventory and Order Tracking（库存和订单）： 用于读取库存和订单状态相关数据。
- Amazon Fulfillment（FBA 履约）： 用于读取 FBA 履约、库存和配送相关数据。
- Buyer Communication（买家消息）： 如需分析买家沟通或消息相关数据，可选择该角色。
- Tax Invoicing（税务发票）： 如需处理发票或税务相关分析，可按站点需要选择。
- Tax Remittance（税款申报）： 如需处理税款申报相关分析，可按站点需要选择。
说明： 角色越完整，StoreClaw 后续可分析的数据范围越完整；但部分角色可能需要更严格的审核。请根据实际业务需要选择，并以 Amazon 页面最终可选项和审核结果为准。
注意： 如果某个角色暂时没有获批，您仍然可以先完成其他已获批角色的连接。未授权的数据范围不会被 StoreClaw 读取，对应分析能力可能不可用或结果不完整。
填写安全问卷
安全问卷通常是审核中的重点部分，也是最容易导致资料被退回的环节之一。常见问题通常会涉及：
- 数据加密方式
- 访问控制机制
- 日志留存时间
- 员工权限管理
- 数据泄露响应流程
如果您不确定如何填写，建议先向 StoreClaw 客户成功团队获取标准答复模板后再提交。
提交并等待审核
提交后，系统通常会进入审核状态。审核结果一般会发送到您在资料中填写的联系邮箱。
常见审核周期：
- 开发者资料审核： 约 3–5 个工作日
审核通过后，您通常会看到可以继续创建应用的入口，例如 Add new application、Add new app client 或类似按钮。
阶段三：创建应用
审核通过后，返回开发应用页面并创建您的第一个应用。
- 回到 Develop Apps 或 Solution Provider Portal 页面，找到应用列表区域。
- 点击 Add new application、Add new app client 或同类按钮，开始创建应用。
- 根据页面提示填写应用信息。
创建应用时通常需要填写：
- App Name（应用名称）： 建议填写
StoreClaw - [你的公司简称]，方便未来识别。 - API Type（API 类型）： 选择
Selling Partner API。 - App Type（应用类型）： 选择
Production（生产环境）。
创建时请注意环境类型：
- Sandbox： 仅返回测试数据，用于开发调试。
- Production： 返回真实店铺数据，供 StoreClaw 使用。
注意： 如果您是为了连接 StoreClaw，请优先确认后续授权和数据读取使用的是 Production 环境。仅创建 Sandbox 应用会导致拿到的只是测试数据。
阶段四：获取 StoreClaw 所需的 4 项凭证
应用创建完成后，在应用详情页中依次提取全部凭证。
您需要获取并保存以下 4 项信息：
- Seller ID
- LWA Client ID
- LWA Client Secret
- Refresh Token
1. 获取 Seller ID
Seller ID 是 Amazon 卖家账号的唯一标识，也可能在部分页面中显示为 Merchant Token 或卖家记号。
您可以在应用详情页或卖家中心相关账户信息页面中找到它。
常见路径如下：
- 点击右上角的设置图标，选择 账户信息。
- 在左侧导航栏中，选择 业务信息。
- 点击 您的卖家记号。
- 在卖家记号页面，找到
Seller ID。 - 复制
Seller ID到 StoreClaw。
复制时请注意：
- 不要带入前后空格。
- 保持完整，不要截断。
- 请确认填写到 StoreClaw 的 Seller ID 与您要连接的店铺一致。
2. 获取 LWA Client ID 和 LWA Client Secret
在应用详情页中找到 LWA credentials 区域：
- Client identifier 就是
LWA Client ID。 - Client secret 就是
LWA Client Secret。
注意： LWA Client Secret 相当于密码。不要发到群聊、公开文档或截图传播，建议复制后直接填写到 StoreClaw。
3. 获取 Refresh Token
Refresh Token 是 4 项凭证中最关键的一项，用于让 StoreClaw 后续读取您的店铺数据。
通常做法是在应用详情页中点击 Authorize、Self Authorize、Create Token 或相近按钮。
授权完成后，页面会返回一串很长的令牌，这就是 Refresh Token。
重要： Refresh Token 往往只在生成当下完整显示一次。请务必立刻复制并保存。如果忘记复制，通常需要重新走一次授权流程，旧 Token 可能会失效。
4. 提取前的检查清单
在离开 Amazon 后台前，请确认以下 4 项都已经复制完成：
| 凭证 | 说明 |
|---|---|
Seller ID |
卖家编号 |
LWA Client ID |
应用身份编号 |
LWA Client Secret |
应用密钥 |
Refresh Token |
授权令牌 |
阶段五：将凭证填写到 StoreClaw
拿到 4 项凭证后：
- 回到 StoreClaw。
- 进入 连接器。
- 找到 Amazon。
- 选择手动凭证连接方式。
- 填写 Seller ID、LWA Client ID、LWA Client Secret 和 Refresh Token。
- 点击连接。
- 确认连接状态显示为 已连接。
如果连接失败，请优先检查以下信息：
- Seller ID 是否与授权账号一致。
- LWA Client ID 是否复制完整。
- LWA Client Secret 是否复制完整。
- Refresh Token 是否复制完整。
- 当前应用是否已完成审核并具备所需权限。
- 当前 Seller ID 是否属于您要连接的 Amazon 店铺。
安全说明
StoreClaw 只读取您授权范围内的数据，用于经营分析、简报和自动化任务。
StoreClaw 不会未经您确认执行以下操作：
- 修改或发布 Listing。
- 调整价格。
- 修改库存。
- 创建或修改促销。
- 调整广告预算或出价。
- 删除、发布、购买、激励或操纵评价。
您可以在 Amazon Seller Central 或 StoreClaw 中管理连接状态。如果不再使用 StoreClaw，可以断开连接或取消授权。
常见问题 (FAQ)
Q：Develop Apps 菜单是灰的，或者根本看不到，怎么办？
A： 通常是账号类型或权限问题。请依次检查：是否是 Amazon 专业卖家账号、是否用主账号登录、如果是子账号，是否已被授予开发应用权限。
Q：审核被拒了怎么办？
A： Amazon 通常会在通知邮件里说明原因。最常见的问题包括联系邮箱无效、安全问卷填写不规范，以及公司信息与注册资料不一致。修正后可重新提交。
Q：我忘记复制 Refresh Token 了，页面已经关掉怎么办？
A： 一般可以回到应用详情页，再次点击授权或生成 Token 的入口，重新走一遍流程。新生成的 Refresh Token 可能会替代旧 Token。
Q：Refresh Token 会过期吗？
A： 正常情况下它可以长期使用。但如果您主动撤销授权、修改应用关键权限，或 Amazon 判定存在异常使用行为，Token 可能失效。此时重新执行授权流程即可。
Q：这个流程收费吗？
A： Amazon 官方的开发者注册和 SP-API 接入本身通常不单独收费。StoreClaw 的费用则取决于您的订阅方案和接入店铺数量。
Q：我可以连接多个 Amazon 店铺吗？
A： 目前，每个 StoreClaw 账号仅支持连接 1 个 Amazon Seller ID。
如果该 Seller ID 下包含多个可访问市场，StoreClaw 会在授权范围内支持读取这些市场的数据。
如果您有多个 Seller ID，请优先连接当前最需要用于经营分析、简报和自动化任务的 Seller ID。多个 Seller ID 分别授权将在后续版本支持。