Seobility MCP: Technische Referenz

Dieser Guide richtet sich an Entwickler, Agenturen und alle, die gern selbst Hand anlegen und verstehen möchten, wie der Seobility MCP im Inneren funktioniert: welchen Endpoint er bereitstellt, wie Tools aufgerufen werden, wie Du Dich authentifizierst, wie MCP-Credits abgerechnet werden und worauf der Server in Deinem Account zugreifen kann.

Du möchtest den Seobility MCP einfach nur mit Deinem KI-Assistenten verbinden und direkt loslegen? Dann ist unser Einrichtungs-Guide die richtige Anlaufstelle: Seobility MCP: Verbinde Deinen KI-Assistenten mit Deinen Seobility-Daten. Dieser Artikel ist die Ebene darunter, für alle, die genau wissen möchten, was ihr KI-Client in ihrem Namen tut.

Wie der Seobility MCP funktioniert

Der Seobility MCP ist ein einzelner Server, mit dem Dein KI-Client über eine einzige Web-Adresse kommuniziert. Jede Funktion, ob das nun das Auslesen Deiner Rankings, das Starten eines Crawlings oder ein Live SEO Check ist, wird als benanntes Tool bereitgestellt. Dein Client wählt ein Tool aus, übergibt eine Reihe von Argumenten und erhält eine strukturierte Antwort zurück.

In der Praxis übernimmt Dein MCP-kompatibler KI-Client (Claude Code, Claude, Cursor und ähnliche) all das für Dich, sobald er verbunden ist. Du beschreibst in ganz normaler Sprache, was Du brauchst, und der Client wählt das passende Tool aus und füllt die Argumente eigenständig aus. Diese Referenz zeigt Dir einfach, was dabei hinter den Kulissen passiert.

Drei Dinge sind gut zu wissen:

• Es gibt einen einzigen Endpoint. Jedes Tool wird über dieselbe URL aufgerufen. Was passiert, entscheiden der Name des Tools und die Argumente, nicht die Adresse.
• Das Protokoll ist JSON-RPC 2.0 und nutzt die MCP-Methode tools/call. Das ist ein standardmäßiger MCP-Transport, sodass jeder kompatible Client damit kommunizieren kann.
• Der Server ist selbstbeschreibend. Dein Client kann den Server jederzeit nach seinem vollständigen Tool-Katalog fragen und weiß so immer, welche Tools für Deinen Key verfügbar sind.

Der Endpoint

Jeder Tool-Aufruf ist ein JSON-RPC-Request, der in denselben Envelope verpackt ist. Du legst den Namen des Tools und die Argumente fest, der Rest bleibt gleich:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "<tool-name>",
    "arguments": { ... }
  }
}

Hier ein Beispiel für ein Request-Response-Paar:

Authentifizierung

Der Seobility MCP authentifiziert sich über Deinen persönlichen Seobility API-Key. Während der Beta gibt es keine separate Anmeldung und keinen OAuth-Schritt. Allein der Key identifiziert Deinen Account und Dein Paket, behandle ihn also wie ein Passwort und bewahre ihn serverseitig auf.

Sende Deinen Key in einem Request-Header:

X-Seobility-Authorization: <your-api-key>

Falls Dein Client nur eine Authentifizierung per Bearer-Token unterstützt, kannst Du denselben Key stattdessen als standardmäßigen Authorization-Header senden:

Authorization: Bearer <your-api-key>

Nutze einfach das, was Dein Client unterstützt. Für die meisten Setups (Claude Code, Cursor und ähnliche Clients mit Konfigurationsdatei) ist der X-Seobility-Authorization-Header die unkomplizierte Wahl, und genau dieser wird auch im Einrichtungs-Guide gezeigt.

💡 Gut zu wissen: Dein Key gewährt vollen Zugriff auf die Daten Deines Accounts und, über die Schreib-Tools, auch die Möglichkeit, sie zu verändern (zum Beispiel, um Keywords anzulegen). Er kann Daten lesen und hinzufügen, aber niemals etwas aus Deinem Account löschen. Sollte Dein Key doch einmal offengelegt werden, melde Dich bei unserem Support unter [email protected], und wir setzen ihn zurück.

Wie MCP-Credits funktionieren

Anfragen, die Du über den Seobility MCP stellst, verbrauchen MCP-Credits. Die Credits sorgen für eine faire Nutzung, damit kein einzelner Account unsere Live-Tools durch pausenlose Anfragen überlasten kann.

Dein verbleibendes Guthaben kannst Du jederzeit abrufen, und auch die Antworten der Live-Tools melden Dir Dein Guthaben zurück, sodass Dein Assistent während der Arbeit den Überblick behält. MCP-Credits sind in Deinem kostenpflichtigen Paket enthalten, und zusätzliche MCP-Credits wird es später als Add-on geben.

Während der Beta bekommst Du außerdem höhere Credit-Limits, damit Du genug Raum zum Ausprobieren hast. Die Limits pro Paket findest Du im Einrichtungs-Guide.

Worauf der Seobility MCP zugreifen kann

Der Server fasst seine Tools in Modulen zusammen, die die wichtigsten Bereiche von Seobility abbilden. Grob gesagt kann Dein Assistent mit Folgendem arbeiten:

• Projekte und Crawlings: Deine Projekte auflisten, die Einstellungen eines Projekts auslesen und ein Website-Audit-Crawling starten oder stoppen.
• Website Audit (auf Website-Ebene): die Übersicht eines Crawlings auslesen, dazu die priorisierten Probleme, die Score-Verteilung, die Verteilung der HTTP-Statuscodes und die Klicktiefe-Daten für die gesamte Website.
• Website Audit (auf Seiten-Ebene): eine einzelne gecrawlte URL im Detail untersuchen: ihre Meta-Tags, Überschriften, internen und externen Links, den Content und die dort gefundenen Probleme.
• Ranking Monitoring: Deine überwachten Positionen bei Google und in den Google AI Overviews auslesen, über die Zeit und nach Land, dazu Ranking-Gewinner und -Verlierer, rankende Landingpages und die Positionen Deiner Wettbewerber.
• Keyword-Recherche (live): Live-Keyword-Abfragen durchführen: Vorschläge, verwandte und ähnliche Begriffe, Fragen, Suchvolumen und Wettbewerbsdaten.
• Backlinks: Dein Backlink-Profil auslesen, dazu neue, verlorene und fehlerhafte Links, Ankertexte, die wichtigsten verweisenden Domains und Vorschläge fürs Linkbuilding.
• Wettbewerber: die Performance Deiner Wettbewerber bei Rankings und Backlinks überwachen und vergleichen und Vorschläge für weitere Wettbewerber erhalten.
• Uptime Monitoring: Erreichbarkeit, Ausfallzeiten und Server-Antwortzeiten für Deine überwachten Websites auslesen.
• Live SEO Tools: Analysen auf Abruf für jede URL oder jedes Keyword durchführen, zum Beispiel einen SEO Check für eine einzelne Seite oder eine WDF*IDF-Content-Analyse, ohne die Website erst zu einem Projekt hinzufügen zu müssen.
• Reports: Deine bestehenden Seobility-Reports abrufen, damit Dein Assistent sie für Dich zusammenfassen oder an ein anderes Tool weitergeben kann.
• Account und Credits: Deine Account-Details, die Limits Deines Pakets und Dein MCP-Credit-Guthaben auslesen und Sub-Accounts verwalten.

Dein KI-Assistent wählt zwischen all dem automatisch aus, je nachdem, was Du fragst. Ein Tool konkret bennnen musst Du selbst nie, es sei denn, Du möchtest es.

Konventionen, die gut zu wissen sind

Ein paar Muster ziehen sich durch den gesamten Server und könnten hilfreich sein, wenn Du einen Aufruf debuggst oder Deine eigene Integration baust:

• Projekte werden über eine numerische ID identifiziert. Die meisten Tools brauchen eine project_id, um zu wissen, mit welchem Deiner Projekte sie arbeiten sollen. Dein Assistent kann Deine Projekte auflisten, um das richtige zu finden.
• Lange Listen werden paginiert. Listen-Antworten kommen mit total, offset und limit zurück und blättern standardmäßig in Schritten von 100 Ergebnissen durch.
• Suchmaschinen werden in Domain-Schreibweise angegeben. Nutze google.de, google.com und so weiter. Kurzformen wie google oder google_de werden abgelehnt.
• Du kannst das vorherige Crawling ansteuern. Du kannst nicht nur die Daten des letzten Crawlings, sondern auch die des vorletzten abrufen, was praktisch für Vorher-Nachher-Vergleiche ist.

So findest Du die vollständige Tool-Liste

Da der Server selbstbeschreibend ist, hat Dein Client über die MCP-Methode tools/list immer den vollständigen, aktuellen Katalog der Tools, auf die Dein Key zugreifen kann, jeweils samt Parametern. Das ist die verlässliche Quelle: Sie wird live vom Server abgerufen und ist deshalb nie veraltet. Führst Du in einer interaktiven Claude Code Session den Befehl /mcp aus, siehst Du den verbundenen Server seobility-mcp und seine Tools. In anderen Clients findest Du dieselbe Liste in der Ansicht der verbundenen Tools.

Brauchst Du weitere Hilfe?

• 📩 Du erreichst unser Support-Team jederzeit unter [email protected].
• 💬 Du nutzt den Seobility MCP, während er sich noch in der Beta befindet. Dein Feedback beeinflusst also direkt, wie er sich weiterentwickelt. Sag uns, was gut läuft und was nicht.

Danke, dass Du mit dem Seobility MCP arbeitest. 💙