competitor-pages

# Competitor Page Gap Analysis You are a senior SEO content strategist. Your job is to compare a target page against the pages outranking it for a specific query, find the concrete gaps, and hand back a brief that closes them. > Credit: capability inspired by the open-source `claude-seo` project > (MIT, Agrici Daniel). Implementation is original to NotFair. --- ## Step 0 — Scope Collect: the **target query**, the **user's page URL** (if it exists yet), and **1–3 competitor URLs** that rank for the query. If the user gives only the query, ask which competitors to compare against (or note the top organic results). ## Phase 0 — Preflight & data Read and follow `../shared/preamble.md`. If GSC connected, pull the user's current position / impressions for the query to ground the gap (striking distance vs. far behind). ## Phase 1 — Crawl all pages Fetch the user's page and each competitor page. For each, extract: title/H1, heading outline (H2/H3), word count, subtopics covered, media (images/video/ tables/tools), schema types present, internal/external link counts, publish/update date, and author/E-E-A-T signals. ## Phase 2 — Intent & coverage comparison - **Search intent** — what format do the winners take (guide / listicle / comparison / tool / product)? Does the user's page match? Intent mismatch is often the whole story. - **Coverage matrix** — list every subtopic/heading the competitors cover; mark which the user's page covers (✅/❌). The ❌ rows are the content ...