dsh-google-chrome-search

Ein DeepSeek Harness (DSH) Plugin, das es einem KI-Agenten ermöglicht, eine echte Google-Websuche durchzuführen, indem es den lokalen Chrome-Browser über CDP (Chrome DevTools Protocol) steuert und beliebige Seiten rendert, um deren Inhalt zu extrahieren. Kein Such-API-Schlüssel erforderlich – es funktioniert mit dem bereits auf dem Rechner installierten Chrome.

Google zeigt für automatisierten und Rechenzentrums-Traffic häufig eine Seite zur menschlichen Verifizierung (CAPTCHA / „ungewöhnlicher Traffic"). Wenn das passiert, öffnet dieses Plugin ein sichtbares Chrome-Fenster, das auf die Verifizierungsseite zeigt, wartet darauf, dass der Mensch sie löst, und extrahiert dann die Ergebnisse aus der nun vertrauenswürdigen Sitzung. Das ist der Schritt „den Menschen fragen" – der Agent versucht niemals, ein CAPTCHA selbst zu lösen.

Was Sie erhalten

Related MCP server: browser-search-mcp

Voraussetzungen

• Node.js ≥ 18 (getestet mit Node 22)

• Ein lokales Chrome/Chromium-Binary (z. B. google-chrome, chromium). Wird automatisch aus gängigen Pfaden erkannt; überschreibbar mit CHROME_PATH oder --chrome.

• Für den sichtbaren Verifizierungsschritt wird eine Desktop-Sitzung mit Display benötigt (damit das Chrome-Fenster dem Menschen gezeigt werden kann). Headless/SSH kann das CAPTCHA weiterhin erkennen und melden (mit einem Screenshot).

Installation

git clone https://github.com/davidcastilloalvarado/dsh-google-chrome-search.git
cd dsh-google-chrome-search
npm install

Abhängigkeiten: puppeteer-core (steuert Ihr Chrome – es lädt keinen Browser herunter), @modelcontextprotocol/sdk (für den MCP-Server), @mozilla/readability (Inhalts-Extraktion) und zod (Schema-Validierung).

Optional die CLI global verlinken, damit sie im PATH ist:

npm link        # gives you: dsh-google-search "<query>"

CLI verwenden

# Search:
node bin/google-search.mjs "nodejs streams" --max 8
# or, after npm install / npm link:
npm run search -- "nodejs streams" --json

# Search, then render + extract the top 3 result pages:
node bin/google-search.mjs "nodejs streams" --max 8 --fetch-top 3 --fetch-max-chars 8000

# Fetch one URL directly (render + extract readable content):
node bin/google-search.mjs fetch "https://nodejs.org/api/stream.html" --max-chars 8000

Exit-Codes: 0 = Erfolg (Ergebnisse / abgerufener Inhalt), 2 = Verifizierung erforderlich (CAPTCHA), 3 = keine Ergebnisse / Abruf blockiert oder fehlgeschlagen, 1 = Fehler, 64 = Verwendung.

Seite abrufen (rendern + extrahieren)

Das Plugin kann auch beliebige URLs rendern und deren lesbaren Hauptinhalt extrahieren:

• Führt die Seite im gleichen dedizierten Chrome-Profil aus (so verhalten sich Seiten, die einen konsistenten, vertrauenswürdigen Fingerabdruck sehen, besser).

• Wartet, bis die Seite vollständig geladen ist (einschließlich später SPA-Inhalte).

• Extrahiert den Artikel mit Mozilla Readability, das innerhalb der Live-Seite ausgeführt wird. Wenn die Seite keinen eindeutigen Artikel hat, wird auf den vollständigen Seitentext zurückgegriffen.

• Begrenzte Ausgabe (Standard 8.000 Zeichen pro Seite), damit sie agentenkontextfreundlich bleibt.

• Erkennt Anti-Bot-Wände und meldet blocked, statt Müll zurückzugeben. Wenn eine Website eine Herausforderung zur menschlichen Verifizierung ausliefert (z. B. DataDomes „Schieben zum Fortfahren"-Wand), öffnet es ein sichtbares Chrome-Fenster mit der Seite, wartet bis zu verifyTimeoutMs, bis der Mensch sie besteht, und extrahiert dann den echten Inhalt – dieselbe Hand-an-Mensch-Philosophie wie beim Google-CAPTCHA-Ablauf. Das vertrauenswürdige Sitzungscookie bleibt im Profil erhalten, sodass spätere Seiten dieser Website normalerweise headless durchgehen. Verwenden Sie --no-verify / autoVerify: false, um stattdessen einfach blocked zu melden.

dsh-google-search fetch "https://example.com/article" --max-chars 10000
dsh-google-search fetch "https://example.com/article" --html --screenshot

Zwei Möglichkeiten, Suche und Lesen zu kombinieren:

Seiten werden sequenziell gerendert (ein Browser, eine Seite nach der anderen) – rechnen Sie mit ~1–3 s pro Seite.

Als natives DSH-Tool verwenden (MCP)

Registrieren Sie den MCP-Server mit DSHs @deepseek-ai/dsh-mcp-client in Ihrer Profilkonfiguration (Beispiel – passen Sie die command- und args-Pfade an Ihre Umgebung an):

- insert:
    - id: mcp-google
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: google
        transport: stdio
        command: /path/to/node
        args: [ /path/to/dsh-google-chrome-search/src/server.mjs ]
        env:
          CHROME_PATH: /usr/bin/google-chrome   # optional — auto-detected if unset
        toolCallTimeoutMs: 300000

Nach einem DSH-Neustart erhält der Agent drei native Tools:

Hinweise:

• Aufrufe werden serialisiert (Chrome erlaubt nur einen Prozess pro Profil), daher werden gleichzeitige Tool-Aufrufe in eine Warteschlange gestellt, statt parallel zu laufen.

• search_and_fetch ist langsamer als eine einfache Suche: Halten Sie toolCallTimeoutMs bei 300000 (5 Minuten), wie oben gezeigt.

• Der Ablauf zur menschlichen Verifizierung gilt sowohl für die Google-Suche (CAPTCHA) als auch für Ergebnis-Seiten, die den Browser blockieren (Anti-Bot-Slider): Ein sichtbares Chrome-Fenster öffnet sich für den Menschen, und die Sitzung bleibt danach im Profil erhalten.

Als DSH-Skill verwenden

skill/SKILL.md bringt dem Agenten bei, wie die Suche ausgeführt wird und wie die CAPTCHA-Übergabe an den Menschen gehandhabt wird. Zur Installation kopieren Sie es in Ihr DSH-Skills-Verzeichnis, z. B.:

mkdir -p ~/.dsh/skills/google-chrome-search
cp skill/SKILL.md ~/.dsh/skills/google-chrome-search/

Bevor Sie es auf einem anderen Rechner teilen/verwenden, bearbeiten Sie den Platzhalter <INSTALL_DIR> in SKILL.md, sodass er auf den Ort zeigt, an dem Sie dieses Repository geklont haben (oder legen Sie die npm link-CLI auf PATH und es funktioniert einfach).

Konfiguration (env / Optionen)

Der Ablauf zur menschlichen Verifizierung, Schritt für Schritt

1. Chrome führt die Suche headless aus (ein dediziertes, isoliertes Profil – niemals Ihr echter Browser).

2. Wenn Ergebnisse vorhanden sind → zurückgeben (status: ok).

3. Wenn Google ein CAPTCHA ausliefert:

   • Screenshot davon machen.

   • Ein sichtbares Chrome-Fenster (gleiches Profil) auf der Verifizierungsseite öffnen.

   • Bis zu verifyTimeoutMs auf die Lösung durch den Menschen warten, die Seite dabei pollen.

   • Wenn gelöst → Ergebnisse extrahieren + zurückgeben (gekennzeichnet mit verifiedViaHuman: true). Wenn Zeitüberschreitung → status: verification_required mit dem neuesten Screenshot zurückgeben.

4. Die verifizierte Sitzung bleibt im Profil erhalten, sodass die nächste Suche normalerweise headless erfolgreich ist.

Testen

npm test

Startet den MCP-Server, prüft, ob die Tools search, fetch und search_and_fetch aufgelistet sind, und – falls ein Chrome-Binary auf dem Rechner verfügbar ist – führt eine Live-Suche mit autoVerify: false durch. In Umgebungen ohne Browser (z. B. CI) wird der Live-Aufruf elegant übersprungen.

Fehlerbehebung

Zurücksetzen / Bereinigen

• Konfiguration: Entfernen Sie den Eintrag mcp-google aus Ihrer DSH-Profilkonfiguration.

• Skill: rm -rf ~/.dsh/skills/google-chrome-search

• Profil/Screenshots: rm -rf ~/.dsh-chrome-google

Lizenz

MIT