shopify-automation

通过 Rube MCP 自动化 Shopify

通过 Rube MCP 使用 Composio 的 Shopify 工具包自动化 Shopify 操作。

工具包文档：composio.dev/toolkits/shopify

前置条件

• 必须已连接 Rube MCP（可用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立活跃的 Shopify 连接，工具包为 shopify
• 始终先调用 RUBE_SEARCH_TOOLS，获取当前工具架构

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。无需 API 密钥，只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 可以正常响应，以验证 Rube MCP 可用
2. 使用工具包 shopify 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，请访问返回的身份验证链接，完成 Shopify OAuth
4. 运行任何工作流前，确认连接状态显示为 ACTIVE

核心工作流

1. 管理产品

适用场景：用户想要列出、搜索、创建或管理产品

工具调用顺序：

1. SHOPIFY_GET_PRODUCTS / SHOPIFY_GET_PRODUCTS_PAGINATED - 列出产品［可选］
2. SHOPIFY_GET_PRODUCT - 获取单个产品详情［可选］
3. SHOPIFY_BULK_CREATE_PRODUCTS - 批量创建产品［可选］
4. SHOPIFY_GET_PRODUCTS_COUNT - 获取产品数量［可选］

关键参数：

• product_id：用于获取单个产品的产品 ID
• title：产品标题
• vendor：产品供应商
• status：'active'、'draft' 或 'archived'

注意事项：

• 分页结果在产品目录较大时需要基于游标进行分页
• 产品变体嵌套在产品对象中

2. 管理订单

适用场景：用户想要列出、搜索或查看订单

工具调用顺序：

1. SHOPIFY_GET_ORDERS_WITH_FILTERS - 按筛选条件列出订单［必需］
2. SHOPIFY_GET_ORDER - 获取单个订单详情［可选］
3. SHOPIFY_GET_FULFILLMENT - 获取履约详情［可选］
4. 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. 管理客户

适用场景：用户想要列出或搜索客户

工具调用顺序：

1. SHOPIFY_GET_ALL_CUSTOMERS - 列出所有客户［必需］

关键参数：

• limit：每页客户数量
• since_id：分页游标

注意事项：

• 客户数据包含订单数量和消费总额
• 客户列表较大时需要分页

4. 管理集合

适用场景：用户想要管理产品集合

工具调用顺序：

1. SHOPIFY_GET_SMART_COLLECTIONS - 列出智能集合［可选］
2. SHOPIFY_GET_SMART_COLLECTION_BY_ID - 获取集合详情［可选］
3. SHOPIFY_CREATE_SMART_COLLECTIONS - 创建智能集合［可选］
4. SHOPIFY_ADD_PRODUCT_TO_COLLECTION - 将产品添加到集合［可选］
5. SHOPIFY_GET_PRODUCTS_IN_COLLECTION - 列出集合中的产品［可选］

关键参数：

• collection_id：集合 ID
• product_id：要添加到集合的产品 ID
• rules：用于自动纳入产品的智能集合规则

注意事项：

• 智能集合会根据规则自动填充；手动集合使用自定义集合 API
• 集合数量接口返回的是近似数量

5. 管理库存

适用场景：用户想查看或管理库存水平

工具调用顺序：

1. SHOPIFY_GET_INVENTORY_LEVELS / SHOPIFY_RETRIEVES_A_LIST_OF_INVENTORY_LEVELS - 查看库存 [必需]
2. SHOPIFY_LIST_LOCATION - 列出店铺地点 [可选]

关键参数：

• inventory_item_ids：要查看的库存商品 ID
• location_ids：用于筛选的地点 ID

注意事项：

• 库存按变体和地点分别跟踪
• 多地点店铺需要提供地点 ID

常见模式

分页

• 使用 limit 和 page_info 游标获取分页结果
• 检查响应中的 next 链接标头
• 继续请求，直到没有更多页面

GraphQL 查询

对于高级操作：

1. Call SHOPIFY_GRAPH_QL_QUERY with custom query
2. Parse response from data object

已知注意事项

API 版本控制：

• Shopify REST API 使用版本化端点
• 某些功能需要特定的 API 版本

速率限制：

• REST API：标准套餐每秒 2 个请求
• GraphQL：每秒 1000 个成本点

快速参考

任务	工具 Slug	关键参数
列出商品	SHOPIFY_GET_PRODUCTS	（筛选条件）
获取商品	SHOPIFY_GET_PRODUCT	product_id
分页获取商品	SHOPIFY_GET_PRODUCTS_PAGINATED	limit, page_info
批量创建	SHOPIFY_BULK_CREATE_PRODUCTS	products
商品数量	SHOPIFY_GET_PRODUCTS_COUNT	（无）
列出订单	SHOPIFY_GET_ORDERS_WITH_FILTERS	status, financial_status
获取订单	SHOPIFY_GET_ORDER	order_id
列出客户	SHOPIFY_GET_ALL_CUSTOMERS	limit
店铺详情	SHOPIFY_GET_SHOP_DETAILS	（无）
验证访问权限	SHOPIFY_VALIDATE_ACCESS	（无）
智能系列	SHOPIFY_GET_SMART_COLLECTIONS	（无）
获取系列中的商品	SHOPIFY_GET_PRODUCTS_IN_COLLECTION	collection_id
库存水平	SHOPIFY_GET_INVENTORY_LEVELS	inventory_item_ids
地点	SHOPIFY_LIST_LOCATION	（无）
履约	SHOPIFY_GET_FULFILLMENT	order_id, fulfillment_id
GraphQL	SHOPIFY_GRAPH_QL_QUERY	query
批量查询	SHOPIFY_BULK_QUERY_OPERATION	query

---

由 Composio 提供支持