Bright Data

offiziell

Entdecken, 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 Logo

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.

npm version npm downloads License

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:

ParameterBeschreibungBeispiel
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
  1. Gehe zu: Settings → Connectors → Add custom connector
  2. Name: Bright Data
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. 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 ExtraktionBrowser-Navigation
Nutzungsbasierte Abrechnung1,50 $ / 1.000 Ergebnisse8 $ / 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.

AufgabeTools
Im Web nach aktuellen Informationen suchensearch_engine, search_engine_batch
Eine bestimmte Seite als sauberes Markdown lesenscrape_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.

AufgabeTools
Produkte, Rezensionen und Suchergebnisse von Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara und anderen Shopssearch_scrapers → get_scraper_details → run_scraper
Preisvergleich über mehrere HändlerDerselbe 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.

AufgabeTools
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 Wettbewerbernscrape_as_markdown, scrape_batch
Marktentdeckungsearch_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.

AufgabeTools
Direkter Ersatz für die integrierte Websuchesearch_engine
Direkter Ersatz für den integrierten URL-Abrufscrape_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.

AufgabeTools
npm- und PyPI-Paketversion, README und Metadatenrun_scraper mit dem npmjs- oder pypi-Scraper (mit search_scrapers finden)
Dateien aus GitHub-Repositories lesenrun_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.

AufgabeTools
ChatGPT-Antworten mit Zitaten und Empfehlungenchatgpt_ai_insights
Perplexity-Antworten mit Quellenperplexity_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.

PlattformBeispiele für Scraper
LinkedInPersonenprofile, Unternehmensprofile, Stellenanzeigen, Beiträge, Personensuche
InstagramProfile, Beiträge, Reels, Kommentare
TikTokProfile, Beiträge, Shop, Kommentare
FacebookProfile, Beiträge, Marketplace-Angebote, Unternehmensbewertungen, Veranstaltungen
YouTubeVideos, Kanäle, Kommentare
X (Twitter)Beiträge, Beiträge nach Profil
RedditBeiträ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.

AufgabeTools
Mehrere Quellen mit einem Aufruf sammelnscrape_batch (bis zu 5 URLs)
Nachrichten- und Finanzdatensearch_engine mit Nachrichtenabfragen, run_scraper mit dem Yahoo Finance-Scraper

Vergleich

FunktionBright Data MCPTypische Web-MCP-Server
Gesamtzahl der Tools302–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 ToolsSelten; meist nur generisches Scraping
Entsperrung (Umgehung der Bot-Erkennung, CAPTCHA-Lösung, Proxy-Rotation)In jede Anfrage integriertMeist nicht vorhanden; geschützte Websites blockieren den Zugriff
SuchmaschinenBing, GoogleMeist eine
Browser-Automatisierung14 Tools, Remote-Browser, keine lokale EinrichtungEingeschränkt oder nicht vorhanden
Erfassung von LLM-Antworten (ChatGPT, Perplexity)JaNicht verfügbar
Paketregisterdaten (npm, PyPI)JaNicht verfügbar
Stapelverarbeitung10 Suchanfragen oder 10 Scrapes pro AufrufMeist nur einzelne Anfragen
Geografisches TargetingJaEingeschränkt oder nicht vorhanden
Kostenloses Kontingent5.000 Anfragen/Monat, Browser-Automatisierung inklusive, keine KreditkarteUnterschiedlich; 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 GROUPS oder TOOLS sind alle 30 Tools aktiviert. Wenn du einen der beiden Parameter festlegst, ist der Server auf die angegebenen Tools beschränkt
  • GROUPS aktiviert Tool-Bundles. Durch Kommas getrennt: GROUPS="scrapers,browser" (lokal) oder &groups=scrapers,browser (gehostete URL)
  • TOOLS fü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_markdown und ask_brightdata_assistant
  • Die Gruppen-ID custom ist reserviert; verwende TOOLS fü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_markdown mit format: '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 error erläutern fehlgeschlagene Eingaben, z. B. eine URL des falschen Typs
  • Ergebnisse können umfangreich sein. Halte limit_per_input für discover_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_markdown als Fallback für dieselbe URL
Suche und Scraping — 5 Tools
ToolBeschreibungGruppe
search_engineBing (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_batchBis zu 5 Suchanfragen in einem AufrufStandard / advanced_scraping
scrape_as_markdownBeliebige URL. Liefert den Inhalt als Markdown (Standard), Text, HTML oder ld_jsonStandard / jede Gruppe
scrape_batchBis zu 5 URLs in einem Aufruf. Liefert den Inhalt als Markdown (Standard), Text, HTML oder ld_jsonStandard / advanced_scraping
session_statsAnzahl der Tool-Aufrufe in der aktuellen SitzungStandard / 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).

ToolBeschreibungGruppe
search_scrapersScraper nach Website oder Datentyp suchen (z. B. „Amazon-Bewertungen“, „linkedin.com“). Liefert Dataset-ID, Name, Domain und ErfassungsmethodenStandard / scrapers
get_scraper_detailsBeschreibung, Eingabefelder, Beispieleingabe und wichtigste Ausgabefelder für eine Scraper-MethodeStandard / scrapers
run_scraperEine 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 kannStandard / scrapers
get_scraper_progressStatus einer Ausführung: starting, running, ready, failed oder canceledStandard / scrapers
get_scraper_resultsDatensätze einer abgeschlossenen AusführungStandard / scrapers
refresh_scrapersScraper-Liste jetzt neu laden, statt auf die tägliche Aktualisierung zu wartenStandard / scrapers
Browser-Automatisierung — 14 Tools

Remote-Browsersitzung. Typischer Ablauf: navigieren → Snapshot erstellen → anhand der Referenz interagieren → Inhalte extrahieren oder Screenshot erstellen.

ToolBeschreibung
scraping_browser_navigateEine Browsersitzung öffnen oder wiederverwenden und zu einer URL navigieren
scraping_browser_go_backZurück navigieren
scraping_browser_go_forwardVorwärts navigieren
scraping_browser_snapshotARIA-Snapshot der Seite mit interaktiven Elementen und Referenzen. Vor Aktionen anhand einer Referenz erforderlich
scraping_browser_click_refEin Element anhand seiner Referenz aus dem neuesten Snapshot anklicken
scraping_browser_type_refText in ein Element anhand seiner Referenz eingeben; optional zum Absenden Enter drücken
scraping_browser_fill_formMehrere Formularfelder anhand ihrer Referenzen in einem Aufruf ausfüllen
scraping_browser_screenshotScreenshot der aktuellen Seite; optional full_page
scraping_browser_get_textTextinhalt des Seitenkörpers
scraping_browser_get_htmlHTML der aktuellen Seite
scraping_browser_scrollZum Seitenende scrollen
scraping_browser_scroll_to_refEin Element in den sichtbaren Bereich scrollen
scraping_browser_wait_for_refWarten, bis ein Element sichtbar wird, mit optionalem Timeout
scraping_browser_network_requestsNetzwerkanfragen 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
ToolEingabeRückgabe
chatgpt_ai_insightsEingabeaufforderungAntwort von ChatGPT als Markdown
perplexity_ai_insightsEingabeaufforderungAntwort 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.

ToolBeschreibungGruppe
list_dataset_fieldsFilterbare Felder eines Datasets (Name, Typ, Beschreibung). Vor search_dataset aufrufenStandard / social, business
search_datasetDatensätze, die einem Filter entsprechen, bis zu 10 pro Aufruf, mit einem Cursor für weitere ErgebnisseStandard / social, business
Bright Data Assistant — 1 Tool
ToolBeschreibungGruppe
ask_brightdata_assistantFrage 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 stellenStandard / 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:

SkillFunktion
bright-data-mcpLegt 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-intelWettbewerber-Snapshots, Preisvergleiche, Auswertung von Rezensionen, Einstellungssignale, Content-/SEO-Analysen und Marktübersichtskarten auf Basis aktueller Webdaten
price-comparisonFindet ein Produkt auf Amazon, Walmart, eBay, Best Buy und Google Shopping und nennt die günstigste verfügbare Option

Alle 21 Skills ansehen →


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

VariableBeschreibungStandardwertBeispiel
API_TOKENDein Bright Data API-Token (erforderlich)-your-token-here
RATE_LIMITBenutzerdefinierte Ratenbegrenzungunbegrenzt100/1h, 50/30m
SERP_ZONEBenutzerdefinierter SERP API-Zonenname, der von den Such-Tools verwendet wirdmcp_serpmy_serp_zone
BROWSER_ZONEBenutzerdefinierter Browser-Zonennamemcp_browsermy_browser_zone
CONTENT_GATEWenn 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 deaktivierenonoff
CONTENT_GATE_TIMEOUTSekunden, die auf die Antwort des Benutzers gewartet wird, bevor der Inhalt zurückgehalten wird12060, 300
BROWSER_FILTERED_SNAPSHOTscraping_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 werdenoffon
BASE_TIMEOUTTimeout für Anfragen der Basis-Tools in Sekunden (Suche und Scraping)Kein Limit60, 120
BASE_MAX_RETRIESMaximale Anzahl von Wiederholungsversuchen der Basis-Tools bei vorübergehenden Fehlern (0–3)01, 3
GROUPSDurch Kommas getrennte Tool-Gruppen-IDs. Beschränkt den Server auf diese GruppenAlle Toolsscrapers,browser
TOOLSDurch Kommas getrennte einzelne Tool-Namen. Beschränkt den Server auf diese ToolsAlle Toolsscrape_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

RessourceLink
API-Dokumentationdocs.brightdata.com/ai/mcp-server/overview
Vollständige Tool-Referenzdocs.brightdata.com/ai/mcp-server/tools
Agent-Skillsgithub.com/brightdata/skills
Anwendungsbeispieleexamples
ÄnderungsprotokollCHANGELOG.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

KanalLink
GitHub-Issuesgithub.com/brightdata-com/brightdata-mcp/issues
Dokumentationdocs.brightdata.com/ai/mcp-server/overview
E-Mailsupport@brightdata.com

Lizenz

MIT © Bright Data Ltd.