From shopify-commerce
Manages Shopify product catalogs: products, variants, options, collections, metafields, metaobjects, inventory, bulk operations, taxonomy, media via GraphQL API.
npx claudepluginhub orcaqubits/agentic-commerce-skills-plugins --plugin shopify-commerceThis skill is limited to using the following tools:
**Fetch live docs**:
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Guides MCP server integration in Claude Code plugins via .mcp.json or plugin.json configs for stdio, SSE, HTTP types, enabling external services as tools.
Fetch live docs:
site:shopify.dev graphql admin api product for product queries and mutationssite:shopify.dev metafields metaobjects for custom data APIssite:shopify.dev inventory management api for inventory operationshttps://shopify.dev/docs/api/admin-graphql and search for productCreate, metafieldsSet, bulkOperationRunQuery for current input schemassite:shopify.dev product variant options 2025 for latest variant limits and option changesProduct
├── Title, description, vendor, type, tags
├── Status: ACTIVE, DRAFT, ARCHIVED
├── Options (up to 3): Size, Color, Material
├── Variants (combinations of options)
│ ├── Price, compare-at price
│ ├── SKU, barcode
│ ├── Inventory (per location)
│ └── Weight, dimensions
├── Media (images, video, 3D models)
├── Metafields (custom data)
└── Collections (many-to-many)
| Operation | Mutation | Notes |
|---|---|---|
| Create product | productCreate | Returns product ID + userErrors |
| Update product | productUpdate | Partial updates supported |
| Delete product | productDelete | Removes all variants and media |
| Create variant | productVariantCreate | Specify options + price + inventory |
| Bulk update variants | productVariantsBulkUpdate | Up to 100 variants per call |
| Manage media | productCreateMedia | Images, video, 3D models |
| Set metafield | metafieldsSet | Works on any resource |
Fetch live docs for exact mutation input types and required fields — these evolve with each quarterly API version.
# Pattern: paginated product query with cursor
# Fetch live docs for current available fields
query Products($first: Int!, $after: String) {
products(first: $first, after: $after) {
edges {
node {
id
title
handle
status
variants(first: 10) {
edges { node { id sku price } }
}
}
}
pageInfo { hasNextPage endCursor }
}
}
Two types:
Smart collection rules support: tag, title, type, vendor, variant_price, variant_compare_at_price, variant_weight, variant_inventory, variant_title.
Typed key-value pairs on any resource:
custom.care_instructions){{ product.metafields.custom.care_instructions.value }}| Type | Example Value | Use Case |
|---|---|---|
single_line_text | "Organic cotton" | Short text |
multi_line_text | "Line 1\nLine 2" | Descriptions |
number_integer | 42 | Counts, quantities |
number_decimal | 3.14 | Measurements |
boolean | true | Flags |
date | "2025-01-15" | Dates |
json | {"key": "value"} | Structured data |
url | "https://..." | Links |
color | "#FF0000" | Colors |
file_reference | GID | Images, files |
product_reference | GID | Related products |
list.single_line_text | ["a", "b"] | Multi-value |
Fetch live docs for the full list of metafield types — new types are added periodically (e.g.,
money,rating,dimension).
# Pattern: set metafields on any resource
mutation MetafieldsSet($metafields: [MetafieldsSetInput!]!) {
metafieldsSet(metafields: $metafields) {
metafields { id namespace key value }
userErrors { field message }
}
}
# Fetch live docs for MetafieldsSetInput fields — ownerId, namespace, key, type, value
Standalone custom content types:
metaobjectCreateFetch live docs: Web-search
site:shopify.dev metaobject definition createfor schema creation and entry management.
Multi-location inventory tracking:
inventoryAdjustQuantities — adjust stock by delta (+/-)inventorySetQuantities — set absolute quantityreceived, correction, shrinkage, promotion, etc.Fetch live docs for
InventoryAdjustQuantitiesInputfields — the input shape and available reason codes evolve.
Shopify's standard product taxonomy:
productCategory field on productsFor large catalog operations (> 250 items):
bulkOperationRunQuery — submit a GraphQL query for bulk exportcurrentBulkOperation query until status is COMPLETEDurl field__parentId)stagedUploadsCreate — get a presigned URLbulkOperationRunMutation — process the staged uploadFetch live docs: Web-search
site:shopify.dev bulk operationsfor current input format, JSONL structure, and polling patterns.
userErrors in mutation responses — 200 status does not mean successFetch the Shopify product and metafield API documentation for exact mutation inputs, metafield types, and bulk operation patterns before implementing.