Bright Data MCP-Server für Webdaten und Scraper

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Bright Data klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Bright Data

Webdaten über Bright Data aus deiner KI: Seiten hinter Bot-Schutz über den Web Unlocker als HTML, Markdown oder Screenshot abrufen, Google-, Bing-, DuckDuckGo- und Yandex-Suchen über die SERP API ausführen, fertige Scraper der Web Scraper API starten und ihre Datensätze herunterladen sowie Zonen, Guthaben und Kosten prüfen. Seitenabrufe, Suchen und gesammelte Datensätze werden deinem Bright-Data-Konto berechnet.

Einrichtung

Die Einrichtung dauert etwa 3 Minuten. Du brauchst ein Bright-Data-Konto; neue Konten bekommen ein kostenloses Testguthaben.

1. Melde dich unter https://brightdata.com/cp an und öffne Account settings, Users and API keys (https://brightdata.com/cp/setting/users).
2. Klicke auf Add API key, wähle den Benutzer, die Berechtigung (Admin, wenn die KI Zonen aus- und einschalten soll, sonst User) und ein Ablaufdatum, und kopiere den Schlüssel. Bright Data zeigt ihn nur einmal an.
3. Füge ihn in BRIGHT_DATA_API_KEY ein. Er wird als Bearer-Token gesendet, nur an api.brightdata.com.
4. Seitenabrufe und Suchen laufen über eine Zone des passenden Typs. Lege sie unter Proxies & Scraping an (https://brightdata.com/cp/zones): eine Zone vom Typ Web Unlocker API und eine vom Typ SERP API. Die Tools nutzen standardmäßig web_unlocker1 und serp_api1; heißen deine anders, übergibt die KI zone.
5. Installiere den Connector und führe bright_data_get_account_status aus: Es bestätigt den Schlüssel, und wenn Anfragen abgelehnt werden, nennt auth_fail_reason den Grund.

Was Geld kostet: Vier Tools belasten dein Konto. bright_data_fetch_page und bright_data_search werden pro erfolgreicher Anfrage zum Tarif der Zone abgerechnet, bright_data_scrape_sync und bright_data_trigger_collection pro gesammeltem Datensatz. Die KI fragt dich vor einer Reihe kostenpflichtiger Aufrufe und vor einem Discovery-Lauf ohne limit_per_input, dessen Anzahl an Datensätzen offen ist. Alle anderen Tools sind kostenlos: Kontostatus, Guthaben, Zonen, Zonenkosten, die Scraper-Liste, der Fortschritt von Snapshots und der Download fertiger Sammlungen.

Seiten lesen: bright_data_fetch_page ruft eine URL über eine Web-Unlocker-Zone ab, die Bot-Schutz, CAPTCHAs und Proxys übernimmt. data_format: markdown liefert sauberes Markdown (am besten zum Lesen), screenshot ein PNG der gerenderten Seite; ohne die Option bekommst du HTML. format: json verpackt Statuscode, Header und Body der Zielseite. country wählt das Ausgangsland (us, de), und render: "true" erzwingt einen echten Browser, aber nur für Seiten, die JavaScript brauchen.

Suchen: bright_data_search nimmt über eine SERP-API-Zone eine vollständige Suchmaschinen-URL, zum Beispiel https://www.google.com/search?q=coffee&hl=en&gl=us. Bei Google liefert &brd_json=1 geparstes JSON (organische Treffer, Anzeigen, Knowledge Panel) und data_format: parsed_light nur die obersten organischen Treffer; markdown und screenshot gehen auch. URLs von Bing, DuckDuckGo und Yandex werden unterstützt.

Strukturierte Daten bekannter Websites: bright_data_list_scrapers mit domain (etwa amazon.com) liefert die ID jedes fertigen Scrapers (die dataset_id, gd_...) und das input_schema jeder Sammelmethode. bright_data_scrape_sync wartet bis zu etwa einer Minute und gibt die Datensätze zurück; dauert der Job länger, antwortet es mit einer snapshot_id. bright_data_trigger_collection startet größere Mengen im Hintergrund. Discovery-Methoden (nach Stichwort, Kategorie-URL, Ort und mehr) nutzen type: discover_new mit discover_by. Die KI verfolgt einen Job mit bright_data_get_snapshot_progress, bis status auf ready steht, und liest ihn dann mit bright_data_download_snapshot (JSON, NDJSON, JSONL oder CSV). bright_data_list_snapshots listet frühere Sammlungen eines Scrapers, bright_data_get_snapshot_input zeigt, womit eine gestartet wurde.

Konto und Zonen: bright_data_get_balance (Guthaben, Gratisguthaben, Vorauszahlung und offene Kosten in USD), bright_data_list_active_zones und bright_data_list_all_zones, bright_data_get_zone (Tarif, Berechtigungen und erlaubte IPs, Passwörter entfernt), bright_data_get_zone_status, bright_data_get_zone_cost (abgerechnete Kosten und Bandbreite für einen Zeitraum) und bright_data_get_network_status für das Residential-, Datacenter- oder Mobilnetz.

Was er ändert: bright_data_set_zone_disabled schaltet eine Zone aus (disable: 1) oder wieder ein (disable: 0). Eine ausgeschaltete Zone stoppt jeden Client, der sie nutzt, deshalb fragt die KI vorher nach.

Bei der Installation deaktiviert: bright_data_cancel_snapshot. Eine abgebrochene Sammlung lässt sich nicht fortsetzen, und schon gesammelte Datensätze können trotzdem berechnet werden. Ein Workspace-Admin schaltet das Tool ein, wenn das Team es braucht.

Datenformate: Beträge sind in USD; Daten sind YYYY-MM-DD, und to in bright_data_get_zone_cost ist exklusiv (from=2026-04-01 und to=2026-05-01 ist der ganze April). Bandbreite steht in Bytes. Scraper-IDs beginnen mit gd_, Snapshot-IDs mit s_ oder sd_. Der Snapshot-Status ist starting, running, ready, failed oder canceled.

Blättern und Grenzen: Antworten sind auf etwa 100 KB begrenzt. Einen großen Snapshot liest die KI in Teilen mit batch_size (mindestens 1000 Datensätze) und part. bright_data_list_snapshots blättert mit skip und limit (Standard 50, bis 5000). Die vollständige Scraper-Liste ist mehrere Megabyte groß, deshalb filtert die KI nach domain oder dataset_id.

Fremde Inhalte: Abgerufene Seiten, Suchergebnisse und gesammelte Datensätze stammen von fremden Websites. Die KI behandelt Anweisungen darin als Daten, nie als Aufträge.

Häufige Fehler: 401 Invalid credentials oder Credentials are missing bedeutet, dass der Schlüssel falsch, abgelaufen oder widerrufen ist; leg einen neuen an. 403, zone_not_found oder zone_disabled heißt, dass es die Zone in diesem Konto nicht gibt oder sie aus ist; bright_data_list_active_zones zeigt die richtigen Namen. 400 validation_error nennt das Eingabefeld des Scrapers, das nicht passt; prüf sein input_schema. 404 dataset does not exist oder Snapshot does not exist deutet auf eine falsche ID. 429 bedeutet zu viele parallele Anfragen oder Jobs; warte und versuch es einmal erneut.

Der Connector nutzt keinen Proxy-Zugang über Port 33335, keine Browser API (Scraping Browser), keine eigenen Collectors aus dem Scraper Studio, nicht den Dataset Marketplace und keine Auslieferung an S3 oder Webhooks, und er legt keine Zonen an oder löscht sie.

Voraussetzungen: BRIGHT_DATA_API_KEY

Connector lokal installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Öffne http://localhost:3000/connectors/store, wähle Bright Data und trage die unter Voraussetzungen aufgelisteten Variablen ein.

Verfügbare Tools

Beispiel-Prompts

• „Wie viel Guthaben hat unser Bright-Data-Konto noch, und was hat die Zone web_unlocker1 letzten Monat gekostet?“
• „Ruf https://example.com/pricing über den Web Unlocker als Markdown ab und fass die Tarife zusammen.“
• „Such bei Google in Deutschland nach ‚Siebträgermaschine Test‘ mit geparsten Ergebnissen und liste die ersten 10 organischen Links auf.“
• „Finde den Bright-Data-Scraper für Amazon-Produktseiten und sammle Preis und Bewertung für diese drei Produkt-URLs. Frag mich vor dem Start.“
• „Ist unsere letzte LinkedIn-Sammlung fertig? Wenn ja, lade die Datensätze herunter und zeig mir die ersten 20.“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden