io.github.sparrow84001/mcp-seo

SEO, AEO, GEO & Digital Marketing Audit + Safe Fix MCP Server

An advanced, AI-powered Model Context Protocol (MCP) server that acts as a comprehensive Growth Auditor, Search & AI Engine Optimizer, and Framework-Aware Code Fixer.

Developed by: Sayanta Neogi (@sparrow84001) • 📧 sparrow8400@gmail.com
Repository: github.com/sparrow84001/mcp-seo • Version: 1.0.5

Designed for seamless integration with Antigravity 2.0, GitHub Copilot, Claude Desktop, Cursor, and Windsurf. Built with TypeScript 7 and powered by Bun 1.4.

Key Capabilities

                  ┌─────────────────────────────────────────────────────────┐
                  │                 MCP-SEO AUDIT ENGINE                    │
                  └────────────────────────────┬────────────────────────────┘
                                               │
    ┌──────────────────┬───────────────────────┼───────────────────────┬──────────────────┐
    │                  │                       │                       │                  │
    ▼                  ▼                       ▼                       ▼                  ▼
┌──────────────┐ ┌──────────────┐      ┌──────────────┐      ┌──────────────┐ ┌──────────────┐
│Technical SEO │ │ On-Page SEO  │      │  AEO / GEO   │      │  Local SEO   │ │  Conversion  │
│ Indexing     │ │  Headings    │      │ Direct Answer│      │ NAP & Maps   │ │ CTAs & Forms │
│ Canonicals   │ │  Title/Meta  │      │ Knowledge G. │      │ City Pages   │ │ Trust Signals│
│ Robots/Maps  │ │  Social Cards│      │ llms.txt     │      │ Local Schema │ │ Risk Reversal│
└──────────────┘ └──────────────┘      └──────────────┘      └──────────────┘ └──────────────┘
                                               │
                                               ▼
                  ┌─────────────────────────────────────────────────────────┐
                  │        SURGICAL CODE FIXER & VALIDATOR (DIFFS)          │
                  │ Laravel Blade • Next.js (App/Pages) • PHP • HTML • Vue  │
                  └─────────────────────────────────────────────────────────┘

• Framework Discovery: Automatic architecture detection for Laravel Blade (@section, @push, components), Next.js App Router (Metadata API, sitemap.ts), Next.js Pages Router (next/head), Nuxt, Astro, Raw PHP, and static HTML.
• 8-Dimension Scoring: Calculates 0-100 scores and letter grades (A+ to F) across Technical SEO, On-Page SEO, AEO, GEO, Local SEO, Content Quality, Conversion/CRO, and Core Web Vitals risks.
• AEO & GEO Ready (2026 Search): Optimizes for Google AI Overviews, Perplexity, ChatGPT Search, and Claude; audits llms.txt and validates sameAs entity reconciliation.
• Local & Area SEO: Audits LocalBusiness schema, NAP consistency, click-to-call phone links, and flags spammy doorway city page duplication.
• Surgical Code Fixes & Rollback Safety: Generates unified diffs before applying any changes to files, followed by post-fix validation to prevent duplicate tags or broken schemas.
• Zero Hallucination Policy: Confirmed code evidence is strictly tagged as confirmed, architectural patterns as inferred, and strategic ideas as recommended.

🛠️ Complete MCP Tool Suite (21 Tools)

💻 Installation & Usage

1. Global Installation (via npm/bun)

bun add -g @sparrow84001/mcp-seo
# Or with npm:
npm install -g @sparrow84001/mcp-seo

2. Run via npx / bunx

npx @sparrow84001/mcp-seo
# Or with bun:
bunx @sparrow84001/mcp-seo

3. Precompiled Standalone Executable (Zero Dependencies)

Download mcp-seo.exe directly from the GitHub Releases page.

⚙️ Configuration

Antigravity 2.0 / Claude Desktop / Cursor (claude_desktop_config.json)

{
  "mcpServers": {
    "seo-growth-auditor": {
      "command": "bunx",
      "args": ["@sparrow84001/mcp-seo"]
    }
  }
}

Glama.ai Listing & Score

📄 License & Author

• License: MIT License • Copyright (c) 2026 Sayanta Neogi
• Author: Sayanta Neogi (@sparrow84001) • 📧 sparrow8400@gmail.com