Claude Code Shopify Automation & Admin API Toolkit

Automate Shopify with Claude Code.

A complete toolkit for products, collections, SEO, metafields, inventory, redirects, bulk operations, catalogue auditing and Shopify Admin API automation — built on the Admin GraphQL API, with a preview before every write, a backup, and a read-back after. Not a prompt pack: 32 working scripts, 34 Claude Code commands, 18 validated GraphQL documents, templates for every input, and 19 modules that say what each workflow does and refuses to do.

The problem

Updating one Shopify product manually is easy. Updating 500 is a workflow problem. Stores accumulate hundreds of products and thousands of variants, and with them: missing SEO titles, descriptions that are the first sentence of the body, images without alt text, vendors spelled four ways, collections that are empty or unpublished, metafields the theme expects and half the products lack, duplicate SKUs the warehouse will find before you do, inventory that says sold out on the storefront, and redirect lists from a migration nobody finished. Each one is a few clicks in the admin. Multiplied by the catalogue, none of them get done.

Ask a capable model to “fix the catalogue” through the API and you get the other problem: a script that rewrites every SEO description unreviewed, a bulk mutation with no export to roll back to, a token pasted into a file that gets committed. Speed without oversight is how a store gets a thousand wrong titles by lunchtime.

The solution

A structured automation system that runs inside Claude Code:

CONNECT  →  AUDIT  →  EXPORT  →  AUTOMATE  →  VALIDATE  →  REPORT

• Working scripts for every area — a GraphQL client with retries, throttling and cost awareness; export, audit and write scripts for products, variants, collections, metafields, metaobjects, media, SEO, inventory, pricing and redirects; bulk query and bulk mutation with JSONL utilities; a flagship store audit with a catalogue health score. Python standard library only; nothing to install.
• Claude Code commands that run the scripts, read the results, and explain them — each marked READ ONLY or WRITES TO SHOPIFY — REQUIRES EXPLICIT CONFIRMATION.
• A safety architecture every write follows: discover, export and back up, validate the input, generate a preview, review, confirm, execute, read back, validate, report. Dry run is the default; --limit caps every run; empty cells never blank a field; stale rows are skipped rather than overwritten.
• Shopify Admin GraphQL API 2026-07, validated live — including that version’s changes to collections, media and bulk-operation status, which older scripts and older advice get wrong. The version lives in one place, and the upgrade procedure is written down.

What is included

167 files, 19 modules, 34 commands, 32 scripts, 18 GraphQL documents — about 65,000 words plus working code. Every number here was counted from the bundle at build time.

Plus .claude/commands/ with 34 slash commands, scripts/ with 32 scripts, graphql/ with 18 documents, templates/ for products, collections, SEO, metafields, redirects, alt text, CLAUDE.md, .env.example and .gitignore, seven checklists, ten worked examples, and a real, unedited audit of our own store.

The commands

Use cases

• Audit 1,000 products for missing SEO, then write and apply the metadata in reviewed batches.
• Find every product missing image alt text, with the image beside each row so it can be described properly.
• Export the catalogue through GraphQL — paged for a small store, one bulk operation for a large one.
• Update approved product metadata in bulk, with every diff shown against the live value first.
• Find duplicate or missing SKUs before a 3PL, POS or shopping feed does.
• Audit collections: empty, unpublished, and the products that are in none.
• Export metafields, fix the ones with the wrong type, fill the missing ones from a CSV.
• Analyse inventory across locations: what is sold out on the storefront, what is negative, what is stocked nowhere.
• Run a Shopify GraphQL bulk mutation across thousands of products with the line count confirmed first and the result file kept.
• Generate a full catalogue health report every month, with a score that can be compared to last month’s.

Who it is for

Shopify store owners managing catalogue data; developers maintaining stores and integrations; agencies and freelancers operating client stores (the toolkit has a layout that keeps every client’s credentials, exports and reports apart); ecommerce operators doing bulk product, collection, SEO and inventory work; technical founders and AI-first builders who would rather have Claude Code run the admin than click through it. It assumes you can run a command and read a CSV. It does not assume you have used the Admin API before — the setup and GraphQL modules are written for a first time.

Safety

Every command declares its mode. Read-only commands never run a mutation. Write commands run a dry run first, show every planned change against the live value, ask a question that names the count, and apply only on an explicit yes with --limit equal to that count. A backup of the current values is written before the first mutation; every changed resource is read back and reported OK, WARN or FAIL with Shopify’s own userErrors verbatim. Tokens are read from .env and never printed, logged, committed or copied; the client redacts anything token-shaped from every error message.

Some things it will not automate at all, and says why: deleting products, deciding a price, guessing an inventory quantity, publishing or unpublishing without an explicit instruction and the guard flag, writing alt text for an image nobody has looked at, reading orders or customers.

The API

Shopify Admin GraphQL API, version 2026-07, centralised in one setting. No new workflow uses the legacy REST Admin API. Every GraphQL document and every query embedded in a script was validated against a live 2026-07 schema, and the validator ships so you can do the same after each quarterly release — it reports deprecated fields and arguments before the version that removes them. The changes 2026-07 made to collections (sources instead of rules), product media (fileUpdate), bulk-operation status and several lookups are already handled, and listed in the upgrade guide.

How it fits with the other four

The first three are also sold together as the Complete Site Builder Stack. This one is separate and specific: it is for a Shopify store, and it is the only product here that automates the admin. It pairs naturally with the Operations & Maintenance System, which watches the storefront from the outside while this one manages the catalogue from the inside. Buying it does not include the others, and there is no automatic upgrade credit.

Delivery and licence

A single ZIP, delivered by download immediately after purchase. 167 files, about 250 KB — Markdown, Python, GraphQL, CSV and YAML; nothing to install beyond Python 3, which your machine almost certainly has. A published SHA-256 checksum accompanies the download so you can verify what you received.

Licensed to one person for unlimited stores, including client work. You may not redistribute or resell it. Full terms are in LICENSE.md inside the archive. Shopify is a trademark of Shopify Inc.; this product is independent and not affiliated with or endorsed by Shopify.

What is not promised

No ranking, no sales figure, no guarantee that a write to your store is right. The toolkit shows you the change before it happens and the resource after; the judgement in between is yours, and the toolkit is built so that it stays yours.