SerpApi MCP-Server

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

Funktionen

• Multi-Engine-Suche: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay und mehr

• Engine-Ressourcen: Parameterschemata pro Engine sind über MCP-Ressourcen verfügbar (siehe Such-Tool)

• Echtzeit-Wetterdaten: Standortbezogenes Wetter mit Vorhersagen über Suchanfragen

• Aktienmarktdaten: Unternehmensfinanzdaten 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

Related MCP server: SearXNG MCP Server

Schnellstart

Der 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 so konfigurieren, dass der gehostete Server verwendet wird:

{
  "mcpServers": {
    "serpapi": {
      "type": "http",
      "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 '...'

Such-Tool

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

Die Parameter, die Sie angeben können, sind spezifisch für jede API-Engine. Einige Beispielparameter finden Sie unten:

• params.q (erforderlich): Suchanfrage

• params.engine: Suchmaschine (Standard: "google_light")

• params.location: Geografischer Filter

• mode: Antwortmodus - "complete" (Standard) oder "compact"

• ...siehe weitere Parameter 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.

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

• "Missing API key": Fügen Sie den Schlüssel im URL-Pfad /{YOUR_KEY}/mcp oder im Header Bearer YOUR_KEY hinzu

• "Invalid key": Überprüfen Sie diesen unter serpapi.com/dashboard

• "Rate limit exceeded": Warten Sie oder führen Sie ein Upgrade Ihres SerpApi-Plans durch

• "No results": Versuchen Sie eine andere Suchanfrage oder Engine

Mitwirken

1. Forken Sie das Repository

2. Erstellen Sie Ihren Feature-Branch: git checkout -b feature/amazing-feature

3. Installieren Sie Abhängigkeiten: uv install

4. Führen Sie Ihre Änderungen durch

5. Committen Sie die Änderungen: git commit -m 'Add amazing feature'

6. Pushen Sie zum Branch: git push origin feature/amazing-feature

7. Öffnen Sie einen Pull Request

Lizenz

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