--- spec_name: "Agentic Commerce Pack — Implementation Spec for Claude Code" spec_version: "1.0" last_updated: 2026-05-07 target_audience: "Store owners, ecommerce designers, and creative directors running Shopify, Wix, WooCommerce, or custom commerce stacks" expected_outcome: "Your store becomes discoverable, citable, and buyable by AI agents (ChatGPT Instant Checkout, Claude, Perplexity, Gemini) within 2-4 weeks of crawl" ai_tools_supported: [claude_code, google_antigravity, cursor] based_on: https://mikekwal.com/blog/agentic-commerce/ author: Mike Kwal --- # Agentic Commerce Pack — Implementation Spec for Claude Code ## Instructions for the AI You are helping a store owner make their ecommerce site agent-ready. The goal: when a shopper asks ChatGPT, Claude, or Perplexity *"best [product] under [price] that ships to [market]"*, this store gets cited AND can complete the purchase inside the chat via Stripe ACP. Read this spec end-to-end, then apply each step to the user's store. Confirm each step before moving to the next. Detect the platform (Shopify, Wix, WooCommerce, custom) and use the platform-specific instructions. If the platform is unclear, ASK before changing files. For every change, explain what you're doing in one sentence so the user learns as they go. --- ## Step 1: Verify agentic commerce is turned on **What it does:** Confirms the platform's agent endpoint is live and ACP (Stripe's Agentic Commerce Protocol) can complete purchases on the user's behalf. **Shopify (default-on, but verify):** 1. Admin → **Settings** → **Markets** → **Agent Commerce**. Toggle **On** (it ships on, but client teams sometimes disable it). 2. Visit `https://[storedomain]/.well-known/agentic-commerce` — should return JSON, not 404. 3. Admin → **Settings** → **Payments**: confirm Stripe is connected. **Wix:** Dashboard → **eCommerce** → **Agentic Commerce** → toggle **On**. Confirm Wix Payments or Stripe is connected. **WooCommerce / custom / headless:** Implement ACP directly via [Stripe ACP docs](https://stripe.com/docs/agentic-commerce). Create the catalog endpoint at `/.well-known/agentic-commerce` (JSON: id, title, description, price, currency, availability, image, URL, variants). Implement the ACP webhook to accept delegated payment tokens. Test in the Stripe ACP sandbox before flipping live. **Verification:** `curl` to the agent endpoint returns valid JSON. Stripe dashboard shows ACP enabled. --- ## Step 2: Add `Product` schema to every product page **What it does:** Schema.org `Product` JSON-LD is the structured data agents read before they read your prose. Missing schema = invisible to agents. **Template (paste into the product page `` template):** ```json ``` ### Platform-specific - **Shopify:** Edit `sections/main-product.liquid` (or theme equivalent). Bind fields with Liquid: `{{ product.title }}`, `{{ product.description | strip_html }}`, `{{ product.price | money_without_currency }}`, etc. Most modern themes (Dawn, Sense, Craft) ship with partial Product schema — extend it, don't duplicate it. - **Wix:** Site → **Custom Code** → add to **Product Pages** scope. Use Wix Velo `wixData` to bind product fields if you want fully dynamic, or hardcode for top SKUs. - **WooCommerce:** Install the Yoast WooCommerce SEO add-on, OR drop the JSON-LD into `single-product.php` template inside `` with `the_post()` field bindings. **Verify:** Paste the live product URL into [Google's Rich Results Test](https://search.google.com/test/rich-results). All `Product` fields should be green. --- ## Step 3: Restructure product pages with FAQ schema **What it does:** Agents quote FAQ blocks verbatim. Every product page needs a structured 8-10 question FAQ block — sizing, materials, shipping, returns, warranty, compatibility, "what's in the box," "who is this for." ### FAQ block template (HTML) ```html

Frequently asked questions

What sizes does this come in?

[ANSWER]

How long does shipping take?

[ANSWER]

What's your return policy?

[ANSWER]

``` ### FAQPage schema (paste below the FAQ block) ```json ``` ### Platform-specific - **Shopify:** Add a Product metafield (`faq`, JSON or rich text). Loop in `main-product.liquid` to render the HTML and schema together — merchandisers can edit per-product without touching code. - **Wix:** Use a repeater bound to a `productFAQs` collection keyed by product ID. Schema goes in a Custom Code element scoped to product pages. - **WooCommerce:** ACF Pro repeater on Product post type, looped in `content-single-product.php`. **Verify:** Rich Results Test shows valid `FAQPage`. FAQ is visible on the page AND in source. --- ## Step 4: Optimize product titles and descriptions for AI parsing **What it does:** Agents prefer structured language. Lead with what it *is*, then what it *does*, then who it's *for*. **Title formula:** `[Product type] — [Attribute 1], [Attribute 2], [Audience]` - BAD: `Summertime Vibes ☀️` → GOOD: `Crushable Sun Hat — Packable, UPF 50, Women's S–L` **Description formula:** 1-2 sentence what-it-is. 2-3 sentence who-it's-for. 4-6 spec bullets. Closing line for shipping + return window. **Platform-specific:** - **Shopify:** Bulk-edit via Admin → Products → edit columns. - **Wix:** CSV export → rewrite → re-import. **AI rewrite prompt (run over top 20 products):** ``` Read [PRODUCT URL]. Rewrite the title as "[product type] — [attribute 1], [attribute 2], [audience]". Rewrite the description: 1-2 sentence what-it-is, 2-3 sentence who-it's-for, 4-6 spec bullets, shipping/returns one-liner. Keep brand voice. Don't invent specs. ``` --- ## Step 5: Audit agent visibility (the test that matters) **What it does:** Confirms whether AI agents can actually find and cite the store. Run weekly for the first month. ### The test In ChatGPT, Claude, and Perplexity, ask: 1. *"Best [product category] under [price] that ships to [market]."* 2. *"Where can I buy [product type] for [use case]?"* 3. *"Compare [your product] vs [competitor]."* Log: was the store mentioned, what got quoted, and who got cited instead. ### Reverse-engineering winners For each competitor that got cited: 1. Paste their product URL into [Rich Results Test](https://search.google.com/test/rich-results) — what schema do they have you don't? 2. Read their FAQ — what questions do they answer that you skip? 3. Check their `llms.txt` at `[their-domain]/llms.txt`. 4. Check whether reviews use `Review` + `AggregateRating` schema. Fix the highest-leverage gap first. Re-test in a week. ### AEO baseline (one-time) Layer the [AEO Pack](https://mikekwal.com/blog/aeo-pack/) foundations: `llms.txt`, `Article` schema on blog posts, internal links from cornerstone pages to products. Without these, agent visibility plateaus. --- ## Quick-start prompts for Claude Code / Google Antigravity / Cursor ### Prompt 1 — Verify agent commerce is on ``` Check my store. Shopify: confirm Settings → Markets → Agent Commerce is on AND /.well-known/agentic-commerce returns JSON. Wix: confirm eCommerce → Agentic Commerce is on. WooCommerce/custom: walk me through Stripe ACP setup from https://stripe.com/docs/agentic-commerce. ``` ### Prompt 2 — Add Product schema ``` Find my product page template (main-product.liquid / single-product.php / Wix Product Page custom code). Inject the Product JSON-LD from Step 2, bound to my real fields (title, description, image, price, currency, SKU, brand, availability, aggregateRating). Verify with Google's Rich Results Test. ``` ### Prompt 3 — Add FAQ block + schema to top 10 products ``` Pull my top 10 products by revenue. For each, generate 8-10 FAQs (sizing, materials, shipping, returns, warranty, compatibility, what's in the box, who is this for) using only info already on the page or in my policies. Render as

blocks AND wrap in FAQPage schema. Save as Shopify metafields (or Wix/Woo equivalent) so I can edit without touching code. ``` ### Prompt 4 — Rewrite titles + descriptions ``` Read my top 20 products. Rewrite titles as "[product type] — [attribute 1], [attribute 2], [audience]". Rewrite descriptions: 1-2 sentence what-it-is, 2-3 sentence who-it's-for, 4-6 spec bullets, shipping/returns line. Keep brand voice. Don't invent specs. Show me the diff first. ``` ### Prompt 5 — Agent visibility test ``` Run these three prompts through ChatGPT, Claude, and Perplexity: "Best [my category] under [my price] that ships to [my market]," "Where can I buy [my product type] for [use case]," "Compare [my product] vs [top competitor]." Log citations + what schema the cited stores have that I don't. Prioritized fix list. ``` --- ## Verification checklist | Check | How | |---|---| | Agent commerce is on | Shopify: Settings → Markets → Agent Commerce. Wix: Dashboard → eCommerce → Agentic Commerce. Custom: Stripe dashboard shows ACP enabled. | | Agent endpoint responds | `curl https://[domain]/.well-known/agentic-commerce` returns JSON catalog. | | `Product` schema is valid | Paste product URL into [Rich Results Test](https://search.google.com/test/rich-results). All Product fields green. | | `FAQPage` schema is valid | Same tool. FAQPage shows green with all questions. | | FAQ block renders to humans | Visit product page. FAQ section visible above the fold or in second scroll. | | Reviews have `AggregateRating` schema | Rich Results Test shows non-zero `ratingValue` and `reviewCount`. | | Stripe ACP is wired | Stripe dashboard → Settings → ACP shows "enabled." A test order from ChatGPT Instant Checkout completes. | | Agent visibility | Ask ChatGPT/Claude/Perplexity for "best [your category] under [your price]." Allow 2-4 weeks for re-crawl after major changes. | --- ## Need help? Four ways to go deeper: - **Free** — Join the [Talk-to-Build community](https://www.skool.com/talktobuild). Builders shipping AI-native, agent-ready stores together. Weekly office hours, prompt library, build-along sessions. - **Done-for-you** — [MK-Way](https://mk-way.com) builds agent-ready Shopify and Wix stores in 7 days. - **Quick question** — DM Mike on [Instagram](https://www.instagram.com/mikekwal). He reads every message. - **B2B / strategy** — Connect on [LinkedIn](https://www.linkedin.com/in/mikekwal/). --- *This spec is the actionable implementation companion to the Agentic Commerce hub article: [https://mikekwal.com/blog/agentic-commerce](https://mikekwal.com/blog/agentic-commerce/). The hub explains the why; this spec ships the what.* *Last updated: 2026-05-07*