Alle Tools

  1. SEORCH
  2. SEO API
  3. MCP Server

MCP Server

Einrichtung

Frag deinen KI-Assistenten direkt nach SEO-Daten: Der SEORCH MCP Server verbindet Claude, Cursor und andere Clients mit dem Model Context Protocol (MCP) mit allen SEORCH APIs, von Suchvolumen und Rankings bis zum SEO Check. Du brauchst nur einen API Key. Was der Server kann und wie du zu einem Zugang kommst, steht auf der Seite SEO MCP Server.

Server-URL: https://seorch.de/api/mcp/

Der Key steht im Header X-API-Key: DEIN_KEY oder Authorization: Bearer DEIN_KEY oder, wenn dein Client keine Header unterstützt, als ?key=DEIN_KEY in der URL. Der Server nutzt Streamable HTTP ohne Sitzung.

Claude Code: Im Terminal einmal ausführen:

Claude Code
claude mcp add --transport http seorch https://seorch.de/api/mcp/ --header "X-API-Key: DEIN_KEY"

Clients mit JSON-Konfiguration (z. B. mcp.json) tragen den Server so ein:

Konfiguration für Cursor, Windsurf und andere Clients
{
  "mcpServers": {
    "seorch": {
      "type": "http",
      "url": "https://seorch.de/api/mcp/",
      "headers": {
        "X-API-Key": "DEIN_KEY"
      }
    }
  }
}

Claude (Web und Desktop): Unter Einstellungen → Connectors einen eigenen Connector hinzufügen und die URL mit Key eintragen: https://seorch.de/api/mcp/?key=DEIN_KEY.

Danach reichen Fragen wie „Wie hoch ist das Suchvolumen von gartenmöbel, und wann sollte mein Ratgeber online sein?“ oder „Auf welchem Platz steht lieferando.de für pizza in Karlsruhe?“

Tools

Für jede API gibt es ein Tool. Die Argumente entsprechen den Parametern der jeweiligen API; die Details stehen in deren Dokumentation. Ein Key sieht nur die Tools der APIs, für die er freigeschaltet ist.

ToolAPIWofür
get_search_volumeSuchvolumen APISuchvolumen, CPC, Wettbewerb, Trend und Saison für bis zu 500 Keywords
get_search_volume_forecastSuchvolumen-Prognose APIPrognose für 12 Monate mit Spanne, Saison und Online-bis-Termin
get_keyword_ideasKeyword Tool APIVerwandte Keywords zu bis zu 10 Keywords oder einer URL
get_suggest_keywordsSuggest APIAutocomplete-Keywords aus 14 Quellen, optional mit Suchvolumen
get_questionsFragen APIW-Fragen zu einem Keyword
get_google_rankingsRanking APIGoogle-Ergebnisse, auch lokal und mobil, mit deiner Position
seo_checkSEO Check APISEO Check einer URL, auf Wunsch nur einzelne Bereiche
get_core_web_vitalsChrome UX Report APICore Web Vitals aus echten Nutzerdaten für bis zu 10 URLs
compare_sourceQuelltext-Vergleich APIUnterschiede zwischen zwei User Agents, z. B. Googlebot und Chrome
check_hreflangHreflang APIhreflang-Prüfung einer Seite oder XML-Sitemap
create_content_briefingContent Briefing APIZielwerte für einen Text aus den Top-Ergebnissen

Antwort

Jedes Tool liefert die Antwort der jeweiligen API als JSON-Text und zusätzlich als strukturierte Daten (structuredContent). Beispiel get_search_volume:

FeldBedeutung
resultsJe Keyword search_volume, cpc, cpc_high, cpc_low, competition (0 bis 100), yoy (Veränderung zum Vorjahr in Prozent), seasonal_peak und monthly
skippedKeywords mit Sonderzeichen oder über 55 Zeichen, die der Dienst nicht abfragen kann
Beispielergebnis get_search_volume
{
  "country": "de",
  "months": 12,
  "results": [
    {
      "keyword": "gartenmöbel",
      "search_volume": 110000,
      "cpc": 0.86,
      "cpc_high": 1.02,
      "cpc_low": 0.21,
      "competition": 100,
      "yoy": -14,
      "seasonal_peak": "2026-03",
      "monthly": {
        "2025-11": 27100,
        "2025-12": 22200,
        "2026-01": 49500,
        "2026-02": 110000,
        "2026-03": 246000,
        "2026-04": 201000,
        "2026-05": 201000,
        "2026-06": 135000,
        "2026-07": 110000,
        "2026-08": 90500,
        "2026-09": 49500,
        "2026-10": 33100
      }
    }
  ],
  "skipped": [
    "was?"
  ]
}

Fehler

Ohne gültigen Key antwortet der Server mit HTTP 401 (JSON-RPC-Fehler -32001), ist der Key für keine API freigeschaltet, mit 403 (-32003). Fehler bei einem Tool-Aufruf kommen als Tool-Ergebnis mit isError: true und demselben Fehlercode wie bei der API, etwa invalid_country, rate_limited oder endpoint_not_allowed, damit der Assistent darauf reagieren kann.

Limits

Es gelten dieselben Limits wie bei den APIs: pro Key 10 Abfragen pro Minute und 500 pro Tag, jeder Tool-Aufruf zählt einmal. Eigene Tages- oder Monatslimits einer API, etwa der Ranking API, gelten auch für das passende Tool.