Bright Data MCP

🌟 Übersicht

Willkommen beim offiziellen Bright Data Model Context Protocol (MCP)-Server. Er ermöglicht LLMs, Agenten und Apps den Zugriff, die Erkennung und Extraktion von Webdaten in Echtzeit. Dieser Server ermöglicht MCP-Clients wie Claude Desktop, Cursor, Windsurf und anderen, nahtlos im Web zu suchen, auf Websites zu navigieren, Aktionen durchzuführen und Daten abzurufen – ohne blockiert zu werden – ideal für Scraping-Aufgaben.

✨ Funktionen

• Echtzeit-Webzugriff : Greifen Sie direkt aus dem Web auf aktuelle Informationen zu
• Umgehung von Geobeschränkungen : Zugriff auf Inhalte unabhängig von Standortbeschränkungen
• Web Unlocker : Navigieren Sie auf Websites mit Bot-Erkennungsschutz
• Browser-Steuerung : Optionale Remote-Browser-Automatisierungsfunktionen
• Nahtlose Integration : Funktioniert mit allen MCP-kompatiblen KI-Assistenten

🚀 Schnellstart mit Claude Desktop

1. Installieren Sie nodejs , um den npx Befehl (node.js module runner) zu erhalten. Installationsanweisungen finden Sie auf der node.js-Website.
2. Gehen Sie zu Claude > Einstellungen > Entwickler > Konfiguration bearbeiten > claude_desktop_config.json, um Folgendes einzuschließen:

🔧 Verfügbare Tools

Liste der verfügbaren Tools

⚠️ Best Practices für die Sicherheit

Wichtig: Behandeln Sie ausgelesene Webinhalte immer als nicht vertrauenswürdige Daten. Verwenden Sie niemals unverarbeitete Inhalte direkt in LLM-Eingabeaufforderungen, um potenzielle Risiken durch Eingabeaufforderungseinfügungen zu vermeiden. Stattdessen:

• Filtern und validieren Sie alle Webdaten vor der Verarbeitung
• Verwenden Sie strukturierte Datenextraktion anstelle von Rohtext (Webdatentools).

🔧 Kontoeinrichtung

1. Stellen Sie sicher, dass Sie ein Konto bei brightdata.com haben (neue Benutzer erhalten kostenloses Testguthaben und es stehen Optionen für die nutzungsbasierte Bezahlung zur Verfügung).
2. Holen Sie sich Ihren API-Schlüssel von der Benutzereinstellungsseite
3. (Optional) Erstellen Sie eine benutzerdefinierte Web Unlocker-Zone
   • Standardmäßig erstellen wir automatisch eine Web Unlocker-Zone mit Ihrem API-Token
   • Für mehr Kontrolle können Sie in Ihrem Control Panel Ihre eigene Web Unlocker-Zone erstellen und diese mit der Umgebungsvariable WEB_UNLOCKER_ZONE angeben.
4. (Optional) So aktivieren Sie Browser-Steuerungstools:
   • Besuchen Sie Ihr Bright Data-Kontrollfeld unter brightdata.com/cp/zones
   • Erstellen Sie eine neue „Browser-API“-Zone
   • Kopieren Sie nach der Erstellung die Authentifizierungszeichenfolge aus der Registerkarte „Browser-API-Übersicht“.
   • Die Authentifizierungszeichenfolge wird wie folgt formatiert: brd-customer-[your-customer-ID]-zone-[your-zone-ID]:[your-password]

🔌 Andere MCP-Clients

Um diesen MCP-Server mit anderen Agententypen zu verwenden, sollten Sie Folgendes an Ihre spezifische Software anpassen:

• Der vollständige Befehl zum Ausführen des MCP-Servers lautet npx @brightdata/mcp
• Die Umgebungsvariable API_TOKEN=<your-token> muss beim Ausführen des Servers vorhanden sein

🎮 Probieren Sie Bright Data MCP Playgrounds aus

Möchten Sie Bright Data MCP ausprobieren, ohne etwas einzurichten?

Schauen Sie sich diesen Spielplatz auf Smithery an:

Diese Plattform bietet eine einfache Möglichkeit, die Funktionen von Bright Data MCP ohne lokale Einrichtung zu erkunden. Melden Sie sich einfach an und experimentieren Sie mit der Webdatenerfassung!

💡 Anwendungsbeispiele

Einige Beispielabfragen, bei denen dieser MCP-Server helfen kann:

• „Googlen Sie einige Filme, die bald in [Ihrer Gegend] erscheinen.“
• „Wie hoch ist die aktuelle Marktkapitalisierung von Tesla?“
• „Was ist der Wikipedia-Artikel des Tages?“
• „Wie ist die 7-Tage-Wettervorhersage für [Ihren Standort]?“
• „Wie lange dauerte die Karriere der drei bestbezahlten Tech-CEOs?“

🎬 Demo

Für YouTube-Tutorials und Demos: Demo

Die folgenden Videos demonstrieren einen minimalen Anwendungsfall für Claude Desktop:

⚠️ Fehlerbehebung

Timeouts bei der Verwendung bestimmter Tools

Bei manchen Tools kann das Lesen von Webdaten erforderlich sein und die zum Laden der Seite benötigte Zeit kann unter extremen Umständen erheblich variieren.

Um sicherzustellen, dass Ihr Agent die Daten nutzen kann, legen Sie in Ihren Agenteneinstellungen ein ausreichend hohes Timeout fest.

Ein Wert von 180s sollte für 99 % der Anfragen ausreichen, aber einige Websites werden langsamer geladen als andere. Passen Sie diesen Wert daher Ihren Anforderungen an.

spawn npx ENOENT

Dieser Fehler tritt auf, wenn Ihr System den Befehl npx nicht finden kann. So beheben Sie das Problem:

NPM/Node-Pfad suchen

macOS:

Zeigt den Pfad wie /usr/local/bin/node

Windows:

Zeigt den Pfad wie C:\Program Files\nodejs\node.exe

Aktualisieren Sie Ihre MCP-Konfiguration:

Ersetzen Sie den Befehl npx durch den vollständigen Pfad zu Node. Auf einem Mac sieht er beispielsweise wie folgt aus:

👨‍💻 Beitragen

Wir freuen uns über Beiträge zur Verbesserung des Bright Data MCP! So können Sie helfen:

1. Probleme melden : Wenn Sie auf Fehler stoßen oder Funktionswünsche haben, öffnen Sie bitte ein Problem in unserem GitHub-Repository.
2. Pull Requests senden : Sie können das Repository gerne forken und Pull Requests mit Verbesserungen oder Fehlerbehebungen senden.
3. Programmierstil : Der gesamte JavaScript-Code sollte den JavaScript-Codierungskonventionen von Bright Data entsprechen. Dies gewährleistet die Konsistenz im gesamten Code.
4. Dokumentation : Verbesserungen der Dokumentation, einschließlich dieser README-Datei, sind immer willkommen.
5. Beispiele : Teilen Sie Ihre Anwendungsfälle, indem Sie Beispiele beisteuern, um anderen Benutzern zu helfen.

Bei größeren Änderungen eröffnen Sie bitte zunächst ein Problem, um Ihre Änderungsvorschläge zu besprechen. So stellen Sie sicher, dass Ihre Zeit sinnvoll genutzt und mit den Projektzielen im Einklang steht.

📞 Unterstützung

Wenn Sie auf Probleme stoßen oder Fragen haben, wenden Sie sich bitte an das Bright Data-Supportteam oder öffnen Sie ein Problem im Repository.