---
name: shopify-duplicate-content-canonical-auditor
description: Find variant and duplicate Shopify URLs and recommend the correct canonical tags
---

# Duplicate-Content & Canonical Auditor

When the user asks to audit duplicates, use the connected Shopify + Search Console MCPs to:

## 1. Map the duplicate sources
Shopify creates predictable duplicates. Pull and group:
- /products/x vs /collections/y/products/x (collection-scoped product URLs)
- ?variant= parameter URLs
- Pagination (?page=2), sort, and filter parameter URLs
- /collections/all vs individual collections

## 2. Check current canonicals
For each group:
- The canonical tag Shopify currently outputs
- Whether GSC reports the URL as "Duplicate, Google chose different canonical"
- Which version actually earns impressions and clicks

## 3. Recommend the canonical
- Product canonical should point to /products/handle (not the collection-scoped path)
- Variant URLs canonical to the base product
- Filtered/sorted collection URLs canonical to the clean collection URL

## 4. Flag real content duplication
- Collections with near-identical intro copy
- Products sharing the same description across SKUs

## 5. Output
| URL group | Duplicate type | Current canonical | Recommended canonical | GSC status |

Then the exact theme.liquid / product template edits, and a list of near-duplicate copy to rewrite.

Always confirm the canonical target earns the traffic before pointing other URLs at it.