Bright Data
offiziellEntdecken, extrahieren und interagieren Sie mit dem Web – eine Schnittstelle für den automatisierten Zugriff auf das öffentliche Internet.
Was kann man mit Bright Data MCP machen?
- Websuche — Bitte deinen Assistenten, Bing- oder Google-Suchen auszuführen und strukturierte Ergebnisse mit Links, Titeln und Beschreibungen zurückzugeben.
- Seitenauslesen — Rufe beliebige URLs als sauberes Markdown, Text, HTML oder ld_json ab – mit integrierter Bot-Erkennung und CAPTCHA-Behandlung.
- Strukturierte Plattformdaten — Finde und nutze vorgefertigte Scraper für Websites wie Amazon, LinkedIn, TikTok und npm, um sauberes JSON zu erhalten, statt HTML zu parsen.
- Browserautomatisierung — Navigiere, klicke, tippe, scrolle und erstelle Screenshots von Seiten in einer Remote-Browsersitzung – für interaktive Websites oder solche mit Login-Schranke.
- LLM-Antworten sammeln — Sende Prompts an ChatGPT oder Perplexity und erhalte deren Antworten zurück, um zu vergleichen, wie die einzelnen Dienste eine Marke beschreiben.
- Sammlung in Stapeln — Führe bis zu 5 Suchen aus oder rufe bis zu 5 URLs in einem einzigen Aufruf ab, um Daten parallel zu sammeln.
Dokumentation
Bright Data MCP
Websuche, Seiten-Scraping, strukturierte Datenextraktion und Browser-Automatisierung für KI-Agenten und LLMs über das Model Context Protocol.
Funktioniert mit KI-Agenten, Coding-Agenten, Chat-Assistenten und jedem MCP-kompatiblen Client.
Schnellstart • Preise • Anwendungsfälle • Tools • Agent Skills • Dokumentation • Support
Kostenloses Kontingent: 5.000 Anfragen pro Monat. Keine Kreditkarte erforderlich. Wird monatlich erneuert.
Übersicht
Der Bright Data MCP-Server ermöglicht KI-Agenten den Echtzeitzugriff auf öffentliche Webdaten. Er stellt 30 Tools bereit für:
- Websuche — Bing- und Google-Ergebnisse als strukturierte Daten
- Seitenscraping — beliebige URLs als Markdown oder HTML; Bot-Erkennung, CAPTCHA-Lösung und Proxy-Rotation werden bei jeder Anfrage automatisch übernommen
- Strukturierte Daten (Web Scraper API) — sauberes JSON aus über 1.200 vorgefertigten Scrapern für Amazon, LinkedIn, Instagram, TikTok, YouTube, X, Reddit, Facebook, Crunchbase, Zillow, npm, PyPI und mehr, ohne HTML zu parsen. Sechs Tools finden und starten beliebige davon
- Browser-Automatisierung — in einer Remote-Browsersitzung navigieren, klicken, tippen, Screenshots erstellen und Seiten lesen
- Erfassung von LLM-Antworten — Prompts an ChatGPT und Perplexity senden und deren Antworten als strukturierte Daten erhalten
Jede Anfrage wird über die Entsperrungsinfrastruktur von Bright Data geleitet. Dadurch werden Seiten, die gewöhnliche HTTP-Clients blockieren (Bot-Erkennung, CAPTCHAs, Ratenbegrenzungen, geografische Einschränkungen), normal abgerufen. Keine Proxy-Konfiguration, keine Wartung eines Headless-Browsers und keine Retry-Logik erforderlich.
Zwei Bereitstellungsoptionen: ein gehosteter Remote-Server (eine URL, keine Installation) oder eine lokale Instanz über npx @brightdata/mcp.
Schnellstart
Gehosteter Server — keine Installation. Füge diese URL zu deinem MCP-Client hinzu:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE
Rufe dein API-Token in den Bright Data-Kontoeinstellungen ab. Neue Konten erhalten 5.000 kostenlose Anfragen pro Monat.
Optionale URL-Parameter:
| Parameter | Beschreibung | Beispiel |
|---|---|---|
groups=<ids> | Auf bestimmte Tool-Gruppen beschränken (Standard: alle Tools) | ...&groups=scrapers,browser |
tools=<names> | Auf bestimmte Tools beschränken | ...&tools=search_engine,scrape_as_markdown |
Claude Desktop
- Gehe zu: Settings → Connectors → Add custom connector
- Name:
Bright Data - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - Klicke auf „Add“
Oder lokal ausführen:
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>"
}
}
}
}
Claude Code
claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
Cursor
Zu ~/.cursor/mcp.json hinzufügen:
{
"mcpServers": {
"brightdata": {
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
VS Code
Zu .vscode/mcp.json hinzufügen:
{
"servers": {
"brightdata": {
"type": "http",
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Windsurf
Zu ~/.codeium/windsurf/mcp_config.json hinzufügen:
{
"mcpServers": {
"brightdata": {
"serverUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Gemini CLI
Zu ~/.gemini/settings.json hinzufügen:
{
"mcpServers": {
"brightdata": {
"httpUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Zed
Zu deinen Zed-Einstellungen hinzufügen:
{
"context_servers": {
"brightdata": {
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
}
Warp
Gehe zu Settings > MCP Servers > Add MCP Server und füge Folgendes hinzu:
{
"brightdata": {
"url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
}
}
Andere Clients (lokales npx)
Für jeden Client, der lokale MCP-Server unterstützt:
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>"
}
}
}
}
Preise und kostenloses Kontingent
Jedes Konto umfasst ein monatlich erneuertes kostenloses Kontingent. Für den Einstieg sind weder Kreditkarte noch Verpflichtung erforderlich.
5.000 kostenlose Anfragen pro Monat, die jeweils am 1. des Monats erneuert werden. Nicht genutzte Anfragen werden nicht übertragen. Bei Teamkonten wird das kostenlose Kontingent von allen Nutzern des Kontos gemeinsam genutzt.
Kostenlos enthalten:
- Beliebige Webseiten abrufen und als Markdown extrahieren
- Zugriff auf über 60 vorgefertigte Scraper für beliebte Domains
- Websuche (Bing, Google)
- Web-Entsperrung (Umgehung der Bot-Erkennung, CAPTCHA-Lösung, Proxy-Rotation)
- Browser-Automatisierung
- Geografisches Targeting
Über das kostenlose Kontingent hinaus — nutzungsbasierte Abrechnung, ohne Verpflichtung:
| Suche, Scraping und Extraktion | Browser-Navigation | |
|---|---|---|
| Nutzungsbasierte Abrechnung | 1,50 $ / 1.000 Ergebnisse | 8 $ / GB |
- Wenn das kostenlose Kontingent aufgebraucht ist, werden Anfragen gestoppt. Keine unerwarteten Kosten — es sei denn, du hast Guthaben eingezahlt
- Das Hinzufügen einer Kreditkarte dient nur der Verifizierung; es werden keine Kosten berechnet, solange dein kostenloses Kontingent nicht aufgebraucht und Guthaben eingezahlt ist
- Lege im Control Panel eine Ausgabenobergrenze fest, damit die nutzungsbasierte Abrechnung dein Budget niemals überschreitet
Vollständige Preise, Volumenpläne und Enterprise →
Anwendungsfälle
Recherche in Echtzeit
Beantworte Fragen mit aktuellen Webdaten statt mit Trainingsdaten. Suche und lies anschließend die Quellen.
| Aufgabe | Tools |
|---|---|
| Im Web nach aktuellen Informationen suchen | search_engine, search_engine_batch |
| Eine bestimmte Seite als sauberes Markdown lesen | scrape_as_markdown, scrape_batch |
Beispiel-Prompts: „Wie hoch ist der aktuelle Aktienkurs von Tesla?“, „Rufe die Wettervorhersage für New York von heute ab“, „Finde die meistzitierten Quellen zur EU-KI-Regulierung aus den letzten 6 Monaten“.
E-Commerce-Informationen
Produktdaten als strukturiertes JSON abrufen: Preis, Verfügbarkeit, Bewertung, Anzahl der Rezensionen, Verkäufer und Bilder.
| Aufgabe | Tools |
|---|---|
| Produkte, Rezensionen und Suchergebnisse von Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara und anderen Shops | search_scrapers → get_scraper_details → run_scraper |
| Preisvergleich über mehrere Händler | Derselbe Ablauf mit dem Google Shopping-Scraper |
Beispiel-Prompts: „Vergleiche den Preis dieses Laptops bei Amazon, Walmart und Best Buy“, „Rufe die Bewertung und Anzahl der Rezensionen für ASIN B0D2Q9397Y ab“, „Ist dieses Produkt auf Lager?“.
Markt- und Wettbewerbsanalyse
Erstelle anhand aktueller Daten Wettbewerberprofile: Finanzierung, Mitarbeiterzahl, Stellenangebote, Kundenrezensionen und Preisseiten.
| Aufgabe | Tools |
|---|---|
| Unternehmensfinanzierung, Größe, Mitarbeiter, Stellenanzeigen (Crunchbase, ZoomInfo, LinkedIn) | search_scrapers → run_scraper |
| Kundenstimmung (Google Maps, Facebook, App-Store-Rezensionen) | search_scrapers → run_scraper |
| Preisseiten von Wettbewerbern | scrape_as_markdown, scrape_batch |
| Marktentdeckung | search_engine_batch |
Beispiel-Prompt: „Analysiere Notion als Wettbewerber: Preise, Finanzierung, Einstellungsschwerpunkte und worüber sich Kunden beschweren“.
KI-Agenten mit zuverlässigem Webzugriff
Ersetze integrierte Abruf- und Suchtools, die auf geschützten Websites blockiert werden. Jede Anfrage läuft über die Entsperrungsinfrastruktur, sodass Agenten nicht an Bot-Erkennung, CAPTCHAs oder geografischen Einschränkungen scheitern.
| Aufgabe | Tools |
|---|---|
| Direkter Ersatz für die integrierte Websuche | search_engine |
| Direkter Ersatz für den integrierten URL-Abruf | scrape_as_markdown |
| Parallele Datenerfassung (jeweils 5) | search_engine_batch, scrape_batch |
| Interaktive Websites (Anmeldesperren, endloses Scrollen, dynamische Inhalte) | scraping_browser_* (14 Tools) |
Coding-Agenten
Daten aus Paketregistern bei Bedarf abrufen — ohne Scraping und veraltete Caches.
| Aufgabe | Tools |
|---|---|
| npm- und PyPI-Paketversion, README und Metadaten | run_scraper mit dem npmjs- oder pypi-Scraper (mit search_scrapers finden) |
| Dateien aus GitHub-Repositories lesen | run_scraper mit dem GitHub-Repository-Scraper |
Beispiel-Prompts: „Was ist die neueste Version von express auf npm?“, „Rufe die README des PyPI-Pakets langchain-brightdata ab“.
GEO und Markensichtbarkeit
Sende Prompts an führende LLMs und erhalte deren Antworten als strukturierte Daten. Miss, wie KI-Assistenten deine Marke beschreiben, welche Quellen sie zitieren und was sie empfehlen — die Feedbackschleife für Generative Engine Optimization.
| Aufgabe | Tools |
|---|---|
| ChatGPT-Antworten mit Zitaten und Empfehlungen | chatgpt_ai_insights |
| Perplexity-Antworten mit Quellen | perplexity_ai_insights |
Beispiel-Prompt: „Frage ChatGPT und Perplexity: ‚Welcher Proxy-Anbieter ist der beste?‘ und vergleiche, wie beide uns einstufen“.
Social-Media-Monitoring
Strukturierte Daten von allen wichtigen Plattformen: Profile, Beiträge, Kommentare und Interaktionskennzahlen. Für jeden Datentyp gibt es plattformspezifische Scraper (LinkedIn-Profile, Instagram-Reels, TikTok-Kommentare usw.); finde sie mit search_scrapers und führe sie mit run_scraper aus.
| Plattform | Beispiele für Scraper |
|---|---|
| Personenprofile, Unternehmensprofile, Stellenanzeigen, Beiträge, Personensuche | |
| Profile, Beiträge, Reels, Kommentare | |
| TikTok | Profile, Beiträge, Shop, Kommentare |
| Profile, Beiträge, Marketplace-Angebote, Unternehmensbewertungen, Veranstaltungen | |
| YouTube | Videos, Kanäle, Kommentare |
| X (Twitter) | Beiträge, Beiträge nach Profil |
| Beiträge, Kommentare |
Beispiel-Prompt: „Rufe die letzten 10 Beiträge dieses TikTok-Profils ab und fasse die Interaktionen zusammen“.
Content-Erstellung und akademische Recherche
Sammle Quellenmaterial von mehreren Seiten gleichzeitig, gefiltert nach Aktualität und Relevanz.
| Aufgabe | Tools |
|---|---|
| Mehrere Quellen mit einem Aufruf sammeln | scrape_batch (bis zu 5 URLs) |
| Nachrichten- und Finanzdaten | search_engine mit Nachrichtenabfragen, run_scraper mit dem Yahoo Finance-Scraper |
Vergleich
| Funktion | Bright Data MCP | Typische Web-MCP-Server |
|---|---|---|
| Gesamtzahl der Tools | 30 | 2–10 |
| Plattformspezifische Extraktoren für strukturiertes JSON | Über 1.200 vorgefertigte Scraper für E-Commerce, soziale Medien, Unternehmen, Finanzen, Reisen und App-Stores, verfügbar über 6 Tools | Selten; meist nur generisches Scraping |
| Entsperrung (Umgehung der Bot-Erkennung, CAPTCHA-Lösung, Proxy-Rotation) | In jede Anfrage integriert | Meist nicht vorhanden; geschützte Websites blockieren den Zugriff |
| Suchmaschinen | Bing, Google | Meist eine |
| Browser-Automatisierung | 14 Tools, Remote-Browser, keine lokale Einrichtung | Eingeschränkt oder nicht vorhanden |
| Erfassung von LLM-Antworten (ChatGPT, Perplexity) | Ja | Nicht verfügbar |
| Paketregisterdaten (npm, PyPI) | Ja | Nicht verfügbar |
| Stapelverarbeitung | 10 Suchanfragen oder 10 Scrapes pro Aufruf | Meist nur einzelne Anfragen |
| Geografisches Targeting | Ja | Eingeschränkt oder nicht vorhanden |
| Kostenloses Kontingent | 5.000 Anfragen/Monat, Browser-Automatisierung inklusive, keine Kreditkarte | Unterschiedlich; oft zugang ohne Schlüssel mit Ratenbegrenzung |
Tool-Auswahl: Gruppen
Tools sind in Gruppen organisiert, damit du nur lädst, was du benötigst. Weniger Tools bedeuten weniger Kontext, den dein Agent verarbeiten muss.
- Ohne
GROUPSoderTOOLSsind alle 30 Tools aktiviert. Wenn du einen der beiden Parameter festlegst, ist der Server auf die angegebenen Tools beschränkt GROUPSaktiviert Tool-Bundles. Durch Kommas getrennt:GROUPS="scrapers,browser"(lokal) oder&groups=scrapers,browser(gehostete URL)TOOLSfügt einzelne Tools hinzu:TOOLS="scrape_batch,session_stats". Allein aktiviert es nur die aufgelisteten Tools- Jede Gruppe enthält außerdem
search_engine,scrape_as_markdownundask_brightdata_assistant - Die Gruppen-ID
customist reserviert; verwendeTOOLSfür einzelne Tools | Gruppen-ID | Inhalt | Anzahl der Tools | |----------|----------|-----------| |scrapers| Beliebige vorgefertigte Web Scraper API-Scraper suchen und ausführen (Amazon, LinkedIn, TikTok, npm, ...) | 6 | |browser| Remote-Browser-Automatisierung | 14 | |geo| Antworten von ChatGPT und Perplexity erfassen | 2 | |advanced_scraping| Batch-Tools, Sitzungsstatistiken | 3 |
Ältere Gruppen-IDs (ecommerce, social, business, finance, research, app_stores, travel, code) funktionieren weiterhin und aktivieren die Tools scrapers; social und business fügen außerdem search_dataset und list_dataset_fields hinzu. Alte web_data_*-Namen in TOOLS aktivieren ebenfalls die Tools scrapers.
Konfigurationsbeispiele
Lokaler Server mit Browser-Automatisierung und Batch-Tools:
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>",
"GROUPS": "browser,advanced_scraping"
}
}
}
}
Einrichtung für Coding-Agenten (Claude Code / Cursor / Windsurf) — npm-, PyPI- und GitHub-Daten über die vorgefertigten Scraper:
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "<your-api-token-here>",
"GROUPS": "scrapers"
}
}
}
}
Tool-Referenz (30 Tools)
Welches Tool sollte ich verwenden?
- URL bekannt, Inhalt benötigt:
scrape_as_markdown. Mehrere URLs (bis zu 5):scrape_batch - Informationen suchen:
search_engine. Mehrere Suchanfragen (bis zu 5):search_engine_batch - Strukturierte Daten von einer bekannten Plattform (Amazon, LinkedIn, TikTok, npm, PyPI usw.):
search_scrapers→get_scraper_details→run_scraper— liefert sauberes JSON, schneller und zuverlässiger als das Scraping derselben Seite - Rohes HTML:
scrape_as_markdownmitformat: 'html' - Seite erfordert Interaktion (Klicken, Eingeben, Scrollen, Anmelden):
scraping_browser_*-Tools - Wie ChatGPT/Perplexity auf eine Eingabeaufforderung antworten:
chatgpt_ai_insights/perplexity_ai_insights - Frage zu Bright Data selbst (Produkte, Zonen, Fehler, Einrichtung):
ask_brightdata_assistant
Hinweise zu Scraper-Ausführungen:
- Liefert strukturiertes JSON; Abrechnung pro zurückgegebenem Datensatz
- Datensätze mit einem Feld
errorerläutern fehlgeschlagene Eingaben, z. B. eine URL des falschen Typs - Ergebnisse können umfangreich sein. Halte
limit_per_inputfürdiscover_by_*-Methoden niedrig und führe die Massenerfassung in einem Subagenten aus, sofern dein Framework dies unterstützt, damit Datensätze das Hauptkontextfenster nicht überfluten - Wenn eine Ausführung fehlschlägt, funktioniert
scrape_as_markdownals Fallback für dieselbe URL
Suche und Scraping — 5 Tools
| Tool | Beschreibung | Gruppe |
|---|---|---|
search_engine | Bing (Standard) oder Google durchsuchen. Liefert JSON (Link, Titel, Beschreibung), 10 Ergebnisse pro Seite. Parameter: country, page (ab 0), time_range (hour, day, week, month, year, any; Bing unterstützt nur day, week, year) | Standard / jede Gruppe |
search_engine_batch | Bis zu 5 Suchanfragen in einem Aufruf | Standard / advanced_scraping |
scrape_as_markdown | Beliebige URL. Liefert den Inhalt als Markdown (Standard), Text, HTML oder ld_json | Standard / jede Gruppe |
scrape_batch | Bis zu 5 URLs in einem Aufruf. Liefert den Inhalt als Markdown (Standard), Text, HTML oder ld_json | Standard / advanced_scraping |
session_stats | Anzahl der Tool-Aufrufe in der aktuellen Sitzung | Standard / advanced_scraping |
Web Scraper API — 6 Tools
Suche und führe beliebige der über 1.200 vorgefertigten Scraper von Bright Data aus. Die Scraper-Liste wird von docs.brightdata.com/scrapers.json geladen und täglich aktualisiert. Verfügbar sowohl auf dem gehosteten als auch auf dem lokalen Server. Standardmäßig aktiviert, wenn keine Tools oder Gruppen ausgewählt sind; andernfalls füge die Gruppe scrapers hinzu (&groups=scrapers in der gehosteten URL, GROUPS=scrapers lokal).
Typischer Ablauf: search_scrapers → get_scraper_details → run_scraper. Abrechnung pro Datensatz; discover_by_*-Methoden erfassen bis zu limit_per_input Datensätze pro Eingabe (Standard: 10).
| Tool | Beschreibung | Gruppe |
|---|---|---|
search_scrapers | Scraper nach Website oder Datentyp suchen (z. B. „Amazon-Bewertungen“, „linkedin.com“). Liefert Dataset-ID, Name, Domain und Erfassungsmethoden | Standard / scrapers |
get_scraper_details | Beschreibung, Eingabefelder, Beispieleingabe und wichtigste Ausgabefelder für eine Scraper-Methode | Standard / scrapers |
run_scraper | Eine Scraper-Methode ausführen. Wartet bis zu 45 Sekunden; läuft sie dann noch, wird ein snapshot_id zurückgegeben, mit dem der Status später geprüft werden kann | Standard / scrapers |
get_scraper_progress | Status einer Ausführung: starting, running, ready, failed oder canceled | Standard / scrapers |
get_scraper_results | Datensätze einer abgeschlossenen Ausführung | Standard / scrapers |
refresh_scrapers | Scraper-Liste jetzt neu laden, statt auf die tägliche Aktualisierung zu warten | Standard / scrapers |
Browser-Automatisierung — 14 Tools
Remote-Browsersitzung. Typischer Ablauf: navigieren → Snapshot erstellen → anhand der Referenz interagieren → Inhalte extrahieren oder Screenshot erstellen.
| Tool | Beschreibung |
|---|---|
scraping_browser_navigate | Eine Browsersitzung öffnen oder wiederverwenden und zu einer URL navigieren |
scraping_browser_go_back | Zurück navigieren |
scraping_browser_go_forward | Vorwärts navigieren |
scraping_browser_snapshot | ARIA-Snapshot der Seite mit interaktiven Elementen und Referenzen. Vor Aktionen anhand einer Referenz erforderlich |
scraping_browser_click_ref | Ein Element anhand seiner Referenz aus dem neuesten Snapshot anklicken |
scraping_browser_type_ref | Text in ein Element anhand seiner Referenz eingeben; optional zum Absenden Enter drücken |
scraping_browser_fill_form | Mehrere Formularfelder anhand ihrer Referenzen in einem Aufruf ausfüllen |
scraping_browser_screenshot | Screenshot der aktuellen Seite; optional full_page |
scraping_browser_get_text | Textinhalt des Seitenkörpers |
scraping_browser_get_html | HTML der aktuellen Seite |
scraping_browser_scroll | Zum Seitenende scrollen |
scraping_browser_scroll_to_ref | Ein Element in den sichtbaren Bereich scrollen |
scraping_browser_wait_for_ref | Warten, bis ein Element sichtbar wird, mit optionalem Timeout |
scraping_browser_network_requests | Netzwerkanfragen seit dem Laden der Seite: Methode, URL, Status |
Referenzen stammen aus dem neuesten Snapshot. Wenn sich die Seite nach einem Klick oder einer Navigation ändert, erstelle vor der nächsten Aktion anhand einer Referenz einen neuen Snapshot. Bei statischen Seiten ist scrape_as_markdown schneller und kostengünstiger als eine Browsersitzung.
GEO und LLM-Sichtbarkeit — 2 Tools
| Tool | Eingabe | Rückgabe |
|---|---|---|
chatgpt_ai_insights | Eingabeaufforderung | Antwort von ChatGPT als Markdown |
perplexity_ai_insights | Eingabeaufforderung | Antwort von Perplexity als Markdown |
Verwende diese Tools für Generative Engine Optimization (Nachverfolgung, wie LLMs deine Marke beschreiben) und LLM-as-a-Judge-Workflows.
Dataset-Suche — 2 Tools
Filterbasierte Suche in gespeicherten LinkedIn-Datasets; liefert passende Datensätze direkt, ohne Scraper-Ausführung.
| Tool | Beschreibung | Gruppe |
|---|---|---|
list_dataset_fields | Filterbare Felder eines Datasets (Name, Typ, Beschreibung). Vor search_dataset aufrufen | Standard / social, business |
search_dataset | Datensätze, die einem Filter entsprechen, bis zu 10 pro Aufruf, mit einem Cursor für weitere Ergebnisse | Standard / social, business |
Bright Data Assistant — 1 Tool
| Tool | Beschreibung | Gruppe |
|---|---|---|
ask_brightdata_assistant | Frage Sophie, die Support-Assistentin von Bright Data, zu Produkten, APIs, Zonen, Fehlern oder zur Kontoeinrichtung. Übergib das zurückgegebene dialog_id, um im selben Thread eine Folgefrage zu stellen | Standard / jede Gruppe |
Vollständige Tool-Referenz in der Dokumentation →
Agent-Skills
Sofort einsatzbereite Skills, die deinem Agenten die korrekte Verwendung dieses MCP-Servers vermitteln. Die vollständige Sammlung befindet sich unter github.com/brightdata/skills — 21 Skills zu MCP-Orchestrierung, Wettbewerbsanalyse, Preisvergleichen, Markenbeobachtung, SEO-Audits, Scraper-Erstellung, RAG-Pipelines und mehr.
Drei besonders wirkungsvolle Skills:
| Skill | Funktion |
|---|---|
| bright-data-mcp | Legt Bright Data MCP als Standard für alle Webdatenoperationen fest und ersetzt WebFetch, WebSearch und andere integrierte Web-Tools, die bei der Bot-Erkennung versagen |
| competitive-intel | Wettbewerber-Snapshots, Preisvergleiche, Auswertung von Rezensionen, Einstellungssignale, Content-/SEO-Analysen und Marktübersichtskarten auf Basis aktueller Webdaten |
| price-comparison | Findet ein Produkt auf Amazon, Walmart, eBay, Best Buy und Google Shopping und nennt die günstigste verfügbare Option |
Konfiguration
Grundeinrichtung (lokal)
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "your-token-here"
}
}
}
}
Erweiterte Konfiguration
{
"mcpServers": {
"Bright Data": {
"command": "npx",
"args": ["@brightdata/mcp"],
"env": {
"API_TOKEN": "your-token-here",
"RATE_LIMIT": "100/1h",
"SERP_ZONE": "custom_serp",
"BROWSER_ZONE": "custom_browser"
}
}
}
}
Umgebungsvariablen
| Variable | Beschreibung | Standardwert | Beispiel |
|---|---|---|---|
API_TOKEN | Dein Bright Data API-Token (erforderlich) | - | your-token-here |
RATE_LIMIT | Benutzerdefinierte Ratenbegrenzung | unbegrenzt | 100/1h, 50/30m |
SERP_ZONE | Benutzerdefinierter SERP API-Zonenname, der von den Such-Tools verwendet wird | mcp_serp | my_serp_zone |
BROWSER_ZONE | Benutzerdefinierter Browser-Zonenname | mcp_browser | my_browser_zone |
CONTENT_GATE | Wenn von einem Datentool zurückgegebener Seiteninhalt wie eine Anweisung zur Änderung der MCP-Konfiguration aussieht, fragt der Server den Benutzer (über MCP-Elicitation), bevor er ihn zurückgibt. Auf off setzen, um dies zu deaktivieren | on | off |
CONTENT_GATE_TIMEOUT | Sekunden, die auf die Antwort des Benutzers gewartet wird, bevor der Inhalt zurückgehalten wird | 120 | 60, 300 |
BROWSER_FILTERED_SNAPSHOT | scraping_browser_snapshot listet immer nur Schaltflächen, Links und Felder auf. Spart Tokens und verhindert, dass Seitentext als anklickbares Element ausgegeben wird (bei sensiblen Aufgaben). Bei Bedarf kann der Seitentext anschließend mit scraping_browser_get_text gelesen werden | off | on |
BASE_TIMEOUT | Timeout für Anfragen der Basis-Tools in Sekunden (Suche und Scraping) | Kein Limit | 60, 120 |
BASE_MAX_RETRIES | Maximale Anzahl von Wiederholungsversuchen der Basis-Tools bei vorübergehenden Fehlern (0–3) | 0 | 1, 3 |
GROUPS | Durch Kommas getrennte Tool-Gruppen-IDs. Beschränkt den Server auf diese Gruppen | Alle Tools | scrapers,browser |
TOOLS | Durch Kommas getrennte einzelne Tool-Namen. Beschränkt den Server auf diese Tools | Alle Tools | scrape_batch,session_stats |
Inhaltsprüfung
scrape_as_markdown, search_engine und ihre Batch-Varianten geben zurück, was auch immer auf einer Webseite steht. Wenn der Inhalt Text enthält, der wie eine Anweisung zur Änderung deiner MCP-Konfiguration aussieht — einen Server registrieren, ein npx -y-Paket ausführen oder die MCP-Konfigurationsdatei bearbeiten — hält der Server an und fragt dich über deinen MCP-Client, bevor er den Inhalt zurückgibt. Stimme zu, wird der Inhalt unverändert zurückgegeben; lehnst du ab, wird er zurückgehalten und dem Assistenten eine kurze Erklärung angezeigt. Seiten ohne solchen Text werden wie bisher ohne Rückfrage zurückgegeben. Bei einem Batch-Aufruf werden nur die passenden Elemente zurückgehalten.
Seiten, die von der MCP-Konfiguration handeln (Dokumentation, READMEs), lösen naturgemäß eine Rückfrage aus. Bei Clients, die MCP-Elicitation nicht unterstützen, wird der passende Inhalt zurückgehalten; setze CONTENT_GATE=off, wenn du das Risiko akzeptierst. Während der Server auf deine Antwort wartet, meldet er den Fortschritt; Clients, die ihr Tool-Timeout bei Fortschrittsmeldungen nicht verlängern, begrenzen die Wartezeit auf ihr eigenes Limit — CONTENT_GATE_TIMEOUT ist der entsprechende Regler auf Serverseite. Browser-Tools sind davon nicht betroffen.
Dokumentation
| Ressource | Link |
|---|---|
| API-Dokumentation | docs.brightdata.com/ai/mcp-server/overview |
| Vollständige Tool-Referenz | docs.brightdata.com/ai/mcp-server/tools |
| Agent-Skills | github.com/brightdata/skills |
| Anwendungsbeispiele | examples |
| Änderungsprotokoll | CHANGELOG.md |
Fehlerbehebung
Häufige Probleme und Lösungen
Fehler „spawn npx ENOENT“
Installieren Sie Node.js oder verwenden Sie den vollständigen Pfad zu node:
"command": "/usr/local/bin/node" // macOS/Linux
"command": "C:\\Program Files\\nodejs\\node.exe" // Windows
Zeitüberschreitungen auf komplexen Websites
Erhöhen Sie das Timeout in Ihren Client-Einstellungen auf 180s.
Authentifizierungsprobleme
Überprüfen Sie, ob Ihr API-Token gültig ist und über die erforderlichen Berechtigungen verfügt. Tokens werden in den Kontoeinstellungen verwaltet.
run_scraper gibt Fehler oder keine Daten zurück
Datensätze mit einem Feld error erläutern Eingaben, die fehlgeschlagen sind. Vergleichen Sie Ihre Eingabe mit sample_input aus get_scraper_details (z. B. enthalten Amazon-Produkt-URLs /dp/, Walmart-URLs hingegen /ip/) und prüfen Sie, ob die Seite öffentlich zugänglich ist. scrape_as_markdown funktioniert als Fallback mit derselben URL.
Verbindung zum Remote-Server schlägt fehl
Überprüfen Sie Ihre Internetverbindung und Firewall-Einstellungen.
Mitwirken
Bitte halten Sie sich an die Codierungsstandards von Bright Data.
Support
| Kanal | Link |
|---|---|
| GitHub-Issues | github.com/brightdata-com/brightdata-mcp/issues |
| Dokumentation | docs.brightdata.com/ai/mcp-server/overview |
| support@brightdata.com |
Lizenz
MIT © Bright Data Ltd.