mcp-seo-audit

Ein Model Context Protocol (MCP)-Server für SEO-Audits mit Google Search Console, Indexing API, Chrome UX Report, PageSpeed Insights, lokalem Lighthouse, robots.txt-Prüfungen, Sitemap-Analyse, On-Page-SEO-Inspektion, Crawl-Audits und Live-Website-Analysen. Funktioniert mit Claude Code, Claude Desktop, Cursor und jedem MCP-kompatiblen Client.

Ein Fork von AminForou/mcp-gsc, erweitert zu einem umfassenderen Server für technisches SEO und Performance-Audits mit 30 Tools und einer vollständigen Test-Suite.

Funktionsumfang

Kategorie	Tools	Beschreibung
Property-Verwaltung	`list_properties`, `add_site`, `delete_site`	GSC-Properties auflisten, hinzufügen und entfernen
Suchanalysen	`get_search_analytics`, `get_advanced_search_analytics`, `get_performance_overview`, `get_search_by_page_query`, `compare_search_periods`	Abfrage von Klicks, Impressionen, CTR, Position mit Filtern, Dimensionen und Periodenvergleich
URL-Inspektion	`inspect_url`, `batch_inspect_urls`	Indexierungsstatus, Crawl-Informationen, Canonical, robots für eine oder mehrere URLs prüfen
Indexing API	`request_indexing`, `request_removal`, `check_indexing_notification`, `batch_request_indexing`	URLs über die Indexing API bei Google einreichen/entfernen
Sitemaps	`get_sitemaps`, `submit_sitemap`, `delete_sitemap`	Sitemaps auflisten, einreichen und löschen
Core Web Vitals	`get_core_web_vitals`	LCP, FID, CLS, INP, TTFB über die Chrome UX Report (CrUX) API
Performance-Audits	`get_pagespeed_insights`, `run_lighthouse_audit`	PageSpeed Insights und lokale Lighthouse-Audits mit Kategorie-Scores und Zusammenfassungen fehlerhafter Audits ausführen
Technisches SEO	`inspect_robots_txt`, `analyze_sitemap`, `analyze_page_seo`, `crawl_site_seo`, `audit_live_site`	robots.txt prüfen, Sitemaps validieren, On-Page-SEO-Signale extrahieren, interne Seiten crawlen und ein Live-SEO-Audit ohne GSC-Zugriff durchführen
SEO-Analyse	`find_striking_distance_keywords`, `detect_cannibalization`, `split_branded_queries`	Keywords auf den Positionen 5-20 finden, Seiten erkennen, die für dieselbe Suchanfrage konkurrieren, Marken- von Nicht-Marken-Traffic trennen
Website-Audit	`site_audit`	All-in-One-Bericht: Sitemap-Gesundheit, Indexierungsstatus, Canonical-Fehler, Performance-Zusammenfassung
Authentifizierung	`reauthenticate`	Google-Konten durch Löschen zwischengespeicherter OAuth-Token wechseln

Insgesamt 30 Tools.

Einrichtung

1. Google API-Zugangsdaten

OAuth (empfohlen)

Gehen Sie zur Google Cloud Console
Aktivieren Sie die Search Console API und die Web Search Indexing API
Erstellen Sie eine OAuth 2.0 Client ID (Desktop-App)
Laden Sie client_secrets.json herunter

Dienstkonto (Service Account)

Erstellen Sie ein Dienstkonto in der Google Cloud Console
Laden Sie die JSON-Schlüsseldatei herunter
Fügen Sie die E-Mail-Adresse des Dienstkontos zu Ihren GSC-Properties hinzu

2. Installation

git clone https://github.com/GiorgiKemo/mcp-seo-audit.git
cd mcp-seo-audit
python -m venv .venv

# Activate:
# macOS/Linux: source .venv/bin/activate
# Windows:     .venv\Scripts\activate

pip install -r requirements.txt

3. Konfiguration Ihres MCP-Clients

Claude Code (`~/.claude/settings.json`)

{
  "mcpServers": {
    "seo-audit": {
      "command": "/path/to/mcp-seo-audit/.venv/bin/python",
      "args": ["/path/to/mcp-seo-audit/gsc_server.py"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/path/to/client_secrets.json",
        "PAGESPEED_API_KEY": "your-google-api-key",
        "CRUX_API_KEY": "your-google-api-key"
      }
    }
  }
}

Claude Desktop (`claude_desktop_config.json`)

Gleiche JSON-Struktur – siehe Claude Desktop MCP-Dokumentation für den Speicherort der Konfigurationsdatei.

4. Optional: Performance API-Schlüssel

Für Feld- und Labor-Performancedaten setzen Sie CRUX_API_KEY und PAGESPEED_API_KEY im env-Block:

"env": {
  "GSC_OAUTH_CLIENT_SECRETS_FILE": "/path/to/client_secrets.json",
  "CRUX_API_KEY": "your-google-api-key",
  "PAGESPEED_API_KEY": "your-google-api-key"
}

Sie können auch GOOGLE_API_KEY setzen; der Server verwendet diesen als Fallback-Schlüssel für PageSpeed Insights.

Umgebungsvariablen

Variable	Erforderlich	Standard	Beschreibung
`GSC_OAUTH_CLIENT_SECRETS_FILE`	OAuth	`client_secrets.json`	Pfad zu den OAuth-Client-Secrets
`GSC_CREDENTIALS_PATH`	Dienstkonto	`service_account_credentials.json`	Pfad zum Dienstkonto-Schlüssel
`GSC_SKIP_OAUTH`	Nein	`false`	Auf `true` setzen, um OAuth zu überspringen und nur das Dienstkonto zu verwenden
`GSC_DATA_STATE`	Nein	`all`	`all` = aktuelle Daten wie im GSC-Dashboard, `final` = bestätigte Daten (2-3 Tage Verzögerung)
`CRUX_API_KEY`	Nein	keine	Google API-Schlüssel für Core Web Vitals (CrUX)
`PAGESPEED_API_KEY`	Nein	keine	Google API-Schlüssel für PageSpeed Insights / Lighthouse API-Aufrufe
`GOOGLE_API_KEY`	Nein	keine	Fallback-Quelle für `PAGESPEED_API_KEY`
`LIGHTHOUSE_CHROME_PATH`	Nein	auto-detect	Optionaler expliziter Pfad zu Chrome/Chromium für das lokale Lighthouse CLI

Beispiel-Prompts

"List my GSC properties"
"Show search analytics for cdljobscenter.com last 28 days"
"Find striking distance keywords for my site"
"Detect keyword cannibalization"
"Run a full site audit"
"Check Core Web Vitals for cdljobscenter.com"
"Run PageSpeed Insights for https://example.com"
"Run a local Lighthouse audit for https://example.com"
"Inspect robots.txt for https://example.com"
"Analyze https://example.com/sitemap.xml"
"Analyze on-page SEO for https://example.com/jobs"
"Crawl https://example.com and report duplicate titles"
"Run a live SEO audit for https://example.com"
"Inspect indexing status of these URLs: /jobs, /companies, /pricing"
"Request indexing for https://mysite.com/new-page"
"Compare search performance this month vs last month"

Tests

81 Tests, die alle 30 Tools mit gemockten Google-/API-/Web-Audit-Aufrufen abdecken:

# Activate venv first
python -m pytest test_gsc_server.py -v

Was hat sich gegenüber dem Original geändert

30 Tools — PSI, lokales Lighthouse, robots.txt-Inspektion, Sitemap-Validierung, Seiten-SEO-Analyse, Crawl-Audits und Live-Website-Audits hinzugefügt
7 Fehlerbehebungen — Sortierrichtungs-Mapping, Ursprungs-/URL-Erkennung, Absturz bei leeren Zeilen, API-Schlüssel-Leck, blockierender Sleep, Service-Caching, veralteter Cache bei erneuter Authentifizierung
81-Test QA-Suite — Abdeckung für GSC, CrUX, PSI, Lighthouse CLI, robots, Sitemaps, Crawl-Audits und Live-Audit-Komposition
Sicherheit — API-Schlüssel aus Fehlermeldungen entfernt
Performance — Google API-Service-Objekte zwischengespeichert, asynchroner Sleep statt blockierend, plus Labor-Performance-Tools zusätzlich zu CrUX-Felddaten

Lizenz

MIT. Siehe LICENSE.

Basierend auf AminForou/mcp-gsc.

mcp-seo-audit

mcp-seo-audit

Funktionsumfang

Einrichtung

1. Google API-Zugangsdaten

OAuth (empfohlen)

Dienstkonto (Service Account)

2. Installation

3. Konfiguration Ihres MCP-Clients

Claude Code (`~/.claude/settings.json`)

Claude Desktop (`claude_desktop_config.json`)

4. Optional: Performance API-Schlüssel

Umgebungsvariablen

Beispiel-Prompts

Tests

Was hat sich gegenüber dem Original geändert

Lizenz

Resources

Tools

Latest Blog Posts

MCP directory API

mcp-seo-audit

Funktionsumfang

Einrichtung

1. Google API-Zugangsdaten

OAuth (empfohlen)

Dienstkonto (Service Account)

2. Installation

3. Konfiguration Ihres MCP-Clients

Claude Code (~/.claude/settings.json)

Claude Desktop (claude_desktop_config.json)

4. Optional: Performance API-Schlüssel

Umgebungsvariablen

Beispiel-Prompts

Tests

Was hat sich gegenüber dem Original geändert

Lizenz

Resources

Tools

Latest Blog Posts

MCP directory API

Claude Code (`~/.claude/settings.json`)

Claude Desktop (`claude_desktop_config.json`)