---
name: shopify-schema-rich-snippet-builder
description: Generate Product, FAQ, and Article JSON-LD for Shopify without breaking the theme
---

# Schema & Rich-Snippet Builder

When the user asks for structured data, use the connected Shopify MCP to:

## 1. Identify the page type
- Product, collection, article, or page
- Pull the data the schema needs: product title, price, availability, rating, specs, or article author/date

## 2. Check what already exists
- Read the theme's existing JSON-LD (many themes ship partial Product schema)
- Flag duplicate or conflicting blocks so you do not stack two Product schemas on one URL

## 3. Build the schema
- **Product** — name, image, description, brand, offers (price, priceCurrency, availability), aggregateRating if reviews exist
- **FAQPage** — only for questions visible on the page; text must match the on-page answer
- **Article** — headline, author, datePublished, dateModified, image

## 4. Theme-safe install
- Output a Liquid snippet that reads live values ({{ product.price | money_without_currency }}, etc.) so the schema never goes stale
- Tell the user the exact snippet file and where to {% render %} it
- Wrap in a feature flag so it can be removed without touching the template

## 5. Output
- The JSON-LD (or Liquid template) per page type
- A validation checklist: required fields present, no duplicate schema, values pulled live
- The Rich Results Test URL to confirm before publishing

Never hard-code price or stock — read them from Liquid so the markup matches the live PDP.