agentic-commerce-inject-jsonld

Purpose

JSON-LD structured data is the language AI shopping agents speak fluently. Themes without canonical Product schema force agents to scrape and infer — error-prone, slow, and frequently skipped entirely.

This skill installs a hardened JSON-LD snippet into the merchant's active Shopify theme that emits a complete Product schema on every PDP, covering: name, brand, sku, gtin, image, description, price, availability, aggregateRating, review, and offers. The snippet uses Liquid for server-side rendering — works on all themes, no JavaScript dependency.

Prerequisites

• Authenticated Shopify CLI session
• API scopes: read_themes, write_themes

Parameters

Workflow Steps

1. OPERATION: themes — query to find the target theme (published by default)

2. Check for existing JSON-LD: parse the theme files to detect existing application/ld+json script tags on product pages. If found, log a warning and skip auto-include to avoid duplicate JSON-LD.

3. Compose the snippet file at snippets/{snippet_name}.liquid:

   {% raw %}<script type="application/ld+json">
   {
     "@context": "https://schema.org/",
     "@type": "Product",
     "name": {{ product.title | json }},
     "image": [
       {% for image in product.images %}
         {{ image | image_url: width: 1200 | json }}{% unless forloop.last %},{% endunless %}
       {% endfor %}
     ],
     "description": {{ product.description | strip_html | json }},
     "sku": {{ product.selected_or_first_available_variant.sku | json }},
     "brand": {
       "@type": "Brand",
       "name": {{ product.vendor | json }}
     },
     "offers": {
       "@type": "Offer",
       "url": {{ shop.url | append: product.url | json }},
       "priceCurrency": {{ cart.currency.iso_code | json }},
       "price": {{ product.selected_or_first_available_variant.price | money_without_currency | json }},
       "availability": {% if product.selected_or_first_available_variant.available %}"https://schema.org/InStock"{% else %}"https://schema.org/OutOfStock"{% endif %}
     }
   }
   </script>{% endraw %}