Integrations/ShopifyStorefront & CMS

Shopify SEO & Universal Cart for AI agents

Most Shopify themes ship incomplete Product structured data, duplicate /collections/*/products/* internal links and thin collection pages. Clone your theme with Shopify CLI, add clickd’s skills, and let your agent fix Liquid or Hydrogen templates and verify every product field live.

1. Add all 16 skills to your repositorynpx skills add subinternal/clickd
2. Ask your agentCheck our live Shopify product and collection pages with clickd_check (kind: "product") and clickd_brief, fix sections/main-product.liquid for Universal Cart, and verify live.

For shopify and Shopify Plus stores on Liquid themes or Hydrogen headless storefronts.Connect MCPRead as .md

What breaks most often on Shopify

What clickd catches when it fetches the live URL the way Googlebot and AI crawlers do.

See the rulebook
  • Missing Universal Cart & variant schemaDefault themes often emit a single Offer instead of ProductGroup + hasVariant with SKU, GTIN, availability, shipping and return policy.schema-fits
  • Collection-prefixed product linksLinking to /collections/summer/products/hat instead of /products/hat splits internal link equity across duplicate product URLs.canonical
  • Empty collection templatesCollection pages list product grids with no opening description, FAQ or BreadcrumbList structured data for category searches.answer-first

The Shopify agentic SEO loop

Four steps your agent runs between your codebase and clickd’s live crawler.

  1. 01Check a live product URL

    Run clickd_check (kind: "product") on a multi-variant product URL to list every missing Merchant listing and Universal Cart field.

    clickd_check
  2. 02Edit Liquid or Hydrogen

    Your agent updates sections/main-product.liquid, snippets/card-product.liquid and layout/theme.liquid using Shopify’s native structured_data or JSON-LD.

    shop-ready
  3. 03Fix collection canonicals

    Update product grid links to point directly to {{ product.url }} rather than {{ product.url | within: collection }}.

    site-architecture
  4. 04Push theme & rescan

    Deploy via GitHub integration or shopify theme push, then run clickd_check and clickd_rescan on the live store.

    clickd_rescan

Worked pattern

Link directly to canonical /products/ URLs and emit variant-aware ProductGroup schema in main-product.liquid.

snippets/card-product.liquid

Sample
{%- comment -%} Avoid "| within: collection" so every internal link hits canonical /products/handle {%- endcomment -%}
<a href="{{ product.url }}" class="full-unstyled-link">
  {{ product.title | escape }}
</a>

Prompts to run on Shopify

Copy any prompt into Claude Code, OpenAI Codex, Cursor or Windsurf.

  • Universal Cart product auditRun clickd_check (kind: "product") on 3 of our live Shopify product pages and fix every missing ProductGroup, Offer, shipping and return field in our Liquid theme.
  • Fix /collections/*/products/* linksSearch our Shopify theme for "| within: collection" and replace collection-scoped product links with canonical {{ product.url }} links.
  • Upgrade collection templatesAudit our top 10 Shopify collection pages with clickd_pages and add concise buyer-focused descriptions, BreadcrumbList JSON-LD and internal links.

Skills to pair with Shopify

Included when you run npx skills add subinternal/clickd.

All 16 skills
  • Shop readyFixes the Product data in a shop's own product templates so it states what the page shows, and checks each live page with clickd before and after.See skill
  • Schema markupGenerates, wires and validates JSON-LD structured data (Organization, LocalBusiness, Product, Service, Article, FAQPage and BreadcrumbList) from the visible facts on your pages, checked live with clickd.See skill
  • Site architectureAudits and fixes your site’s internal link graph, orphan pages, topic hubs, crawl depth and BreadcrumbList schema in code, then verifies the updated structure on the live site with clickd.See skill
  • On-page SEORewrites title tags, meta descriptions, single H1s, question headings, answer-first openings, image alt text and AI writing tells in your site’s templates and content files, checked live with clickd.See skill

Questions about Shopify & clickd

Does this work on standard Liquid themes as well as Shopify Hydrogen?
Yes. The shop-ready skill ships worked reference patterns for both Shopify Liquid themes (edited locally via GitHub or shopify theme pull) and React-based Shopify Hydrogen storefronts.
Will editing theme JSON-LD overwrite our Google Merchant Center feed?
No. Your Merchant Center feed stays untouched; fixing your storefront’s JSON-LD ensures Google’s crawler and Universal Cart see the exact same prices, variants, GTINs and availability on the page itself.

Other integrations & stacks

All integrations
  • Google Search ConsoleTeams who want their coding agent driven by real Search Console impressions instead of guessed keyword volume.Data source
  • Next.jsTeams shipping on Next.js App Router or Pages Router with Claude Code, Codex or Cursor.Web framework
  • AstroTeams running marketing sites, docs and content hubs on Astro.Web framework
  • WordPressTeams managing custom WordPress block/classic themes, WooCommerce stores or headless WordPress.Storefront & CMS
  • WebflowMarketing and design teams running Webflow CMS sites alongside an AI assistant.Storefront & CMS
  • SvelteKitEngineering teams building web apps and marketing sites on SvelteKit and Svelte 5.Web framework
  • Lovable, Bolt, v0 & React SPAsFounders and developers shipping Vite, React SPA, Lovable, Bolt, v0 or Replit apps.App builder