/ Directory / Playground / GEO SEO Claude
● Community zubair-trabzada ⚡ Instant

GEO SEO Claude

by zubair-trabzada · zubair-trabzada/geo-seo-claude

GEO-first SEO skill — optimize for AI search (Perplexity, Gemini, ChatGPT) with citability scoring and crawler analysis.

Generative Engine Optimization (GEO) is the successor to SEO for an LLM-mediated web. This skill scores your pages on how citable they are to AI search engines: schema markup, entity clarity, content structure, brand authority. Different from traditional SEO — serves AI crawlers, not just Googlebot.

Why use it

Key features

Live Demo

What it looks like in practice

ready

Install

Pick your client

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

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

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

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

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

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

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

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

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

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

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

Add to context_servers. Zed hot-reloads on save.

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

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

Use Cases

Real-world ways to use GEO SEO Claude

GEO-audit a site: how do AI engines see you?

👤 SEO consultants, content marketers ⏱ ~90 min intermediate

When to use: Your SEO is fine but ChatGPT keeps citing competitors when people ask about your space.

Prerequisites
  • Skill installed — git clone https://github.com/zubair-trabzada/geo-seo-claude ~/.claude/skills/geo-seo
Flow
  1. Crawl
    Use geo-seo. Audit mysite.com — top 20 pages. Check schema, entity clarity, citability score per page.✓ Copied
    → Per-page scorecard with concrete weaknesses
  2. Compare competitors
    Pick 3 pages where competitor X is cited instead of me. What are they doing on those pages that I'm not?✓ Copied
    → Side-by-side comparison with actionable deltas
  3. Fix list
    Generate a prioritized fix list — what to change on my top 10 pages, in order of expected impact.✓ Copied
    → Prioritized list with effort/impact estimates

Outcome: A GEO action plan your content team can execute over a sprint.

Pitfalls
  • Confusing GEO wins for traditional SEO metrics — GEO impact shows up as citations in AI answers, not SERP rank — measure accordingly
Combine with: filesystem

Rewrite page schema + copy for better AI citability

👤 Marketers with ownership of specific landing pages ⏱ ~45 min intermediate

When to use: You have a page ranking well on Google but invisible to ChatGPT Search.

Flow
  1. Analyze
    Use geo-seo on mysite.com/product/x. What's missing for AI citability?✓ Copied
    → Diagnosis with specific schema/content gaps
  2. Revise
    Rewrite the page: better schema.org markup, clearer entity attributes, Q&A blocks that match how people ask AI questions.✓ Copied
    → Before/after diff focused on citability
  3. Ship + monitor
    Deploy. Set up monitoring — when Perplexity/GPT Search next crawls, note the citation outcome.✓ Copied
    → Monitoring plan with specific bot UA patterns

Outcome: A page more likely to be cited by AI engines.

Pitfalls
  • Over-optimizing for schema makes page bad for humans — Balance — schema as addition, not replacement

Combinations

Pair with other MCPs for X10 leverage

geo-seo-claude-skill + filesystem

Save audits alongside the site source

Save the GEO audit report next to the page's content file.✓ Copied
geo-seo-claude-skill + firecrawl

Crawl the site first to have content to audit

Firecrawl the site; geo-seo analyzes the result.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
citability_score url Per-page diagnosis 0
crawler_log_analyze log_path Know which AI bots hit your site 0
schema_suggest page_html Schema upgrades 0
competitor_compare my_url, their_url, query Understand why they're cited and you aren't 0

Cost & Limits

What this costs to run

API quota
N/A (local)
Tokens per call
Page audits can be heavy — scope to top pages
Monetary
Free (MIT)
Tip
Start with 10 highest-traffic pages, not the whole site

Security

Permissions, secrets, blast radius

Minimum scopes: filesystem-read
Credential storage: None
Data egress: Crawler logs and page HTML in your LLM context

Troubleshooting

Common errors and fixes

Score feels arbitrary

Ask for the factor breakdown — the score is the sum of interpretable factors

Competitor's citability looks identical, but they're cited

Brand authority matters too — the skill acknowledges this and suggests off-page work

Doesn't crawl JS-rendered pages

Combine with firecrawl or dev-browser for SPAs

Alternatives

GEO SEO Claude vs others

AlternativeWhen to use it insteadTradeoff
claude-seoYou want a broader SEO skill bundleLess GEO-specific
Traditional SEO tools (Ahrefs, Semrush)You still need keyword research and backlinksWeak or absent GEO features

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills