连接 Shopify 店铺

连接店铺后，StoreClaw 可在授权范围内读取 Shopify 订单、库存、商品、客户等数据，用于分析、简报和定时任务。本文说明如何创建 Shopify 自定义应用并完成连接。

为什么需要连接店铺

连接店铺后，StoreClaw 可以基于实际业务数据执行相关任务：

• 数据分析： StoreClaw 将基于已授权的订单、库存和流量数据生成分析结果。
• 定时任务： 连接数据源后，定时任务 才能按计划检查店铺指标并生成提醒。

获取 Shopify API 凭据

由于 Shopify 的安全性要求，您需要以“自定义应用”的方式授权 StoreClaw。请按照以下步骤获取 Client ID 和 Client Secret。

步骤一：在 Shopify 后台启动应用开发

1. 登录 Shopify 后台，进入 设置 -> 应用。
2. 点击 开发应用，然后点击页面右上角的 在 Dev Dashboard 中创建应用。
3. 系统将自动跳转至 Shopify dev dashboard（开发者控制台）。

步骤二：在开发者控制台中创建应用

1. 进入 Shopify dev dashboard，点击 创建应用。
2. 选择 从 Dev Dashboard 开始，输入应用名称，点击 创建。

步骤三：配置应用权限与设置

1. 继续完成应用的配置流程，找到 应用 URL，填入我们的地址：https://www.storeclaw.ai/app/connectors?platform=shopify

2. 取消勾选 内嵌至 Shopify app 选项框。

3. 

4. 在 访问权限 部分，点击 选择权限范围。

5. 勾选所需权限项。点击 完成。

   StoreClaw 的操作范围由您勾选的权限决定。 勾选了哪些 scope，StoreClaw 就能执行哪些对应操作；未勾选的操作，StoreClaw 执行时将提示权限不足。建议仅勾选当前任务需要的权限。

   以下是常见权限与对应能力的参考：

   权限代码	勾选后 StoreClaw 可以做	未勾选则不能做
   read_orders	查询订单、分析销售趋势、生成销售报表	无法获取任何订单数据
   write_orders	更新订单状态、备注	只能查看订单，无法修改
   read_products	查询产品信息、分析选品表现	无法读取产品数据
   write_products	修改产品标题、描述、价格、上下架	只能查看产品，无法编辑
   read_inventory	查询库存数量、触发补货预警	无法获取库存数据
   write_inventory	调整库存数量	只能查看库存，无法修改
   read_analytics	获取店铺流量、转化等分析数据	无法读取 Shopify 内置分析报告
   read_customers	分析客户画像、查询客户历史	无法获取客户信息
   read_shopify_payments_payouts	查询收款与提现记录	无法获取支付流水数据

6. 点击 发布，在弹出的确认窗口中再次点击 发布。

步骤四：在店铺中安装应用

1. 发布成功后，点击左侧导航栏的应用名称，进入应用详情页。

2. 在 概览 页点击右上角的 安装应用，系统会跳转至 Shopify 商户后台。

3. 选择要安装的店铺，在确认页面点击 安装。

4. 安装完成后会自动跳转回到StoreClaw页面

   提示： 除 Shopify Plus 用户外，每个自定义应用只能安装到一家店铺。如果您有多家店铺需要连接 StoreClaw，请为每家店铺分别在 Shopify dev dashboard 中创建一个独立应用，重复本流程完成安装。

步骤五：提取 API 凭据

1. 应用安装完成后，返回 Shopify dev dashboard。
2. 进入该应用的详情页，点击左侧菜单的 设置。
3. 在 凭据 部分，获取 客户端 ID 和 加密秘钥 （点击 眼睛 图标即可查看密钥内容）。

在 StoreClaw 中完成配置

1. 进入连接中心： 在 StoreClaw 左侧导航栏点击 连接器，在 电商 分类下找到 Shopify。
2. 填写字段：
   • 店铺域名: 您的店铺后台地址（例如：your-store.myshopify.com）。
   • Client ID: 填入刚才获取的 API key。
   • Client Secret: 填入刚才获取的 API secret key。
3. 激活连接： 点击 Connect Shopify →。
4. 验证状态： 连接成功后，Shopify 卡片将显示已连接。

连接失败？常见问题排查

如连接未成功，请检查以下常见问题：

问题现象	可能原因	解决方法
提示凭据错误	Client ID 或 Client Secret 填写错误	确认复制的是完整的 API key 和 API secret key，注意不要包含多余空格
提示权限不足	权限未发布或未安装应用	返回 Shopify dev dashboard，确保已点击 发布 并完成 安装应用 步骤

应用场景

连接成功后，您可以在对话中直接向 StoreClaw 发送指令。以下是一些常用示例——能否执行成功取决于您在步骤三中开放的权限范围，未授权的操作 StoreClaw 会提示权限不足。

所需权限	示例指令
read_orders	帮我分析一下最近 7 天的订单趋势
read_inventory	检查一下库存，列出需要补货的商品
read_customers	分析一下我的客户画像

常见问题 (FAQ)