name: shopify-automation description: “通过Rube MCP (Composio) 自动化Shopify任务:产品、订单、客户、库存、集合。始终首先搜索工具以获取当前模式。” requires: mcp: [rube] category: ecommerce
通过Rube MCP进行Shopify自动化
通过Composio的Shopify工具包和Rube MCP自动化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密钥 — 只需添加端点即可工作。
- 验证Rube MCP可用,确认
RUBE_SEARCH_TOOLS响应 - 使用工具包
shopify调用RUBE_MANAGE_CONNECTIONS - 如果连接不活跃,按照返回的认证链接完成Shopify OAuth
- 在运行任何工作流之前,确认连接状态显示为活跃
核心工作流
1. 管理产品
使用时机: 用户想要列出、搜索、创建或管理产品
工具序列:
SHOPIFY_GET_PRODUCTS/SHOPIFY_GET_PRODUCTS_PAGINATED- 列出产品 [可选]SHOPIFY_GET_PRODUCT- 获取单个产品详情 [可选]SHOPIFY_BULK_CREATE_PRODUCTS- 批量创建产品 [可选]SHOPIFY_GET_PRODUCTS_COUNT- 获取产品数量 [可选]
关键参数:
product_id: 用于单个检索的产品IDtitle: 产品标题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: 用于单个检索的订单IDcreated_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: 集合IDproduct_id: 用于添加到集合的产品IDrules: 用于自动包含的智能集合规则
注意事项:
- 智能集合基于规则自动填充;手动集合使用自定义集合API
- 集合计数端点提供近似计数
5. 管理库存
使用时机: 用户想要检查或管理库存水平
工具序列:
SHOPIFY_GET_INVENTORY_LEVELS/SHOPIFY_RETRIEVES_A_LIST_OF_INVENTORY_LEVELS- 检查库存 [必需]SHOPIFY_LIST_LOCATION- 列出店铺位置 [可选]
关键参数:
inventory_item_ids: 要检查的库存项IDlocation_ids: 按位置ID过滤
注意事项:
- 库存按变体按位置跟踪
- 多位置店铺需要位置ID
常见模式
分页
- 使用
limit和page_info游标进行分页结果 - 检查响应中的
next链接头 - 继续直到没有更多页面可用
GraphQL查询
对于高级操作:
1. 使用自定义查询调用SHOPIFY_GRAPH_QL_QUERY
2. 从数据对象解析响应
已知注意事项
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提供支持