用途
Shopify Automation 是一个通过 Rube MCP（Composio）自动化 Shopify 店铺运营的技能。它把 Shopify 的产品、订单、客户、库存和集合等操作封装为可调用的工具，便于在支持 MCP 的客户端中以工作流方式批量处理店铺数据。
前置条件
- 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）。
- 需通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Shopify 连接，toolkit 为 shopify。
- 每次操作前应先调用 RUBE_SEARCH_TOOLS，以获取当前的工具 schema。
设置方式
- 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥，添加端点即可使用。
- 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS，toolkit 指定为 shopify。
- 若连接状态不是 ACTIVE，按返回的授权链接完成 Shopify OAuth。
- 确认连接状态为 ACTIVE 后再运行任何工作流。
主要能力
1. 管理产品
适用场景：列出、搜索、创建或管理产品。
工具序列：
- SHOPIFY_GET_PRODUCTS / SHOPIFY_GET_PRODUCTS_PAGINATED：列出产品（可选）
- SHOPIFY_GET_PRODUCT：获取单个产品详情（可选）
- SHOPIFY_BULK_CREATE_PRODUCTS：批量创建产品（可选）
- SHOPIFY_GET_PRODUCTS_COUNT：获取产品数量（可选）
关键参数：product_id（单个检索的产品 ID）、title（产品标题）、vendor（供应商）、status（'active'、'draft' 或 'archived'）。
注意事项：大型目录的分页结果需要基于游标的分页；产品变体嵌套在产品对象内。
2. 管理订单
适用场景：列出、搜索或检查订单。
工具序列：
- SHOPIFY_GET_ORDERS_WITH_FILTERS：带筛选条件列出订单（必需）
- SHOPIFY_GET_ORDER：获取单个订单详情（可选）
- SHOPIFY_GET_FULFILLMENT：获取履约详情（可选）
- SHOPIFY_GET_FULFILLMENT_EVENTS：跟踪履约事件（可选）
关键参数：status（订单状态筛选：'any'、'open'、'closed'、'cancelled'）、financial_status（支付状态筛选）、fulfillment_status（履约状态筛选）、order_id（单个检索的订单 ID）、created_at_min/created_at_max（日期范围筛选）。
注意事项：订单 ID 为数字，API 调用时使用字符串格式；默认订单列表可能不包含所有状态，如需全部请指定 'any'。
3. 管理客户
适用场景：列出或搜索客户。
工具序列：
- SHOPIFY_GET_ALL_CUSTOMERS：列出所有客户（必需）
关键参数：limit（每页客户数）、since_id（分页游标）。
注意事项：客户数据包含订单数和总消费额；大量客户列表需要分页。
4. 管理集合
适用场景：管理产品集合。
工具序列：
- SHOPIFY_GET_SMART_COLLECTIONS：列出智能集合（可选）
- SHOPIFY_GET_SMART_COLLECTION_BY_ID：获取集合详情（可选）
- SHOPIFY_CREATE_SMART_COLLECTIONS：创建智能集合（可选）
- SHOPIFY_ADD_PRODUCT_TO_COLLECTION：将产品加入集合（可选）
- SHOPIFY_GET_PRODUCTS_IN_COLLECTION：列出集合中的产品（可选）
关键参数：collection_id（集合 ID）、product_id（要加入集合的产品 ID）、rules（智能集合的自动纳入规则）。
注意事项：智能集合根据规则自动填充；手动集合使用自定义集合 API；集合数量端点提供的是近似计数。
5. 管理库存
适用场景：检查或管理库存水平。
工具序列：
- SHOPIFY_GET_INVENTORY_LEVELS / SHOPIFY_RETRIEVES_A_LIST_OF_INVENTORY_LEVELS：检查库存（必需）
- SHOPIFY_LIST_LOCATION：列出门店位置（可选）
关键参数：inventory_item_ids（要检查的库存项 ID）、location_ids（按位置 ID 筛选）。
注意事项：库存按变体、按位置分别跟踪；多位置店铺需要提供位置 ID。
常见模式
分页：使用 limit 和 page_info 游标获取分页结果；检查响应中的 next 链接头；持续获取直到没有更多页。
GraphQL 查询：对于高级操作，先调用 SHOPIFY_GRAPH_QL_QUERY 并传入自定义查询，再从 data 对象解析响应。
已知注意事项
API 版本：Shopify REST API 使用带版本的端点；部分功能需要特定 API 版本。
速率限制：REST API 标准套餐为每秒 2 次请求；GraphQL 为每秒 1000 成本点。
快速参考
| 任务 | 工具 Slug | 关键参数 |
|---|---|---|
| 列出产品 | SHOPIFY_GET_PRODUCTS | (filters) |
| 获取产品 | SHOPIFY_GET_PRODUCT | product_id |
| 分页产品 | SHOPIFY_GET_PRODUCTS_PAGINATED | limit, page_info |
| 批量创建 | SHOPIFY_BULK_CREATE_PRODUCTS | products |
| 产品数量 | SHOPIFY_GET_PRODUCTS_COUNT | (none) |
| 列出订单 | SHOPIFY_GET_ORDERS_WITH_FILTERS | status, financial_status |
| 获取订单 | SHOPIFY_GET_ORDER | order_id |
| 列出客户 | SHOPIFY_GET_ALL_CUSTOMERS | limit |
| 店铺详情 | SHOPIFY_GET_SHOP_DETAILS | (none) |
| 验证访问 | SHOPIFY_VALIDATE_ACCESS | (none) |
| 智能集合 | SHOPIFY_GET_SMART_COLLECTIONS | (none) |
| 集合内产品 | SHOPIFY_GET_PRODUCTS_IN_COLLECTION | collection_id |
| 库存水平 | SHOPIFY_GET_INVENTORY_LEVELS | inventory_item_ids |
| 门店位置 | SHOPIFY_LIST_LOCATION | (none) |
| 履约 | SHOPIFY_GET_FULFILLMENT | order_id, fulfillment_id |
| GraphQL | SHOPIFY_GRAPH_QL_QUERY | query |
| 批量查询 | SHOPIFY_BULK_QUERY_OPERATION | query |
适用场景与限制
适用场景：需要在支持 MCP 的客户端中批量或按条件处理 Shopify 产品、订单、客户、集合与库存数据，或执行自定义 GraphQL 查询。
限制：需先完成 Rube MCP 与 Shopify 连接；受 Shopify API 版本与速率限制约束；分页需按游标处理；部分功能依赖特定 API 版本。