shopify-automation

📁 composiohq/awesome-claude-skills 📅 7 days ago
66
总安装量
66
周安装量
#3348
全站排名
安装命令
npx skills add https://github.com/composiohq/awesome-claude-skills --skill shopify-automation

Agent 安装分布

claude-code 52
opencode 51
gemini-cli 45
codex 41
antigravity 39

Skill 文档

Shopify Automation via Rube MCP

Automate Shopify operations through Composio’s Shopify toolkit via Rube MCP.

Prerequisites

  • Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
  • Active Shopify connection via RUBE_MANAGE_CONNECTIONS with toolkit shopify
  • Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

  1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
  2. Call RUBE_MANAGE_CONNECTIONS with toolkit shopify
  3. If connection is not ACTIVE, follow the returned auth link to complete Shopify OAuth
  4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Manage Products

When to use: User wants to list, search, create, or manage products

Tool sequence:

  1. SHOPIFY_GET_PRODUCTS / SHOPIFY_GET_PRODUCTS_PAGINATED – List products [Optional]
  2. SHOPIFY_GET_PRODUCT – Get single product details [Optional]
  3. SHOPIFY_BULK_CREATE_PRODUCTS – Create products in bulk [Optional]
  4. SHOPIFY_GET_PRODUCTS_COUNT – Get product count [Optional]

Key parameters:

  • product_id: Product ID for single retrieval
  • title: Product title
  • vendor: Product vendor
  • status: ‘active’, ‘draft’, or ‘archived’

Pitfalls:

  • Paginated results require cursor-based pagination for large catalogs
  • Product variants are nested within the product object

2. Manage Orders

When to use: User wants to list, search, or inspect orders

Tool sequence:

  1. SHOPIFY_GET_ORDERS_WITH_FILTERS – List orders with filters [Required]
  2. SHOPIFY_GET_ORDER – Get single order details [Optional]
  3. SHOPIFY_GET_FULFILLMENT – Get fulfillment details [Optional]
  4. SHOPIFY_GET_FULFILLMENT_EVENTS – Track fulfillment events [Optional]

Key parameters:

  • status: Order status filter (‘any’, ‘open’, ‘closed’, ‘cancelled’)
  • financial_status: Payment status filter
  • fulfillment_status: Fulfillment status filter
  • order_id: Order ID for single retrieval
  • created_at_min/created_at_max: Date range filters

Pitfalls:

  • Order IDs are numeric; use string format for API calls
  • Default order listing may not include all statuses; specify ‘any’ for all

3. Manage Customers

When to use: User wants to list or search customers

Tool sequence:

  1. SHOPIFY_GET_ALL_CUSTOMERS – List all customers [Required]

Key parameters:

  • limit: Number of customers per page
  • since_id: Pagination cursor

Pitfalls:

  • Customer data includes order count and total spent
  • Large customer lists require pagination

4. Manage Collections

When to use: User wants to manage product collections

Tool sequence:

  1. SHOPIFY_GET_SMART_COLLECTIONS – List smart collections [Optional]
  2. SHOPIFY_GET_SMART_COLLECTION_BY_ID – Get collection details [Optional]
  3. SHOPIFY_CREATE_SMART_COLLECTIONS – Create a smart collection [Optional]
  4. SHOPIFY_ADD_PRODUCT_TO_COLLECTION – Add product to collection [Optional]
  5. SHOPIFY_GET_PRODUCTS_IN_COLLECTION – List products in collection [Optional]

Key parameters:

  • collection_id: Collection ID
  • product_id: Product ID for adding to collection
  • rules: Smart collection rules for automatic inclusion

Pitfalls:

  • Smart collections auto-populate based on rules; manual collections use custom collections API
  • Collection count endpoints provide approximate counts

5. Manage Inventory

When to use: User wants to check or manage inventory levels

Tool sequence:

  1. SHOPIFY_GET_INVENTORY_LEVELS / SHOPIFY_RETRIEVES_A_LIST_OF_INVENTORY_LEVELS – Check stock [Required]
  2. SHOPIFY_LIST_LOCATION – List store locations [Optional]

Key parameters:

  • inventory_item_ids: Inventory item IDs to check
  • location_ids: Location IDs to filter by

Pitfalls:

  • Inventory is tracked per variant per location
  • Location IDs are required for multi-location stores

Common Patterns

Pagination

  • Use limit and page_info cursor for paginated results
  • Check response for next link header
  • Continue until no more pages available

GraphQL Queries

For advanced operations:

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

Known Pitfalls

API Versioning:

  • Shopify REST API has versioned endpoints
  • Some features require specific API versions

Rate Limits:

  • REST API: 2 requests/second for standard plans
  • GraphQL: 1000 cost points per second

Quick Reference

Task Tool Slug Key Params
List products SHOPIFY_GET_PRODUCTS (filters)
Get product SHOPIFY_GET_PRODUCT product_id
Products paginated SHOPIFY_GET_PRODUCTS_PAGINATED limit, page_info
Bulk create SHOPIFY_BULK_CREATE_PRODUCTS products
Product count SHOPIFY_GET_PRODUCTS_COUNT (none)
List orders SHOPIFY_GET_ORDERS_WITH_FILTERS status, financial_status
Get order SHOPIFY_GET_ORDER order_id
List customers SHOPIFY_GET_ALL_CUSTOMERS limit
Shop details SHOPIFY_GET_SHOP_DETAILS (none)
Validate access SHOPIFY_VALIDATE_ACCESS (none)
Smart collections SHOPIFY_GET_SMART_COLLECTIONS (none)
Products in collection SHOPIFY_GET_PRODUCTS_IN_COLLECTION collection_id
Inventory levels SHOPIFY_GET_INVENTORY_LEVELS inventory_item_ids
Locations SHOPIFY_LIST_LOCATION (none)
Fulfillment SHOPIFY_GET_FULFILLMENT order_id, fulfillment_id
GraphQL SHOPIFY_GRAPH_QL_QUERY query
Bulk query SHOPIFY_BULK_QUERY_OPERATION query