SEO/GEO Page-Level Keyword Optimization Skill#

Overview#

This skill drives page-level keyword optimization by combining Ahrefs MCP data with GEO (Generative Engine Optimization) principles. It targets both traditional search engines and AI-powered search (ChatGPT, Perplexity, Google AI Overviews, Claude, Gemini).

---

Inputs Required#

InputSourceNotesTarget page URLUserThe specific page to optimizeCompetitor URLs (3–5)User or AhrefsSame search intent as target pagePrimary keywordUser or derivedMain topic the page should rank forAhrefs MCP credentialsEnvironmentAPI key or MCP session

---

Workflow#

Phase 1 — Keyword Intelligence (Ahrefs MCP)#

text

1. keywords_explorer(seed=primary_keyword)
   → Extract: volume, KD, CPC, related_terms, questions, parent_topic

2. site_explorer(url=competitor_url, mode="organic_keywords", limit=50)
   → Repeat for each competitor
   → Collect all keywords competitors rank for on this topic

3. content_gap(target=our_url, competitors=[url1, url2, ...], mode="page")
   → Output: keywords competitors rank for that our page does NOT cover
   → Filter by: volume > 100, KD < 60

Deliverable: A keyword matrix with three tiers:

TierTypePlacementPrimaryExact match, highest volumeTitle, H1, meta desc, first 100 wordsSecondarySemantic cluster, related termsH2/H3 headers, body paragraphsGap keywordsMissing vs. competitorsNew sections, FAQ, supporting content

---

Phase 2 — On-Page Keyword Mapping#

Map keywords to page structure following this hierarchy:

text

<title>          Primary keyword (≤60 chars)
<meta desc>      Primary + secondary keyword + CTA (≤155 chars)
<h1>             Primary keyword variant (natural language)
<h2> × N         One secondary keyword per sub-topic
First 100 words  Primary + 1 secondary keyword (natural, not forced)
Body             LSI / gap keywords distributed at ~1 per 200 words
<img alt>        Descriptive keyword-inclusive alt text
Internal links   Anchor text = target keyword of linked page

Rules:

• No keyword stuffing. Density is not a metric. Relevance and coverage are.
• Each H2 owns exactly one keyword intent. Do not blend intents in a single section.
• Internal link anchors must use the exact target keyword of the destination page.

---

Phase 3 — GEO Layer (AI Search Citability)#

This phase targets AI engines (ChatGPT, Perplexity, Gemini, AI Overviews).

CITE Framework (one application per major section):

text

C — Claim     : State the answer directly in the first sentence.
I — Insight   : Add a non-obvious detail or mechanism.
T — Trust     : Cite a source, statistic, or expert reference.
E — Evidence  : Back it up with data, example, or case.

Structural requirements:

1. Opening definition block: First 50 words must answer the primary keyword query in one authoritative sentence. This is what AI engines extract and cite.

2. FAQ Schema: Convert Ahrefs question-type keywords into FAQ markup. json

   {
     "@type": "FAQPage",
     "mainEntity": [
       {
         "@type": "Question",
         "name": "[keyword question from Ahrefs]",
         "acceptedAnswer": { "@type": "Answer", "text": "[CITE-structured answer]" }
       }
     ]
   }
   
   

3. Table / List structures: AI engines prefer extractable formats. Where the content allows, convert prose into a table or bulleted list with a clear header.

4. Factual density: Include at least 3 verifiable facts (statistics, dates, named entities) per 500 words. Vague content is not cited.

---

Phase 4 — Monitoring (Ahrefs API)#

python

# Weekly page health check
results = ahrefs_api.get_organic_keywords(url=target_page, limit=100)

for kw in results:
    if kw["position"] > 10 and kw["volume"] > 200:
        trigger_reoptimize_alert(kw)

# Monthly content gap re-run
ahrefs_api.content_gap(target=our_url, competitors=competitor_list)
→ Flag any new gap keywords with volume > 300

Alert thresholds:

• Primary keyword drops below position 10 → immediate review
• Click share drops >20% month-over-month → full content audit
• New gap keyword with volume >500 appears → add FAQ or new section within 2 weeks

---

Priority Order#

PriorityActionExpected ImpactP0Content gap analysis (page vs. competitors)Highest ROI — covers missing intent fastP0FAQ Schema from question keywordsGEO citability + featured snippet eligibilityP1Title / H1 / H2 keyword remappingRanking signal alignmentP1Opening 50-word authoritative answer blockAI Overview / LLM citation rateP2Internal link anchor text optimizationDistributes PageRank to target keywordsP2Alt text keyword coverageImage search + accessibilityP3API-driven ranking monitor + alertsCatch regressions early

---

Reference Projects#

ProjectStarsUseAgriciDaniel/claude-seo~7k25 sub-skills + 18 sub-agents, GEO/AEO, schema, semantic clusteringserpapi/awesome-seo-tools~863Tool discovery: keyword research, rank tracking, GEO trackersteles/awesome-seo~600+Reference links for keyword research fundamentalsamplifying-ai/awesome-generative-engine-optimization~300+GEO methodology, AI citability patternsaaron-he-zhu/seo-geo-claude-skills~51CORE-EEAT + CITE frameworks, rank tracking skills

---

Ahrefs MCP Endpoints Used#

EndpointPhasePurposekeywords_explorer1Volume, KD, related terms, questionssite_explorer1Competitor organic keyword listscontent_gap1, 4Missing keyword identificationget_organic_keywords4Page ranking health monitoringrank_tracker4Position trend over time