MCP-Server für SEO mit KI-Agenten

Ein lokaler MCP-Server über stdio stellt dieselben Tools für Claude Code, Claude Desktop, Codex, Cursor und andere MCP-Clients bereit. Die Registrierung zeigt Ihnen den Plan, bevor eine Datei geändert wird.

Was es leistet

Profile

--profile full stellt alle Tools bereit. Die Profile audit, infra, quick-check und router enthalten kleinere Sets für fokussierte Sitzungen, sodass der Agent weniger Schemas sieht. Das Profil router bietet nur einen Diagnosecheck (doctor), die URL-Prüfung, den Audit-Workflow und den Tool-Katalog an; den Rest findet der Agent über den Katalog. Ein engeres Profil sperrt ausgeschlossene Tools sofort, während ein Client neu gestartet werden muss, um neu aktivierte Tools zu sehen.

  • audit: begrenzte Audit-Tools für Screaming Frog
  • infra: Prüfungen zu Domain, CDN, Technologie, Sicherheit, Headern, robots.txt und Sitemap
  • quick-check: kleine URL-Prüfungen, einschließlich der Batch-Prüfung
  • seohead mcp status --json zeigt das Profil und die genauen Anzahlen der Tools

Sichere Registrierung

Die Registrierung beginnt mit einem Plan. Mit --dry-run sehen Sie den Konfigurationsblock, die Datei, die sich ändern würde, den Pfad der Sicherung und die ursprüngliche SHA-256-Summe. Es wird nichts geschrieben. Mit --yes übernehmen Sie die Änderung. Die Client-Konfiguration wird gesichert, atomar ersetzt und erneut geparst; andere Server darin bleiben erhalten.

  • Clients: Claude Code, Claude Desktop, Codex und Cursor, Auswahl mit --client
  • --expected-sha256 bricht die Installation ab, wenn sich die Datei nach der Vorschau geändert hat
  • seohead mcp uninstall stellt aus der Sicherung wieder her
  • seohead mcp disable verhindert, dass der Server weitere Aufrufe annimmt

Agenten mit Gedächtnis

Projekte behalten Umfang, Crawl-Richtlinie, Scans und Verlauf. Dadurch macht der nächste Agent beim gespeicherten Projekt weiter und nicht im Chat. Ein Projekt-Posteingang enthält die Notizen des Spezialisten und vorgeschlagene Ziele. Ein Host kann einen MCP-Prozess außerdem auf einen Consumer-Namen und eine Liste erlaubter Projektordner beschränken.

  • workflow-status nennt einem neuen Agenten den nächsten registrierten Schritt
  • Schreibvorgänge verwenden die aktuelle Revision und scheitern bei einem Konflikt
  • Kostenpflichtige Operationen brauchen eine ausdrückliche Bestätigung, etwa confirm_paid=true

Drei Schritte, ein gespeicherter Scan

  1. Registrierung in der Vorschau prüfen

    Starten Sie die Installation zuerst mit --dry-run. Sie zeigt den genauen Konfigurationsblock, die Datei, die sich ändern würde, den Pfad der Sicherung und eine SHA-256-Summe. Dabei wird nichts geschrieben.

  2. Mit --yes installieren

    Haben Sie den Plan gelesen, ergänzen Sie --yes. Die bisherige Konfiguration wird daneben gesichert. --expected-sha256 bricht die Installation ab, wenn sich die Datei nach der Vorschau geändert hat.

  3. Agenten führen das gespeicherte Projekt fort

    Projekte behalten Umfang, Crawl-Richtlinie, Scans und Verlauf. Der nächste Agent übernimmt das gespeicherte Projekt, statt beim Chat neu anzufangen.

Prüfungen in dieser Funktion

PrüfungBedeutungSchweregradBeleg
REDIRECT_LOOPEine Weiterleitungskette führt zu einer URL zurück, die bereits besucht wurde, und kommt daher nie zum ZielCriticalSchleifenpfad aus der Weiterleitungskette (SF-Export Redirect Chains oder Hop-Datensätze eines nativen Crawls)
BROKEN_INTERNAL_LINKEin interner Link verweist auf eine URL, die 4xx zurückgibtCriticalInlinks mit Client Error (4xx): Quellseite und Linkposition
REDIRECT_CHAINVor der finalen URL liegen mehr als ein HopImportantJeder Hop mit Statuscode und Location-Header
INTERNAL_LINK_TO_REDIRECTEin interner Link verweist auf eine URL mit 3xx statt auf die finale SeiteImportantInlinks mit Redirection (3xx): Quellseite und Position im DOM
BAD_REDIRECT_TYPEEin 302, 303 oder 307 wird verwendet, obwohl eine dauerhafte Verschiebung gemeint istTipStatuscode pro Hop

Ein Befehl

bash
claude mcp add seohead -- /absolute/path/to/spiderhead/.venv/bin/seohead mcp

Zuerst installieren: Installationsanleitung. Jeder Befehl läuft auch als MCP-Tool für KI-Agenten.

Was Sie brauchen

  • Einen MCP-Client: Claude Code, Claude Desktop, Codex, Cursor oder einen beliebigen stdio-Client
  • Die ausführbare Datei seohead aus einer virtuellen Umgebung, als absoluter Pfad
  • Das installierte Extra mcp des Toolkits
  • API-Schlüssel der Anbieter nur für kostenpflichtige oder kontogebundene Tools

Grenzen

  • Es ist ein lokaler stdio-Server. Einen gehosteten MCP-Endpunkt gibt es nicht
  • Ein Aufrufjournal gibt es noch nicht. Wenn Sie einen Audit-Trail brauchen, führen Sie ein eigenes Protokoll
  • Tools können Anfragen senden, wenn Sie eine Prüfung oder einen Crawl starten. Im Katalog sehen Sie, welche das sind
  • Das Hinzufügen des Eintrags aktiviert MCP nicht von selbst; zum Schreiben braucht es --yes

Fragen

Ändert die Registrierung des Servers meine Konfiguration?
In der Vorschau nicht. --dry-run schreibt nichts und zeigt die Datei, die sich ändern würde (bei Claude Code ~/.claude.json), einen Pfad der Sicherung und eine SHA-256-Summe. Die Änderung erfolgt nur mit --yes.
Welche Clients werden unterstützt?
Claude Code, Claude Desktop, Codex und Cursor, ausgewählt mit --client. Jeder andere MCP-Client kann denselben stdio-Serverbefehl verwenden.
Wie viele Tools sieht ein Agent?
Das hängt vom Profil ab. Das Profil full stellt jedes registrierte Tool bereit, während audit, infra, quick-check und router deutlich kleinere Sets bereitstellen. Mit seohead mcp status --json sehen Sie die genaue Anzahl für jedes Profil Ihrer Installation.
Läuft der Server in der Cloud?
Nein. Er ist ein lokaler stdio-Prozess. Netzwerkanfragen gehen nur für die Prüfungen hinaus, die Sie anstoßen, etwa für eine URL oder einen Crawl. Ein Crawl speichert seinen Scan standardmäßig unter ./scans/.
Kann ein Agent mein Geld ausgeben?
Nicht unbemerkt. Kostenpflichtige Operationen brauchen eine ausdrückliche Bestätigung (confirm_paid=true) und Ihre eigenen Anbieter-Schlüssel. tool-catalog markiert, welche Tools Geld ausgeben können.
Wie schalte ich es ab?
Führen Sie seohead mcp disable aus. Ein laufender Server lehnt dann weitere Tool-Aufrufe ab. uninstall entfernt den Eintrag aus der Client-Konfiguration und stellt sie aus der Sicherung wieder her.

Testen Sie es auf Ihrer eigenen Website