seo-keyword-gap-audit
À propos
Cette compétence analyse les données SEO des concurrents via Ahrefs MCP pour identifier et prioriser les mots-clés pour lesquels votre propriété ciblée ne se classe pas. Elle est conçue pour la planification de contenu, la recherche de gains rapides et l'analyse concurrentielle lors de l'entrée sur de nouveaux marchés ou de la perte de parts. Le résultat est une liste priorisée et regroupée d'opportunités de mots-clés pour un contenu nouveau ou amélioré.
Installation rapide
Claude Code
Recommandénpx skills add rampstackco/claude-skills -a claude-code/plugin add https://github.com/rampstackco/claude-skillsgit clone https://github.com/rampstackco/claude-skills.git ~/.claude/skills/seo-keyword-gap-auditCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
SEO Keyword Gap Audit
Find keyword opportunities by comparing the target property's organic footprint against a competitor set, using Ahrefs MCP data. Stack-agnostic. Produces a prioritized list of keywords to target with new or improved content.
When to use
- Planning content investment for the next quarter
- Identifying quick-win keywords for fast organic gains
- Scoping market entry into a new vertical
- Refreshing a stale content strategy
- Diagnosing why a competitor is gaining organic share
- Pre-acquisition due diligence on growth ceiling
When NOT to use
- Pure keyword discovery without a competitor frame (use
seo-keyword) - Single-page optimization (use
seo-onpage) - Content audit on existing pages (use
seo-content-audit) - Topic and pillar planning (use
content-strategy)
Required inputs
- Target property
- Competitor set (3-5 properties with overlapping intent and audience)
- Target market and language
- Business priorities (which segments matter most)
- Existing content inventory (URLs and primary topics)
- Confirmation Ahrefs MCP is connected
The framework: the gap matrix
A keyword can fall into one of four cells based on whether the target ranks and whether competitors rank.
| Target ranks | Target does not rank | |
|---|---|---|
| Competitors rank | Shared territory (defend and grow) | Pure gap (the opportunity) |
| Competitors do not rank | Unique territory (asset to protect) | Untouched (validate before investing) |
The audit focuses primarily on the "pure gap" cell. The other cells get secondary treatment.
Pure gap (top focus)
Keywords where one or more competitors rank in the top 10 and the target does not rank at all or ranks past page 3. These are the primary opportunities.
Shared territory
Keywords where both target and competitors rank. Useful for defending position and finding pages to push from page 2 to page 1.
Unique territory
Keywords where the target ranks and no competitor does. These are differentiators. Audit to confirm they are actually valuable (not just irrelevant terms).
Untouched
Keywords no one in the set ranks for. Could be opportunity or could be irrelevant. Validate intent before investing.
Opportunity scoring
Not every gap keyword is worth pursuing. Score each candidate.
Scoring dimensions
| Dimension | What it measures | Weight |
|---|---|---|
| Search volume | Estimated monthly searches in target market | 20% |
| Business relevance | How close to a money topic for the target | 30% |
| Difficulty | How hard to rank (Ahrefs KD or proxy) | 15% |
| Intent match | Whether target can satisfy the dominant intent | 20% |
| Position potential | Realistic top 3 reach within 6 months | 15% |
Weights adjust based on goal. For quick wins, weight position potential and difficulty higher. For strategic territory, weight business relevance and volume higher.
Opportunity score formula
score = (volume_normalized * 0.2)
+ (relevance_score * 0.3)
+ (difficulty_inverted * 0.15)
+ (intent_match * 0.2)
+ (position_potential * 0.15)
Where each input is normalized to 0-100. The result is a 0-100 score.
Banding for action
| Score | Action |
|---|---|
| 80-100 | Top priority. Plan content this quarter. |
| 60-79 | Strong priority. Plan within 6 months. |
| 40-59 | Watch list. Revisit if competitive landscape shifts. |
| Below 40 | Park or drop. |
Workflow
- Define the competitor set. 3-5 properties. Confirm they share intent and audience.
- Pull keyword data. For each property: organic keywords, top pages, traffic estimates.
- Build the gap matrix. Label each keyword with which property ranks where.
- Filter to the pure gap cell. Strip out the other cells for now.
- Validate intent. For each keyword, confirm the SERP intent matches what the target can produce.
- Score by opportunity. Use the formula. See
references/opportunity-scoring-rubric.md. - Cluster. Group related keywords into topics. One topic, one piece of content.
- Map to existing content. Some gap keywords are addressable by updating an existing page rather than creating new.
- Sequence. Build the prioritized list with action (create / update / merge / new pillar).
- Hand off. Output feeds
content-strategyandseo-onpage.
Failure patterns
- Wrong competitor set. Choosing competitors by brand recognition rather than SERP overlap produces gap lists that are not actually competitive. Pick competitors that fight you in the SERPs.
- Volume worship. High-volume gap keywords are often unrealistic. A 50-volume keyword you can rank for beats a 5,000-volume keyword you cannot.
- Ignoring intent. A gap keyword where the SERP is dominated by tools or marketplaces is not addressable by an article. Match content type to intent.
- Skipping clustering. Targeting individual keywords instead of topics produces thin content that loses to topical hubs.
- Over-relying on Ahrefs KD. Difficulty scores are heuristics. Look at the actual SERP. If it is dominated by Forbes and Wikipedia, KD is misleadingly low.
- No business filter. A high-volume gap with zero buyer intent is a vanity opportunity. Filter for relevance.
- One-shot audits. Gap closes and reopens as competitors publish. Rerun on a cadence.
- Forgetting unique territory. Defending what you uniquely rank for can be more valuable than chasing gaps. Audit both directions.
- Single-language audits in multi-market sites. Run separate gap audits per market. Patterns differ.
Output format
A keyword gap audit document with:
- Executive summary. Top 3 themes and top 10 priority keywords.
- Competitor set. Who, why selected, SERP overlap evidence.
- The gap matrix. Counts and patterns across the four cells.
- Pure gap analysis. The opportunity list, scored and banded.
- Topic clusters. Groups of related keywords mapped to content concepts.
- Action map. Create / update / merge decisions per cluster.
- Quick wins. Top 5-10 highest-confidence opportunities.
- Strategic plays. High-impact, longer-horizon investments.
- Methodology. Data sources, scoring weights, caveats.
Length: 6-15 pages plus an attached opportunity spreadsheet.
Reference files
references/opportunity-scoring-rubric.md- Scoring rubric with normalization rules, formula, and worked examples.
Dépôt GitHub
Compétences associées
seo-site-health-audit
AutreCette compétence hiérarchise les problèmes techniques de SEO identifiés par des crawlers comme Ahrefs en fonction de leur impact réel sur le classement et le trafic, et non uniquement sur des étiquettes de sévérité. Elle aide les développeurs à créer un backlog de corrections priorisées lors de l'examen des résultats d'audit ou de la planification des sprints SEO. Utilisez-la pour surmonter la paralysie décisionnelle face aux longues listes d'erreurs de crawl et vous concentrer sur les actions à fort impact.
seo-traffic-diagnosis
AutreCette compétence diagnostique les variations de trafic organique en utilisant les données d'Ahrefs et de Search Console, en réalisant une analyse des causes racines sur 5 niveaux. Elle s'active face à des problèmes tels que des chutes soudaines de trafic, des mises à jour d'algorithmes ou des pertes post-migration pour identifier la cause. Le résultat fournit un diagnostic clair et un plan d'action concret pour que les développeurs puissent résoudre les problèmes de performance SEO.
seo-rank-tracking
AutreCette compétence aide les développeurs à configurer et gérer le suivi du classement SEO en utilisant Ahrefs MCP. Elle vous guide dans la sélection des mots-clés, leur segmentation, l'établissement de références et la configuration des seuils d'alerte. Utilisez-la lors du lancement d'un nouveau projet de suivi ou pour établir une fréquence de reporting pour les parties prenantes.
seo-content-gap-audit
AutreCette compétence analyse les données Ahrefs pour identifier les lacunes en contenu, les pages obsolètes et la dégradation des performances. Elle aide les développeurs à construire une feuille de route de contenu en recommandant des actions telles que créer, mettre à jour ou fusionner des pages. Utilisez-la lors de la planification de la stratégie de contenu, du rafraîchissement d'un catalogue vieillissant ou du diagnostic d'un trafic organique stagnant.
