连接 Noon 后，StoreClaw 可以在授权范围内访问您在 Noon UAE、KSA、Egypt 等市场中的订单、商品、库存、价格、履约和退货数据，用于店铺分析、运营管理和自动化任务。
本文介绍如何在 Noon Seller Lab 中创建服务账户，下载 store_credentials.json，并在 StoreClaw 中完成 Noon 店铺连接。
连接前准备
在开始连接前，请确认以下条件已满足：
- 已拥有可正常登录的 Noon 卖家账号
- 可以访问 Noon Seller Lab：https://login.noon.partners/
- 当前账号具备所有者或管理员权限，可以创建 API 用户
- 已确认要连接的 Noon 项目或市场，例如 UAE、KSA 或 Egypt
- 已登录 StoreClaw
提示： Noon 的不同市场或项目可能对应不同的凭证和 Project ID。如果您同时运营多个项目，请分别确认每个项目对应的凭证信息。
您需要准备的信息
完成连接需要以下两项信息：
| 项目 | 来源 | 说明 |
|---|---|---|
store_credentials.json |
Noon Seller Lab | 创建服务账户后下载的 JSON 凭据文件 |
Project ID |
Noon Seller Lab | 项目标识，通常是 PRJ123456 这样的格式。也可以在 JSON 中查找 project_code 字段 |
安全说明：
store_credentials.json等同于 API 访问凭据。请妥善保管，不要截图外传，也不要发送到群聊、公开文档或邮件中。
第一步：登录 Noon Seller Lab
- 打开浏览器，访问 https://login.noon.partners/。
- 使用您的 Noon 卖家账号登录。
- 进入 Seller Lab 控制台。
第二步：进入 User Access
在左侧导航栏依次点击：
User & Access -> User Access
注意： 部分账号中该菜单可能显示为 Users & Access。进入后，再选择 User Access 即可。
第三步：创建服务账户
在 User Access 页面中创建一个新的服务账户，用于生成 Noon API 凭据。
打开 API Users 页面
- 点击 API Users 标签。
- 点击 Add Service Account。
填写服务账户信息
按以下方式填写表单：
| 字段 | 填写建议 | 说明 |
|---|---|---|
| Display Name | StoreClaw 或自定义名称 |
用于区分该 API 用户 |
| Username / Email | 输入可用邮箱 | 作为服务账户标识 |
| GSP service account credentials | 勾选 | 必须勾选，否则不会生成所需凭据 |
填写完成后，点击 Create User。
确认权限角色
进入权限确认页面后，请确认该账户的角色为 Project Owner，然后点击 Update。
重要： 请按 StoreClaw 当前连接要求选择 Project Owner。如果权限不足，StoreClaw 后续读取订单、库存、商品、价格或履约数据时可能会失败。
第四步：下载 store_credentials.json
创建成功后，页面会展示服务账户凭据。
- 勾选 I agree to the terms stated above。
- 点击 Download as JSON 下载
store_credentials.json。 - 如果暂时不方便下载，也可以先复制文本框中的完整 JSON 内容备用。
重要： 该凭据通常只会完整显示一次。请立即保存并妥善保管。如果凭据丢失，通常需要重新创建服务账户并生成新的凭据。
第五步：检查 API 用户角色
返回 User Access 页面，再次确认刚创建的 API User 在 Role 一列中显示为 Project Owner。
如果不是该角色，请先补齐权限后再继续连接。
第六步：在 StoreClaw 中连接 Noon
您可以通过以下两种方式找到 Noon 连接器入口：
- 在 StoreClaw 会话框中输入
帮我连接 Noon。 - 点击左侧导航栏中的 连接器，在 电商 分类中找到 Noon 连接器卡片。
连接流程如下：
- 点击 Noon 连接器卡片上的 + 按钮。
- 在弹出的连接器窗口中，点击 连接 Noon。
- 在连接表单中填写所需信息。
填写连接信息
在连接窗口中填写以下两项：
| 字段 | 填写内容 |
|---|---|
| 商店凭证 | 用文本编辑器打开 store_credentials.json，复制全部内容后完整粘贴到此处 |
| 项目 ID | 填写 JSON 中的 project_code 值，例如 PRJ123456 |
注意： 粘贴 store_credentials.json 时，请确保内容完整，包括首尾大括号，不要遗漏或额外添加字符。
完成连接
确认信息无误后，点击 连接。连接成功后，Noon 卡片会显示 已连接 状态。
验证连接状态
连接完成后，您可以通过以下方式确认连接是否正常：
- 进入 连接器 页面，确认 Noon 卡片显示 已连接 状态。
- 在 StoreClaw 对话框中输入类似指令，例如
查看我的 Noon 订单。 - 如果系统能正常返回 Noon 数据，说明连接已生效。
如果连接失败，请检查 store_credentials.json 是否完整、Project ID 是否正确，以及 API 用户角色是否为 Project Owner。
断开连接
如需停止 StoreClaw 访问 Noon 数据，请按以下步骤操作：
- 前往 连接器 页面。
- 找到已连接的 Noon 卡片。
- 点击卡片，在弹窗中选择 断开连接。
- 确认断开操作。
说明： 断开连接后，StoreClaw 将停止继续读取该 Noon 项目的数据。断开连接不会删除 Noon 平台上的任何数据，也不会影响 StoreClaw 中已生成的历史分析结果。
建议： 如果您希望完全切断访问，请同时前往 Noon Seller Lab 停用或删除对应的 API User。
连接成功后可用功能
连接成功后，StoreClaw 可在授权范围内访问 Noon 数据，并支持以下能力：
| 功能模块 | 可用能力 |
|---|---|
| 订单分析 | 查看订单列表、订单详情和订单状态 |
| 商品分析 | 查看商品、SKU 和商品内容信息 |
| 库存分析 | 查看库存数量和跨仓库库存情况 |
| 价格分析 | 查看商品价格、建议零售价和价格变动 |
| 履约分析 | 查看发货单、面单、清单和物流追踪信息 |
| 退货分析 | 查看退货申请和 RTO（退回原仓）相关数据 |
注意： 实际可用的数据和操作范围取决于 Noon 凭证权限、API 用户角色，以及 StoreClaw 当前产品配置。未授权或账号无权限的数据不会被 StoreClaw 读取。
示例指令
连接成功后，您可以在 StoreClaw 中输入以下指令：
查看最近 7 天的 Noon 订单分析 Noon UAE 店铺的库存风险列出库存不足的 Noon SKU查看近期 Noon 退货趋势总结 Noon 店铺最近 30 天的销售表现分析 Noon 商品价格和库存变化
安全建议
为确保数据安全和账号安全，建议遵循以下做法：
- 使用专用 API 用户： 为 StoreClaw 单独创建服务账户，不与其他系统共用。
- 妥善保管凭据： 不要在群聊、公开文档、截图或邮件中明文展示
store_credentials.json。 - 定期审计： 定期检查 Noon Seller Lab 中的 API Users 列表。
- 及时停用： 如怀疑凭据泄露，请立即停用或删除对应 API User，并重新创建新的服务账户。
- 按项目管理： 不同 Noon 项目建议分别创建和管理凭据，方便后续审计和撤销。
常见问题（FAQ）
Q：创建 Service Account 需要付费吗？
A： 通常不需要。在 Noon Seller Lab 中创建 API 用户一般不单独收费。
Q：可以连接多个 Noon 店铺吗？
A： 不可以，目前 StoreClaw 只支持连接一个 Noon 店铺。
Q：store_credentials.json 丢失了怎么办？
A： 该文件通常无法再次下载。您需要在 Noon Seller Lab 中重新创建一个 Service Account，然后使用新的凭据更新 StoreClaw 中的连接。
Q：凭证会过期吗？
A： 一般不会自动过期。但如果该 API 用户被删除、停用，或者 Noon 吊销了凭证，连接就会失效。此时需要重新创建服务账户，并在 StoreClaw 中更新连接信息。
Q：连接后提示认证失败，应该怎么排查？
A： 请依次检查：store_credentials.json 内容是否完整粘贴，尤其不要漏掉首尾大括号；Project ID 是否与当前服务账户所属项目一致；API 用户角色是否为 Project Owner；该 API 用户是否已在 Seller Lab 中被删除或停用。
Q：StoreClaw 是否会修改我的 Noon 数据？
A： StoreClaw 会在授权范围内访问 Noon 数据，用于分析和自动化任务。具体是否支持写入或操作类能力，取决于 StoreClaw 当前产品配置、您的凭证权限和您发起的操作。连接过程本身不会删除或发布您的 Noon 数据。
Q：如何完全撤销 StoreClaw 的访问权限？
A： 您可以先在 StoreClaw 的 连接器 页面断开 Noon 连接，然后前往 Noon Seller Lab 停用或删除对应的 API User。这样可以完全切断 StoreClaw 对该 Noon 项目的访问。