Allgemeine Einführung
G-Search-MCP ist ein Open-Source-Google-Suchwerkzeug, das auf GitHub vom Entwickler jae-jae gehostet wird und auf dem google-suche Geändert. Es läuft über den MCP (Model Context Protocol) Server, die Kernfunktion ist die Unterstützung mehrerer Schlüsselwörter zur gleichen Zeit in der Google-Suche. Die Suchergebnisse werden im JSON-Format zurückgegeben, das für die Benutzer leicht zu verarbeiten und zu analysieren ist. Dieses Tool verwendet den Playwright-Browser, um die Arbeitsweise echter Nutzer zu simulieren, wodurch das Risiko, von Google blockiert zu werden, wirksam verringert werden kann. Es eignet sich für Benutzer, die schnell eine große Menge an Informationen abrufen müssen, wie Entwickler, Forscher oder Datenanalysten. Das Projekt bietet auch eine flexible Konfiguration von Parametern, wie z. B. der Anzahl der Ergebnisse und der Sprachauswahl.
Funktionsliste
- Parallele Suche nach mehreren SchlüsselwörternUnterstützt die gleichzeitige Suche nach mehreren Stichwörtern, um die Effizienz zu erhöhen.
- Browser-OptimierungSparen Sie Ressourcen, indem Sie mehrere Registerkarten in einer einzigen Browserinstanz öffnen.
- Automatische CAPTCHA-ErkennungCAPTCHA: Schalten Sie in den sichtbaren Modus, wenn das CAPTCHA gefunden wird, und warten Sie, bis der Benutzer es überprüft hat.
- Simulation des BenutzerverhaltensNachahmung echter Benutzeroperationen, um Einschränkungen durch Suchmaschinen zu vermeiden.
- JSON-DatenausgabeDie Suchergebnisse werden in einem strukturierten Format zurückgegeben, um die Nutzung durch das Programm zu erleichtern.
- ParametrisierungOptionen wie Anzahl der Ergebnisse, Timeout, Sprachregion usw. können eingestellt werden.
Hilfe verwenden
G-Search-MCP ist ein technisches Werkzeug, das installiert und konfiguriert werden muss, um genutzt werden zu können. Der Installationsprozess und die Bedienung werden im Folgenden detailliert beschrieben.
Einbauverfahren
- Überprüfung der Umweltanforderungen
- Erfordert Node.js 18 oder höher, mit NPM oder Yarn installiert.
- Stellen Sie sicher, dass Ihr Computer über Git zum Herunterladen von Code verfügt.
- Bereiten Sie einen modernen Browser (z.B. Chromium) vor und das Tool wird automatisch installiert.
- Projektcode herunterladen
- Öffnen Sie ein Terminal und führen Sie den Befehl aus:
git clone https://github.com/jae-jae/g-search-mcp.git
- Rufen Sie den Projektkatalog auf:
cd g-search-mcp
- Öffnen Sie ein Terminal und führen Sie den Befehl aus:
- Installation von Abhängigkeiten
- Geben Sie den Befehl zur Installation der erforderlichen Pakete ein:
npm install
- Geben Sie den Befehl zur Installation der erforderlichen Pakete ein:
- Playwright-Browser installieren
- Führen Sie den folgenden Befehl aus, um den Chromium-Browser zu installieren:
npx playwright install chromium
- Dieser Schritt stellt sicher, dass das Tool die Browserinstanz ordnungsgemäß ausführt.
- Führen Sie den folgenden Befehl aus, um den Chromium-Browser zu installieren:
- Server aufbauen
- Geben Sie den Befehl zum Erstellen des Projekts ein:
npm run build
- Geben Sie den Befehl zum Erstellen des Projekts ein:
- Schnellstart
- Verwenden Sie den Befehl, um ihn direkt auszuführen:
npx -y g-search-mcp
- Der Server ist nach dem Starten betriebsbereit.
- Verwenden Sie den Befehl, um ihn direkt auszuführen:
Konfigurieren des MCP-Servers (optional)
Wenn Sie an der Claude Mit diesem Werkzeug im Desktop können Sie die MCP Server:
- Pfad der Konfigurationsdatei
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Fenster:
%APPDATA%/Claude/claude_desktop_config.json
- MacOS:
- Inhalt der Konfiguration
- Bearbeiten Sie die JSON-Datei und fügen Sie Folgendes hinzu:
{ "mcpServers": { "g-search": { "command": "npx", "args": ["-y", "g-search-mcp"] } } }
- Bearbeiten Sie die JSON-Datei und fügen Sie Folgendes hinzu:
Wie zu verwenden
grundlegende Bedienung
- Suche nach einem einzelnen Schlüsselwort
- Befehl ausführen:
npx -y g-search-mcp --keywords "人工智能"
- Der Browser öffnet eine Registerkarte, um die Ergebnisse anzuzeigen, und das Terminal gibt JSON-Daten zurück.
- Befehl ausführen:
- Suche nach mehreren Stichwörtern
- Geben Sie mehrere Schlüsselwörter ein, die durch Kommas getrennt sind:
npx -y g-search-mcp --keywords "人工智能,机器学习"
- Der Browser öffnet mehrere Registerkarten, eine für jedes Stichwort.
- Geben Sie mehrere Schlüsselwörter ein, die durch Kommas getrennt sind:
Featured Function Bedienung
- Anpassung der Anzahl der Ergebnisse
- ausnutzen
--limit
Parameter:npx -y g-search-mcp --keywords "人工智能" --limit 20
- Gibt die ersten 20 Ergebnisse zurück, Standard ist 10.
- ausnutzen
- Einstellung der Timeout-Zeit
- ausnutzen
--timeout
Parameter:npx -y g-search-mcp --keywords "人工智能" --timeout 120000
- Setzen Sie die Zeitüberschreitung auf 120 Sekunden; der Standardwert ist 60 Sekunden.
- ausnutzen
- Sprachregion ändern
- ausnutzen
--locale
Parameter:npx -y g-search-mcp --keywords "人工智能" --locale "zh-CN"
- Die Ergebnisse werden vorrangig in Chinesisch angezeigt.
- ausnutzen
- Debug-Modus einschalten
- erhöhen.
--debug
Parameter:npx -y g-search-mcp --keywords "人工智能" --debug
- Sichtbar im Browser-Fenster, damit der Vorgang leicht zu erkennen ist.
- erhöhen.
- CAPTCHA-Behandlung
- Wenn ein CAPTCHA auftritt, hält das Tool an und zeigt das Browserfenster an.
- Nachdem der Benutzer die Validierung manuell abgeschlossen hat, wird das Tool weiter ausgeführt.
- Anzeigen der JSON-Ausgabe
- Nach Abschluss der Suche zeigt das Terminal ähnliche Ergebnisse wie die folgenden an:
{ "searches": [ { "query": "人工智能", "results": [ { "title": "人工智能简介", "link": "https://example.com", "snippet": "人工智能是..." } ] } ] }
- Die Ergebnisse können in einer Datei gespeichert werden:
npx -y g-search-mcp --keywords "人工智能" > result.json
- Nach Abschluss der Suche zeigt das Terminal ähnliche Ergebnisse wie die folgenden an:
Entwicklungsmodus (optional)
- Automatisch wiederherstellen: Lauf
npm run watch
Der Code wird automatisch geändert und aktualisiert. - Tools zur Fehlersuche: Lauf
npm run inspector
Um den Betriebsstatus zu überprüfen, verwenden Sie MCP Inspector.
caveat
- Netzanschluss: Internetzugang zu den Google-Diensten ist erforderlich.
- RessourcenbelegungDie Suche nach mehreren Stichwörtern kann mehr Speicherplatz beanspruchen.
- KompetenzfragenVergewissern Sie sich, dass das Terminal über ausreichende Berechtigungen zur Ausführung des Befehls verfügt.
Beispiel für den Betrieb
Nehmen wir an, Sie suchen nach "Blockchain" und "intelligente Verträge":
- Geben Sie den Befehl ein:
npx -y g-search-mcp --keywords "区块链,智能合约" --limit 15 --locale "zh-CN"
- Der Browser öffnet zwei Registerkarten und zeigt chinesische Suchergebnisse an.
- Das Terminal gibt JSON-Daten zurück, die den Titel, den Link und die Zusammenfassung der einzelnen Ergebnisse enthalten.
Dieses Tool ist für technische Benutzer intuitiv und leistungsstark, um Informationen in großen Mengen zu sammeln.
Anwendungsszenario
- Technische Studien
Entwickler können damit nach Schlüsselwörtern wie "Front-End-Frameworks" und "Back-End-Technologien" suchen, um Informationen schnell zu vergleichen. - Datenanalyse
Analysten können die JSON-Ausgabe zur Analyse von Schlüsselwörtern wie "Markttrends" und "Nutzerbedürfnisse" verwenden. - Pädagogische Unterstützung
Die Schüler können damit nach "Physik" und "Chemische Reaktionen" suchen, um schnell auf Lernressourcen zuzugreifen.
QA
- Was soll ich tun, wenn Playwright beim Starten fehlt?
in Bewegung seinnpx playwright install chromium
Installieren Sie den Browser. - Was ist, wenn die Suchergebnisse unvollständig sind?
Überprüfen Sie das Netzwerk, oder fügen Sie--timeout
Zeit, z. B. 120000 Millisekunden. - Wie kann ich meine Suchergebnisse speichern?
Fügen Sie nach dem Befehl> 文件名.json
Zum Beispielnpx -y g-search-mcp --keywords "人工智能" > result.json
.