Skip to main content
Glama
sparrow84001

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

by sparrow84001

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.

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


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.


Installation & Setup

Prerequisites

  • Bun (v1.1+) installed.

Quick Start

# Clone and install dependencies
cd d:/SNtemp/mcp/mcp-seo
bun install

# Run test suite
bun test

# Build executable bundle
bun run build

# Start MCP server directly
bun start

Client Configurations

1. Antigravity 2.0 (agy) Configuration

Add the server to your Antigravity global configuration or workspace .agy/mcp.json:

{
  "mcpServers": {
    "seo-auditor": {
      "command": "bun",
      "args": ["d:/SNtemp/mcp/mcp-seo/src/index.ts"]
    }
  }
}

2. GitHub Copilot / VS Code MCP Configuration

In .vscode/settings.json (or .codeium/mcp.json):

{
  "github.copilot.chat.mcpServers": {
    "seo-auditor": {
      "command": "bun",
      "args": ["d:/SNtemp/mcp/mcp-seo/src/index.ts"]
    }
  }
}

To guide Copilot directly, add this to .github/copilot-instructions.md:

When performing SEO or website audits, always use the `seo-auditor` MCP tools:
1. Run `seo_discover_project` first to understand the framework.
2. Run `seo_generate_full_audit` to get 0-100 scores and P0-P3 prioritized actions.
3. Show unified diffs with `seo_generate_code_fix` and request user approval before modifying code.
4. Verify with `seo_validate_code_fix` after applying fixes.

3. Claude Desktop Configuration

Add to %APPDATA%/Claude/claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "seo-growth-auditor": {
      "command": "bun",
      "args": ["d:/SNtemp/mcp/mcp-seo/src/index.ts"]
    }
  }
}

4. Cursor Configuration

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "seo-auditor": {
      "command": "bun",
      "args": ["d:/SNtemp/mcp/mcp-seo/src/index.ts"]
    }
  }
}

MCP Tools Reference

Tool Name

Purpose

Key Inputs

seo_discover_project

Detects framework, routing model, sitemaps, robots.txt, llms.txt, page inventory

projectPath

seo_crawl_and_extract

Extracts title, meta, canonical, headings, links, schemas, images from file/URL

target, pageType?

seo_audit_technical

Checks canonicals, robots.txt, meta robots noindex/nofollow, sitemaps, mixed content

target, projectPath?

seo_audit_onpage

Evaluates title length/CTR, meta description, H1-H6 hierarchy, OpenGraph/Twitter

target

seo_audit_aeo

Audits direct answer blocks, question headings (What/How), FAQ schema, llms.txt

target

seo_audit_geo

Audits Organization/Person entities, sameAs reconciliation, E-E-A-T credentials

target

seo_audit_local

Audits LocalBusiness schema, NAP consistency, click-to-call, city page duplication

target

seo_audit_content

Classifies search intent (Informational, Commercial, Transactional), thin content risk

target

seo_audit_conversion

Audits primary/secondary CTAs, lead capture forms, WhatsApp/Phone, social proof

target

seo_audit_performance

Identifies code-level CLS (missing img dimensions), LCP (legacy formats), blocking JS

target

seo_audit_schema

Validates Schema.org JSON-LD syntax and missing schemas by page type

target

seo_audit_internal_links

Builds link graph, detects orphan pages, generic anchor text, suggests contextual links

target

seo_generate_full_audit

Consolidates all 8 dimensions into 0-100 scores, P0-P3 matrix, and Markdown report

target, projectPath?

seo_generate_code_fix

Framework-aware code generation (Laravel Blade, Next.js, HTML) with unified diff

filePath, title?, metaDescription?, canonicalUrl?, jsonLdSchema?, applyDirectly?

seo_validate_code_fix

Post-fix validation: checks duplicate tags, JSON-LD syntax, Before/After score diff

filePath, beforeScores?


MCP Prompts Reference

  1. seo_full_audit: Guides the AI through the complete 12-step audit workflow from discovery to reporting.

  2. seo_code_fix_workflow: Step-by-step guidance for surgical code fixes with approval checkpoints.

  3. aeo_geo_optimization: Deep optimization for Generative Engines and AI Answer Engines.

  4. local_seo_boost: Dedicated optimization for local and multi-location businesses.


Standard 12-Step Audit Workflow

1. DISCOVER  ➔  2. CRAWL  ➔  3. ANALYZE (8 Dimensions)  ➔  4. IDENTIFY PROBLEMS
       ▲                                                              │
       │                                                              ▼
12. REPORT  ▲  11. RE-AUDIT  ▲  10. APPLY FIX  ▲  9. APPROVAL  ◄  5. PRIORITIZE

License

MIT License. Developed for Antigravity, GitHub Copilot, and Claude AI Ecosystems.

-
license - not tested
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • SEO MCP server: crawl your site, find AI-visibility gaps, and ship the fix from your coding agent.

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • MCP server for AI agent profiles and smart notes. 60+ coding prompt packs with expert personas.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sparrow84001/mcp-seo'

If you have feedback or need assistance with the MCP directory API, please join our Discord server