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

Un servidor avanzado de Model Context Protocol (MCP) impulsado por IA que actúa como un completo Auditor de Crecimiento, Optimizador de Motores de Búsqueda e IA, y Corrector de Código Consciente del Framework.

Diseñado para una integración perfecta con Antigravity 2.0, GitHub Copilot, Claude Desktop y Cursor. Construido con TypeScript y impulsado por Bun.

Capacidades Clave

                  ┌─────────────────────────────────────────────────────────┐
                  │                 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  │
                  └─────────────────────────────────────────────────────────┘

• Detección de Framework: Detección automática de arquitectura para Laravel Blade (@section, @push, componentes), Next.js App Router (API Metadata, sitemap.ts), Next.js Pages Router (next/head), Nuxt, Astro, PHP puro y HTML estático.

• Puntuación de 8 Dimensiones: Calcula puntuaciones de 0 a 100 y calificaciones con letras (A+ a F) en SEO Técnico, SEO On-Page, AEO, GEO, SEO Local, Calidad de Contenido, Conversión/CRO y riesgos de Core Web Vitals.

• Preparado para AEO y GEO (Búsqueda 2026): Optimiza para Google AI Overviews, Perplexity, ChatGPT Search y Claude; audita llms.txt y valida la reconciliación de entidades sameAs.

• SEO Local y de Área: Audita el esquema LocalBusiness, la coherencia NAP, los enlaces de teléfono de clic para llamar y marca la duplicación de páginas de ciudad doorway de spam.

• Correcciones de Código Quirúrgicas y Seguridad de Reversión: Genera diffs unificados antes de aplicar cualquier cambio a los archivos, seguido de una validación posterior a la corrección para evitar etiquetas duplicadas o esquemas rotos.

• Política de Cero Alucinaciones: La evidencia de código confirmada se etiqueta estrictamente como confirmed, los patrones arquitectónicos como inferred y las ideas estratégicas como recommended.

Instalación y Configuración

Requisitos Previos

• Bun (v1.1+) instalado.

Inicio Rápido

# 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

Configuraciones de Cliente

1. Configuración de Antigravity 2.0 (agy)

Añade el servidor a tu configuración global de Antigravity o al .agy/mcp.json del espacio de trabajo:

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

2. Configuración de MCP para GitHub Copilot / VS Code

En .vscode/settings.json (o .codeium/mcp.json):

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

Para guiar a Copilot directamente, añade esto a .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. Configuración de Claude Desktop

Añade a %APPDATA%/Claude/claude_desktop_config.json (Windows) o ~/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. Configuración de Cursor

Añade a .cursor/mcp.json en la raíz de tu proyecto:

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

Referencia de Herramientas MCP

Referencia de Prompts MCP

1. seo_full_audit: Guía a la IA a través del flujo de trabajo completo de auditoría en 12 pasos, desde el descubrimiento hasta el informe.

2. seo_code_fix_workflow: Guía paso a paso para correcciones de código quirúrgicas con puntos de control de aprobación.

3. aeo_geo_optimization: Optimización profunda para motores generativos y motores de respuesta con IA.

4. local_seo_boost: Optimización dedicada para negocios locales y de múltiples ubicaciones.

Flujo de Trabajo Estándar de Auditoría en 12 Pasos

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

Licencia

Licencia MIT. Desarrollado para los ecosistemas de Antigravity, GitHub Copilot y Claude AI.