---
name: shopify-keyword-topic-cluster-mapper
description: Map money keywords to Shopify collections and find content gaps to fill
---

# Keyword & Topic-Cluster Mapper

When the user asks to map keywords, use the connected Shopify + Search Console MCPs to:

## 1. Pull the demand
- Last 90 days of GSC queries (impressions, clicks, position)
- The store's collections, products, and blog articles with their URLs

## 2. Map each money keyword to a page
For every commercial query:
- The single best page to rank it (one query, one target — avoid cannibalization)
- Current ranking URL vs the page that should rank
- Flag where two URLs compete for the same query

## 3. Find the gaps
- Commercial queries with impressions but no matching collection (build a collection)
- Informational queries with no supporting blog article (build a post that links to the money page)
- Buyer questions ("how to choose X") with no content at all

## 4. Prioritize
Score each gap by:
- Impression volume
- Distance to page 1 (positions 11-20 first)
- Commercial intent

## 5. Output
| Keyword | Intent | Mapped page | Status (ranks/cannibal/gap) | Action |

Then a build list: new collections, new articles, and merges/canonicals to fix cannibalization, ranked by opportunity.

Always fix cannibalization before building new pages — two weak URLs rarely beat one strong one.