/ Directory / Playground / ultimate-seo-geo
● Community mykpono ⚡ Instant

ultimate-seo-geo

by mykpono · mykpono/ultimate-seo-geo

Full-site SEO + GEO audits with 21 modules, scored 0–100, plus phased plans, JSON-LD schema, redirect configs, and 31 diagnostic Python scripts.

A comprehensive SEO + Generative Engine Optimization (AI search) skill with three modes: Audit, Plan, Execute. Covers Core Web Vitals, crawlability, on-page, content + E-E-A-T, schema markup, link analysis, and AI-search optimization (Google AI Overviews, ChatGPT, Perplexity) via passage-level work. Exports HTML dashboards and Excel reports. Works across Claude Code, Cursor, Codex, Gemini CLI via AGENTS.md.

Why use it

Key features

Live Demo

What it looks like in practice

ultimate-seo-geo-skill.replay ▶ ready
0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "ultimate-seo-geo-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mykpono/ultimate-seo-geo",
        "~/.claude/skills/ultimate-seo-geo"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "ultimate-seo-geo-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mykpono/ultimate-seo-geo",
        "~/.claude/skills/ultimate-seo-geo"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "ultimate-seo-geo-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mykpono/ultimate-seo-geo",
        "~/.claude/skills/ultimate-seo-geo"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ultimate-seo-geo-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mykpono/ultimate-seo-geo",
        "~/.claude/skills/ultimate-seo-geo"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "ultimate-seo-geo-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/mykpono/ultimate-seo-geo",
        "~/.claude/skills/ultimate-seo-geo"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "ultimate-seo-geo-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/mykpono/ultimate-seo-geo",
          "~/.claude/skills/ultimate-seo-geo"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add ultimate-seo-geo-skill -- git clone https://github.com/mykpono/ultimate-seo-geo ~/.claude/skills/ultimate-seo-geo

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use ultimate-seo-geo

Run a full-site SEO + GEO audit with a scored dashboard

👤 Solo SEOs and agencies running quarterly audits ⏱ ~120 min intermediate

When to use: Client onboarding or quarterly health check.

Prerequisites
  • Skill installed — git clone https://github.com/mykpono/ultimate-seo-geo ~/.claude/skills/ultimate-seo-geo
  • Python 3 for diagnostic scripts — python3 -V
Flow
  1. Run audit mode
    Use ultimate-seo-geo in audit mode on https://example.com. All 21 modules. Export to HTML dashboard.✓ Copied
    → Per-module 0-100 scores + dashboard file
  2. Generate phased plan
    Now plan mode — turn the audit into a 90-day phased roadmap with effort/impact per item.✓ Copied
    → Phase 1 / 2 / 3 with scored items
  3. Execute the quick wins
    Execute phase 1 quick wins — generate JSON-LD, meta rewrites, and redirect configs I can ship.✓ Copied
    → Copy-paste-ready artifacts

Outcome: A scored audit + roadmap + shippable artifacts in one session.

Pitfalls
  • Running all 21 modules on a 10-page site — Pick the relevant subset for small sites — crawlability + on-page is usually enough
Combine with: firecrawl · brave-search

Optimize a page for AI Overviews, ChatGPT Search, and Perplexity

👤 Publishers seeing AI search eat their traffic ⏱ ~45 min intermediate

When to use: Your pages rank on Google classic but aren't cited in AI answers.

Flow
  1. Run GEO submodule
    Run ultimate-seo-geo's GEO module on https://example.com/guide — how does this page perform for AI citation?✓ Copied
    → Passage-level scores + citation-worthiness assessment
  2. Rewrite for citability
    Rewrite the key passages so they're self-contained, cite-worthy answer blocks.✓ Copied
    → Passages that read well as pulled quotes

Outcome: A page AI search engines are more likely to cite.

Pitfalls
  • Stuffing 'as an expert, the answer is…' boilerplate — Let the skill's editor remove it — AI engines flag that pattern

Generate and validate JSON-LD schema for a set of pages

👤 Technical SEOs implementing schema ⏱ ~30 min beginner

When to use: Product pages / articles / FAQs missing structured data.

Flow
  1. Generate schema per page type
    Generate JSON-LD for Article, FAQPage, and Product types from this set of URLs.✓ Copied
    → JSON-LD blobs per URL
  2. Validate
    Run the schema-validator script on the output.✓ Copied
    → Green validation + warnings addressed

Outcome: Ship-ready schema.

Detect and fix redirect chains killing crawl budget

👤 Technical SEOs on large legacy sites ⏱ ~30 min intermediate

When to use: After a migration, crawl budget is wasted on 301 chains.

Flow
  1. Run redirect-chain diagnostic
    Run the redirect-chain diagnostic script on example.com. List chains of length >=2.✓ Copied
    → Chain list with origins and final destinations
  2. Generate consolidated rules
    Generate .htaccess / nginx rules that collapse each chain to one hop.✓ Copied
    → Config-ready rules

Outcome: Faster crawls, fewer hops.

Pitfalls
  • Breaking a redirect that had analytics attribution attached — Note chains used by paid campaigns before collapsing

Quick E-E-A-T pass on a YMYL page

👤 YMYL publishers ⏱ ~20 min beginner

When to use: A page ranks in health/finance/legal and you want trust signals right.

Flow
  1. Run the E-E-A-T module
    Run ultimate-seo-geo E-E-A-T module on <url>. I want author, edit-history, and citation findings.✓ Copied
    → Specific fix list with examples

Outcome: An action list that actually moves trust signals.

Combinations

Pair with other MCPs for X10 leverage

ultimate-seo-geo-skill + firecrawl

Crawl the site first, then feed URLs to audit

Use firecrawl to enumerate example.com URLs, then run ultimate-seo-geo audit on the top 50 by impressions.✓ Copied
ultimate-seo-geo-skill + brave-search

Pull SERPs for benchmarking without a paid API

Use brave-search for the top 3 SERP results, then include them in audit's competitive context.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
audit url, modules? Start of any engagement 0
plan audit output After audit 0
execute plan item Implementation phase 0
geo_optimize url AI search optimization 0
schema_validator JSON-LD blob Before shipping schema 0
redirect_chain_scan sitemap or URL list Post-migration 0

Cost & Limits

What this costs to run

API quota
None — skill is free; any paired APIs bring their own
Tokens per call
Large on full-site audit (20–60k)
Monetary
Free
Tip
Segment the site by template and audit one page per template — extrapolate rather than audit every URL

Security

Permissions, secrets, blast radius

Credential storage: None in the skill
Data egress: Only the URLs you provide get fetched

Troubleshooting

Common errors and fixes

Python scripts fail with missing deps

pip install -r requirements.txt in the skill dir

Verify: python3 -c 'import requests, bs4'
Audit report looks generic

Provide target keywords and competitor URLs so the audit has context

Alternatives

ultimate-seo-geo vs others

AlternativeWhen to use it insteadTradeoff
superseo-skillsYou prefer 11 composable skills over one big oneLess automation, more orchestration

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills