SerpApi MCP

SerpApi MCP Server

Eine Model Context Protocol (MCP) Server-Implementierung, die sich mit SerpApi für umfassende Suchmaschinenergebnisse und Datenextraktion integriert.

Funktionen

• Multi-Engine-Suche: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay und mehr
• Engine-Ressourcen: Pro-Engine-Parameterschemata verfügbar über MCP-Ressourcen (siehe Suchwerkzeug)
• Echtzeit-Wetterdaten: Standortbezogenes Wetter mit Vorhersagen über Suchanfragen
• Aktienmarktdaten: Unternehmensfinanzen und Marktdaten durch Suchintegration
• Dynamische Ergebnisverarbeitung: Erkennt und formatiert automatisch verschiedene Ergebnistypen
• Flexible Antwortmodi: Vollständige oder kompakte JSON-Antworten
• JSON-Antworten: Strukturierte JSON-Ausgabe mit vollständigen oder kompakten Modi
• Interaktive Benutzeroberfläche (MCP-Apps): Opt-in search_table und search_dashboard Werkzeuge, die Ergebnisse als interaktive Benutzeroberfläche in unterstützenden Hosts rendern

Schnellstart

SerpApi MCP Server ist als gehosteter Dienst unter mcp.serpapi.com verfügbar. Um eine Verbindung herzustellen, müssen Sie einen API-Schlüssel angeben. Sie finden Ihren API-Schlüssel in Ihrem SerpApi-Dashboard.

Sie können Claude Desktop für die Nutzung des gehosteten Servers konfigurieren:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

Sie können den gehosteten Server auch zu diesen MCP-Clients hinzufügen:

OpenClaw

openclaw mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp --transport streamable-http

Claude Code

claude mcp add --transport http serpapi https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Hermes

hermes mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Codex

codex mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp

Selbst-Hosting

git clone https://github.com/serpapi/serpapi-mcp.git
cd serpapi-mcp
uv sync && uv run src/server.py

Konfigurieren Sie Claude Desktop:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

Holen Sie sich Ihren API-Schlüssel: serpapi.com/manage-api-key

Authentifizierung

Zwei Methoden werden unterstützt:

• Pfadbasiert: /YOUR_API_KEY/mcp (empfohlen)
• Header-basiert: Authorization: Bearer YOUR_API_KEY

Beispiele:

# Path-based
curl "https://mcp.serpapi.com/your_key/mcp" -d '...'

# Header-based  
curl "https://mcp.serpapi.com/mcp" -H "Authorization: Bearer your_key" -d '...'

Suchwerkzeug

Der MCP-Server verfügt über ein Hauptsuchwerkzeug, das alle SerpApi-Engines und Ergebnistypen unterstützt. Alle verfügbaren Parameter finden Sie in der SerpApi API-Referenz. Engine-Parameterschemata sind auch als MCP-Ressourcen verfügbar: serpapi://engines (Index) und serpapi://engines/<engine>.

Die bereitstellbaren Parameter sind spezifisch für jede API-Engine. Einige Beispielparameter sind unten aufgeführt:

• params.q (erforderlich): Suchanfrage
• params.engine: Suchmaschine (Standard: "google_light")
• params.location: Geografischer Filter
• mode: Antwortmodus - "complete" (Standard) oder "compact"
• ...weitere Parameter finden Sie in der SerpApi API-Referenz

Beispiele:

{"name": "search", "arguments": {"params": {"q": "coffee shops", "location": "Austin, TX"}}}
{"name": "search", "arguments": {"params": {"q": "weather in London"}}}
{"name": "search", "arguments": {"params": {"q": "AAPL stock"}}}
{"name": "search", "arguments": {"params": {"q": "news"}, "mode": "compact"}}
{"name": "search", "arguments": {"params": {"q": "detailed search"}, "mode": "complete"}}

Unterstützte Engines: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay und mehr (siehe serpapi://engines).

Ergebnistypen: Antwortboxen, organische Ergebnisse, Nachrichten, Bilder, Shopping – automatisch erkannt und formatiert.

Interaktive Benutzeroberfläche (MCP-Apps)

Das Standardwerkzeug search gibt JSON zurück und bleibt unverändert. Für Hosts, die die MCP Apps-Erweiterung (SEP-1865) unterstützen, rendern zwei Opt-in-Werkzeuge Ergebnisse als interaktive Benutzeroberfläche direkt in der Konversation, sodass das umfangreiche SERP-JSON niemals in das Kontextfenster des Modells gelangt:

• search_table: organische Ergebnisse als sortierbare, durchsuchbare Tabelle.
• search_dashboard: Zusammenfassungsmetriken, ein Diagramm zur Quellenaufschlüsselung und eine Ergebnistabelle mit einem Detailpanel zum Aufklappen.

Beide akzeptieren dieselben params wie search. Hosts, die MCP Apps nicht unterstützen, ignorieren diese Werkzeuge einfach.

Vorschau lokal ohne MCP-Host:

uv run fastmcp dev apps src/server.py

Entwicklung

# Local development
uv sync && uv run src/server.py

# Docker
docker build -t serpapi-mcp . && docker run -p 8000:8000 serpapi-mcp

# Regenerate engine resources (Playground scrape)
python build-engines.py

# Testing with MCP Inspector
npx @modelcontextprotocol/inspector
# Configure: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"

Fehlerbehebung

• "Fehlender API-Schlüssel": Schlüssel im URL-Pfad /{YOUR_KEY}/mcp oder Header Bearer YOUR_KEY angeben
• "Ungültiger Schlüssel": Überprüfen unter serpapi.com/dashboard
• "Ratenlimit überschritten": Warten oder SerpApi-Plan upgraden
• "Keine Ergebnisse": Andere Suchanfrage oder Engine ausprobieren

Mitwirken

1. Repository forken
2. Feature-Branch erstellen: git checkout -b feature/amazing-feature
3. Abhängigkeiten installieren: uv install
4. Änderungen vornehmen
5. Änderungen committen: git commit -m 'Add amazing feature'
6. Branch pushen: git push origin feature/amazing-feature
7. Pull Request öffnen

Lizenz

MIT-Lizenz – siehe LICENSE Datei für Details.