---
name: shopify-product-description-seo-rewriter
description: Rewrite Shopify product descriptions to rank and convert, with entities, specs, and schema-ready copy
---

# Product Description SEO Rewriter

When the user asks to rewrite product descriptions for SEO, use the connected Shopify + Search Console MCPs to:

## 1. Pull products and their queries
- Filter by collection, tag, or vendor (ask the user)
- For each product: title, current description, product type, specs/metafields, top GSC queries for the PDP URL

## 2. Build the entity list
For each product:
- Primary keyword (product type + key attribute)
- 3-5 supporting entities a buyer searches (material, size, use case, compatible-with, brand)
- The specific questions the PDP must answer (sizing, care, shipping, warranty)

## 3. Rewrite structure (120-180 words)
For each PDP, write:
- **Opening** — primary keyword in the first sentence, the core benefit, who it is for
- **Specs block** — bullet list of the entities and attributes (feeds Product schema)
- **Use case** — one paragraph answering the top buyer question from GSC
- **Trust line** — warranty, certification, or return window with a real number

## 4. Schema-ready output
- Map specs to Product schema fields (material, color, size, gtin if present)
- Keep claims factual so the copy and JSON-LD stay consistent

## 5. Output
| SKU | Primary keyword | New description (first line) | Word count | Specs mapped |

Then the full rewritten body_html for the top 10 products by impressions, plus a staging note on which to push first.

Never invent specs — pull them from Shopify metafields or ask the user to confirm.