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 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:
{
"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.
| Tool | API | Wofür |
|---|---|---|
get_search_volume | Suchvolumen API | Suchvolumen, CPC, Wettbewerb, Trend und Saison für bis zu 500 Keywords |
get_search_volume_forecast | Suchvolumen-Prognose API | Prognose für 12 Monate mit Spanne, Saison und Online-bis-Termin |
get_keyword_ideas | Keyword Tool API | Verwandte Keywords zu bis zu 10 Keywords oder einer URL |
get_suggest_keywords | Suggest API | Autocomplete-Keywords aus 14 Quellen, optional mit Suchvolumen |
get_questions | Fragen API | W-Fragen zu einem Keyword |
get_google_rankings | Ranking API | Google-Ergebnisse, auch lokal und mobil, mit deiner Position |
seo_check | SEO Check API | SEO Check einer URL, auf Wunsch nur einzelne Bereiche |
get_core_web_vitals | Chrome UX Report API | Core Web Vitals aus echten Nutzerdaten für bis zu 10 URLs |
compare_source | Quelltext-Vergleich API | Unterschiede zwischen zwei User Agents, z. B. Googlebot und Chrome |
check_hreflang | Hreflang API | hreflang-Prüfung einer Seite oder XML-Sitemap |
create_content_briefing | Content Briefing API | Zielwerte 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:
| Feld | Bedeutung |
|---|---|
results | Je Keyword search_volume, cpc, cpc_high, cpc_low, competition (0 bis 100), yoy (Veränderung zum Vorjahr in Prozent), seasonal_peak und monthly |
skipped | Keywords mit Sonderzeichen oder über 55 Zeichen, die der Dienst nicht abfragen kann |
{
"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.
Inhaltsverzeichnis