DataForSEO MCP Server

Der DataForSEO MCP Server verbindet Ihren KI-Assistenten mit der kompletten Datenschnittstelle von DataForSEO. Damit lassen sich Suchergebnisseiten (SERPs), Keyword-Suchvolumen, Backlink-Profile, On-Page-Prüfungen und Wettbewerbsdaten in natürlicher Sprache abfragen, ohne dass Sie selbst eine Zeile API-Code schreiben. MCP, das Model Context Protocol, ist ein offener Standard, über den Assistenten wie Claude Code, Claude Desktop oder Cursor externe Werkzeuge aufrufen. Der Server stammt von DataForSEO selbst, liegt als Open-Source-Projekt unter der Apache-2.0-Lizenz auf GitHub und wird als npm-Paket dataforseo-mcp-server veröffentlicht.

Was ist neu in Version 3?

Laut README ist die aktuelle Fassung eine grundlegend neue Version. Der frühere Server mit vielen einzelnen Werkzeugen je API-Bereich gilt als veraltet und wurde in ein eigenes Repository ausgelagert. Version 3 kommt mit nur vier Werkzeugen aus: Drei davon durchsuchen die API-Dokumentation von DataForSEO, das vierte stellt authentifizierte Anfragen an einen beliebigen Endpunkt. Der Assistent liest also zuerst nach, welcher Endpunkt zu Ihrer Frage passt und welche Parameter er braucht, und ruft ihn dann gezielt auf. Das hält die Werkzeugliste im Client schlank und deckt trotzdem die gesamte API ab. Die Dokumentation wird laut Anbieter 24 Stunden lang zwischengespeichert.

Was können Sie damit machen?

Typische Fragen sind etwa: Welche zehn Seiten ranken in Deutschland für ein bestimmtes Keyword? Wie hoch ist das monatliche Suchvolumen einer Keyword-Liste? Welche verweisenden Domains hat ein Wettbewerber neu gewonnen? Welche technischen Probleme findet eine On-Page-Prüfung auf einer bestimmten URL? Der Assistent holt die Daten, fasst sie zusammen und kann daraus Tabellen, Content-Ideen oder Prioritätenlisten erstellen. Gerade für SEO-Agenturen und Inhouse-Teams, die bisher Daten aus mehreren Werkzeugen zusammenkopiert haben, spart das viel Handarbeit.

Gehostet oder lokal

DataForSEO betreibt einen öffentlichen Remote-Server unter https://mcp.dataforseo.com/v3/mcp. Clients mit HTTP-Unterstützung finden darüber die Anmeldung per OAuth selbst; Sie geben Ihre Zugangsdaten also nicht in eine Konfigurationsdatei ein. Alternativ starten Sie den Server lokal mit npx. Im lokalen stdio-Modus wird OAuth nicht verwendet; dann hinterlegen Sie API-Login und API-Passwort als Umgebungsvariablen. Ein lokaler HTTP-Modus auf Port 3000 ist ebenfalls vorgesehen.

Antworten kürzen und Kosten im Blick behalten

Viele DataForSEO-Antworten sind sehr umfangreich. Laut README lässt sich per Feldkonfiguration festlegen, welche Felder je Endpunkt zurückgegeben werden. Das spart Kontext im KI-Modell und macht Antworten übersichtlicher. Wichtig für die Kosten: Jede Anfrage über den MCP-Server ist eine ganz normale API-Anfrage und wird wie bei direkter Nutzung abgerechnet. Lassen Sie den Assistenten deshalb nicht unkontrolliert Massenabfragen starten.

Kosten

Der Server selbst ist kostenlos und Open Source. Für die Daten brauchen Sie ein DataForSEO-Konto. Laut Preisseite arbeitet DataForSEO nach dem Pay-as-you-go-Prinzip ohne Abo, neue Konten erhalten ein kleines Startguthaben zum Testen, und für den regulären Betrieb laden Sie Guthaben auf. Aktuelle Konditionen stehen auf der offiziellen Preisseite.

Für wen lohnt sich der DataForSEO MCP Server?

Er lohnt sich für alle, die SEO-Daten flexibel und ohne festes Monatsabo nutzen möchten: Freelancer, Agenturen mit schwankendem Datenbedarf und Entwickler, die eigene SEO-Werkzeuge bauen. Wer bereits ein Komplettpaket wie Ahrefs oder Semrush bezahlt, findet dort eine fertige Oberfläche; DataForSEO punktet dagegen mit Breite der Rohdaten und Abrechnung nach Verbrauch. Starten Sie mit dem Testguthaben und einfachen Abfragen, bevor Sie größere Analysen anstoßen.

Ein DataForSEO-Konto mit API-Zugang (API-Login und API-Passwort unter app.dataforseo.com/api-access). Für den gehosteten Server ein MCP-Client mit HTTP-Transport und OAuth, etwa Claude Code oder Cursor. Für den lokalen Betrieb zusätzlich Node.js ab Version 20.

Schritt 1: DataForSEO-Konto anlegen

Registrieren Sie sich auf dataforseo.com. Ihre API-Zugangsdaten finden Sie danach unter https://app.dataforseo.com/api-access. Wichtig: Das API-Login und das API-Passwort sind nicht identisch mit Ihrem normalen Passwort für das Dashboard. Für den gehosteten Server mit OAuth brauchen Sie die Zugangsdaten nicht, für den lokalen Betrieb schon.

Schritt 2: In Claude Code einbinden (empfohlen)

Öffnen Sie ein Terminal und führen Sie diesen Befehl aus. Er trägt den gehosteten DataForSEO-Server ein:

claude mcp add --transport http dataforseo https://mcp.dataforseo.com/v3/mcp

Starten Sie danach Claude Code und geben Sie den folgenden Befehl ein. Wählen Sie dataforseo aus und klicken Sie auf Authenticate. Im Browser melden Sie sich bei DataForSEO an und bestätigen den Zugriff.

/mcp

Schritt 3: Alternativ in Cursor oder Claude Desktop einbinden

Öffnen Sie in Cursor die Datei ~/.cursor/mcp.json (bzw. in Claude Desktop über Einstellungen, Entwickler, Konfiguration bearbeiten die Datei claude_desktop_config.json) und fügen Sie diesen Eintrag ein:

{
  "mcpServers": {
    "dataforseo": {
      "url": "https://mcp.dataforseo.com/v3/mcp"
    }
  }
}

Speichern Sie die Datei und starten Sie den Client komplett neu. Beim ersten Aufruf öffnet sich die OAuth-Anmeldung im Browser.

Schritt 4: Alternativ lokal mit API-Login starten

Wenn Ihr Client kein OAuth beherrscht oder Sie den Server lokal betreiben möchten, prüfen Sie zuerst, ob Node.js ab Version 20 installiert ist:

node --version

Tragen Sie dann den Server mit Ihren Zugangsdaten in die Konfigurationsdatei Ihres Clients ein. Ersetzen Sie IHR_API_LOGIN und IHR_API_PASSWORT durch die Werte aus Schritt 1:

{
  "mcpServers": {
    "dataforseo": {
      "command": "npx",
      "args": ["-y", "dataforseo-mcp-server"],
      "env": {
        "DATAFORSEO_LOGIN": "IHR_API_LOGIN",
        "DATAFORSEO_PASSWORD": "IHR_API_PASSWORT"
      }
    }
  }
}

In Claude Code geht das auch direkt per Befehl:

claude mcp add dataforseo --env DATAFORSEO_LOGIN=IHR_API_LOGIN --env DATAFORSEO_PASSWORD=IHR_API_PASSWORT -- npx -y dataforseo-mcp-server

Schritt 5: Verbindung testen

Stellen Sie Ihrem Assistenten eine einfache Frage, zum Beispiel:

Nutze DataForSEO und zeige mir die Top 10 der Google-Suchergebnisse in Deutschland für das Keyword "balkonkraftwerk".

Erscheinen die Ergebnisse, funktioniert alles. Prüfen Sie anschließend im DataForSEO-Dashboard, wie viel Guthaben die Anfrage verbraucht hat, damit Sie ein Gefühl für die Kosten bekommen.

Schritt 6: Antworten kürzen (optional)

Für den lokalen Betrieb können Sie per Feldkonfiguration festlegen, welche Felder ein Endpunkt zurückgibt. Legen Sie dazu eine Datei field-config.json an:

{
  "supported_fields": {
    "/v3/serp/google/organic/live/advanced": ["items.title", "items.url", "items.rank_absolute"]
  }
}

Hängen Sie in der Konfiguration aus Schritt 4 an die args die Werte "--configuration" und den absoluten Pfad zu dieser Datei an.

Gehosteter Server und lokaler HTTP-Modus: OAuth 2.0, der Client erledigt die Anmeldung im Browser. Lokaler stdio-Modus: API-Login und API-Passwort in DATAFORSEO_LOGIN und DATAFORSEO_PASSWORD (HTTP Basic).

Lesen der API-Dokumentation und authentifizierte Anfragen an alle DataForSEO-Endpunkte, für die Ihr Konto freigeschaltet ist, darunter SERP, Keywords, Backlinks, On-Page, Domain-Analysen und Content-Analysen. Jede Anfrage verbraucht Guthaben.

Suchbegriffe, Domains und URLs aus Ihren Anfragen werden an die DataForSEO-API übertragen, beim gehosteten Server zusätzlich über mcp.dataforseo.com. Die zurückgegebenen Daten gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Ein Assistent kann ohne Rückfrage viele kostenpflichtige Anfragen auslösen und so Guthaben verbrauchen. Im lokalen Modus liegen API-Login und API-Passwort im Klartext in der Client-Konfiguration.