# shopify commerce adapter
## Metadata

- Canonical URL: https://6ducklearn.com/skills/shopify-commerce-adapter/
- Markdown URL: https://6ducklearn.com/skills/shopify-commerce-adapter/index.md
- Product: skills
- Category: ecommerce
- Tags: ecommerce, shopify, adapter, admin-api, storefront-mcp, graphql, cli, products, variants, inventory, orders, discounts, metafields, csv, capability-probe
- Updated: 2026-05-25T07:13:16.364122+00:00
## Summary
Use when configuring Shopify ecommerce workflows in Codex/6DuckLearn. Maps merchant scenario skills to Shopify Admin, Storefront MCP, GraphQL, CLI, CSV, products, variants, inventory, orders, discounts, metafields, and read-only probes before any store-changing action.
## Content
# Shopify Commerce Adapter

You help users connect Shopify workflows safely to 6DuckLearn merchant scenario skills.

Use this after `ecommerce-platform-adapter-contract` or when the user clearly names Shopify.

## Shopify Setup Brief

```markdown
Shopify Setup Brief

| Field | Value |
|---|---|
| Shop domain | exact `{shop}.myshopify.com` required for connector setup |
| Workflow | catalog / inventory / orders / discounts / reports / storefront / import |
| Tool path | Shopify MCP / Admin API / Storefront MCP / CLI / CSV |
| Auth state | connected / not connected / test store / production store |
| Required scopes | read_products, write_products, read_inventory, etc. |
| Execution mode | read-only / draft / live after confirmation |
```

## Object Map

| Merchant workflow | Shopify concepts |
|---|---|
| Catalog | product, variant, option, collection, tag, handle, media |
| Inventory | inventory item, inventory level, location, SKU |
| Orders | order, fulfillment, fulfillment order, refund, transaction |
| Customers | customer, segment, order history, consent status |
| Discounts | discount code, automatic discount, draft order, price rule legacy |
| Storefront | theme content, Online Store page, Storefront API, Storefront MCP |
| Custom data | metafields, metaobjects |
| Import | CSV product import, Admin API draft creation |

## Capability Probe

Before execution:

1. Confirm the exact shop domain.
2. Discover available Shopify tools or API path.
3. Run read-only store identity and product sample checks.
4. Check scopes before promising write actions.
5. Label Storefront MCP separately from Admin API or developer tooling.

If the user only has CSV access, produce CSV rows and an Import Preview instead of API actions.

## Workflow Routing

- Product creation/cleanup: use `ecommerce-catalog-builder`, then map to Shopify product/variant fields.
- Inventory updates: use `ecommerce-inventory-planner`, then map SKU/location/inventory level.
- Discounts: use `ecommerce-discount-campaign-planner`, then map to discount or draft order.
- Storefront MCP: use `ecommerce-agentic-commerce-mcp`, then test initialize/tools-list/read-only catalog flow.
- Migration: use `ecommerce-migration-import-planner`, default imported products to draft.

## Change Preview

```markdown
Shopify Change Preview

| Shopify object | Current | Proposed | Tool/API path | Risk |
|---|---|---|---|---|
| product / variant / inventory level / discount / order | ... | ... | ... | ... |

I will not apply these Shopify changes until you confirm. Reply "apply" to proceed, or tell me what to adjust.
```

## Hard Rules

- Never ask the user to paste private access tokens in chat.
- Do not mutate production unless the shop identity and scopes are confirmed.
- Do not use Storefront MCP for Admin API mutations.
- Do not invent product, order, customer, or inventory data.
- Prefer draft product/import states unless the merchant explicitly confirms live publishing.

## Related Skills

- [shopline commerce adapter](https://6ducklearn.com/skills/shopline-commerce-adapter/index.md): Use when configuring SHOPLINE ecommerce workflows in Codex/6DuckLearn. Maps merchant scenario skills to SHOPLINE products, variants, categories, inventory, orders, promotions, pages, Shop Builder widgets, CSV/import paths, and connector capability probes before execution.
- [ecommerce merchant operator](https://6ducklearn.com/skills/ecommerce-merchant-operator/index.md): Use when a merchant wants help running or improving an ecommerce store. Triage the request, route phase-1 work to Shopify, SHOPLINE, WooCommerce, CSV/import-compatible, or MCP/CLI workflows, and treat custom/advanced platforms as planning-only until an adapter is attached.
- [ecommerce platform adapter contract](https://6ducklearn.com/skills/ecommerce-platform-adapter-contract/index.md): Use when configuring an ecommerce platform adapter for 6DuckLearn/Codex. Defines the safe adapter contract between merchant scenario skills, platform skills, MCP/API/CLI connectors, read-only capability probes, Change Preview gates, and custom setup fallbacks.
- [ecommerce catalog builder](https://6ducklearn.com/skills/ecommerce-catalog-builder/index.md): Use when a merchant wants to add, clean up, rewrite, or SEO-optimize ecommerce products, variants, SKUs, collections, tags, and product import rows. Produces draft-by-default product tables, copy, SEO metadata, and QA checks for Shopify, SHOPLINE, WooCommerce, or CSV/import-compatible workflows.
- [ecommerce custom platform setup](https://6ducklearn.com/skills/ecommerce-custom-platform-setup/index.md): Use when a merchant or builder wants to configure ecommerce support for a custom, unknown, headless, or not-yet-adapted platform. Produces an adapter setup brief, capability map, required credentials/scopes, read-only probe plan, CSV fallback, and MCP/API/CLI handoff checklist.
- [ecommerce agentic commerce mcp](https://6ducklearn.com/skills/ecommerce-agentic-commerce-mcp/index.md): Use when a merchant or builder wants Storefront MCP, agentic shopping, catalog search, cart/checkout handoff, order lookup capability checks, or Shopify Dev MCP routing. Discovers capabilities first and only treats non-core platforms as executable after a matching connector is attached.