google-surf-mcp

✨Anti-Bot-Such-MCP: Kein API-Schlüssel erforderlich✨

Englisch | 한국어

Nur Demo. Tatsächliche Suchen werden standardmäßig headless (ohne sichtbaren Browser) ausgeführt. Setzen Sie SURF_HEADLESS=false, um Chrome wie im Clip oben sichtbar zu machen.

Google-Such-MCP. Kein API-Schlüssel. Funktioniert einfach.

• ✅ Funktioniert tatsächlich (habe 6 kostenlose Google-Such-MCPs getestet, alle sind fehlgeschlagen)

• ✅ Suche + URL-Extraktion in einem MCP (ersetzt die übliche Kombination aus Such-MCP + Fetch-MCP)

• ✅ 4 Tools: search / search_parallel / extract / search_extract

• ✅ Kein API-Schlüssel, keine Proxys, kein Solver

• ✅ Automatische CAPTCHA-Wiederherstellung (Chrome öffnet sich, Mensch löst einmal, Aufruf wird wiederholt)

• ✅ SSRF-Schutz bei extract (blockiert standardmäßig localhost, private IPs, AWS-Metadaten)

Was ist das?

Binden Sie es in einen beliebigen MCP-Client ein und Sie erhalten die Google-Suche als Tool.

Kein CAPTCHA-Solver. Wenn bei einem Tool ein CAPTCHA ausgelöst wird, öffnet sich ein Chrome-Fenster, damit ein Mensch es lösen kann. Jede Lösung bewahrt die Reputation des Profils bei Google. Entwickelt für nachhaltige, ethische Nutzung.

Die einmalige Installation erfordert ein ca. 1-sekündiges Aufwärmen des Profils (siehe Installation).

Für die lokale Nutzung konzipiert. Nicht für zustandslose / serverlose Bereitstellungen geeignet.

Related MCP server: G-Search MCP

Zahlen

Gemessen auf einer Workstation mit einer 1Gb/s-Verbindung.

Stack

• Playwright + persistentes Chrome-Profil

• playwright-extra Stealth

• Ressourcenblockierung für Bilder / Medien / Schriftarten zur Geschwindigkeitsoptimierung

• Einmaliges Profil-Bootstrap vor dem ersten Lauf

• Mozilla Readability + Turndown für die Artikel-Extraktion

Installation

Erfordert Node 18+ und Google Chrome (oder Chromium) auf dem System.

npx google-surf-mcp   # actual MCP - register in client config

Oder lokaler Klon:

git clone https://github.com/HarimxChoi/google-surf-mcp
cd google-surf-mcp
npm install
npm run bootstrap

bootstrap öffnet ein Chrome-Fenster. Führen Sie darin eine Google-Suche durch. Schließen. Das Profil ist jetzt aufgewärmt.

Überschreiben Sie bei Bedarf die Pfade:

CHROME_PATH=/path/to/chrome SURF_TZ=America/New_York npm run bootstrap

Verwendung mit Claude Code

Fügen Sie dies in Ihre ~/.claude.json ein:

{
  "mcpServers": {
    "google-surf": {
      "command": "npx",
      "args": ["-y", "google-surf-mcp"]
    }
  }
}

Starten Sie Claude Code neu. Fertig. search, search_parallel, extract, search_extract sind jetzt verfügbar.

Für andere MCP-Clients verwenden Sie die gleiche JSON-Struktur in deren Konfigurationsdatei.

Variante für lokalen Klon:

{
  "mcpServers": {
    "google-surf": {
      "command": "node",
      "args": ["/abs/path/to/google-surf-mcp/build/index.js"]
    }
  }
}

Tools

• search(query, limit?) - einzelne Abfrage, ~1,5s. Gibt Titel / URL / Snippet zurück. Gesponserte Anzeigen werden herausgefiltert.

• search_parallel(queries[], limit?) - Pool von 4, maximal 10 Abfragen pro Aufruf.

• extract(url, max_chars?) - URL abrufen, Artikel-Markdown zurückgeben (Readability mit Text-Fallback). Fehler geben { error } zurück, lösen niemals eine Exception aus.

• search_extract(query, limit?, max_chars?) - Suche + parallele Extraktion in einem Aufruf. Gibt SERP-Ergebnisse angereichert mit vollständigem Artikelinhalt zurück. Fehler pro Seite sind isoliert.

search_extract ist das Highlight: SERP + vollständiger Artikelinhalt in einem einzigen Aufruf. Ersetzt die übliche Kombination aus "Such-MCP + URL-Fetcher-MCP", die die meisten Agenten zusammenfügen.

Umgebungsvariablen

Fehlerbehebung

• CAPTCHA: Ein sichtbares Chrome-Fenster öffnet sich automatisch (funktioniert für alle 4 Tools). Lösen Sie es einmal, führen Sie eine Suche darin durch, der Aufruf wird wiederholt und fortgesetzt. Um stattdessen sofort abzubrechen, führen Sie es ohne angeschlossenes Display aus.

• "Chrome not found": Installieren Sie Chrome oder setzen Sie CHROME_PATH.

• Veraltete Selektoren: Google rotiert Klassen. Pull Requests sind willkommen.

Changelog

Siehe CHANGELOG.md.

Lizenz

MIT