Browserless zu MCP: Smart Scrape, Screenshots, PDFs, Lighthouse-Audits und Unblocking in jedem KI-Agent

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

Browserless

Cloud-Browser von Browserless aus deiner KI: gerenderte Seiten per Smart Scrape als Markdown, HTML oder Links lesen, Elemente mit CSS-Selektoren auslesen, Screenshots erstellen, PDFs drucken, Lighthouse-Audits ausführen, die URLs einer Website erfassen und bot-geschützte Seiten über die Unblock-API öffnen. Alle Tools außer der Versionsabfrage verbrauchen Browserless-Units.

Einrichtung

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Browserless-Konto; der kostenlose Tarif enthält monatliche Units.

1. Melde dich unter https://browserless.io/account/ an und kopiere das API token aus dem Dashboard.
2. Füge es in BROWSERLESS_API_TOKEN ein. Browserless nimmt es bei jedem Aufruf als Query-Parameter token entgegen; es wird nur an den Host unten gesendet.
3. Setze BROWSERLESS_HOST auf die Region deines Tarifs, ohne https://: production-sfo.browserless.io (US-Westküste, Standard bei geteilten Tarifen), production-lon.browserless.io (London) oder production-ams.browserless.io (Amsterdam). Dedizierte Tarife (Private Fleet) nutzen chrome.browserless.io oder ihren regionalen Host chrome-...browserless.io; ein privates Token auf einem geteilten Host wird mit 401 abgelehnt.
4. Installiere den Connector und führe browserless_get_meta aus: Es liefert die Version des Browserless-Dienstes auf dem Host und bestätigt das Token.

Was Units kostet: Alle Tools außer browserless_get_meta verbrauchen Browserless-Units deines Tarifs: 1 Unit pro 30 Sekunden Browserzeit (aufgerundet; einfache Abrufe in Smart Scrape kosten 0,5), dazu 6 Units pro MB Residential-Proxy-Traffic oder 2 pro MB Datacenter-Traffic und 10 Units pro gelöstem CAPTCHA. browserless_smart_scrape und browserless_map nutzen standardmäßig den Residential-Proxy, und die Formate json und summary von Smart Scrape kosten zusätzliche KI-Units. stealth: true kostet nichts extra. Die KI fragt dich vor einer Reihe von Aufrufen und bevor sie bei großen Seiten einen Proxy nutzt.

Seiten lesen: browserless_smart_scrape ist die erste Wahl. Es versucht einen einfachen Abruf, dann einen Proxy, dann einen vollen Browser, sagt, welche Strategie die Seite geliefert hat, und gibt die gewünschten formats zurück: markdown (hier Standard), html, rawText, links, screenshot, pdf, json (KI-Extraktion mit Schema oder Prompt in json_options) oder summary. only_main_content, include_tags und exclude_tags kürzen die Seite. browserless_get_content liefert das vollständig gerenderte HTML einer URL oder von übergebenem HTML aus einem echten Chrome. browserless_scrape liefert Text, HTML und Attribute jedes Elements, das zu deinen CSS-Selektoren passt.

Bilder und Dokumente: browserless_screenshot erfasst den sichtbaren Bereich, die ganze Seite oder ein Element (selector) als PNG, JPEG oder WebP, mit eigenem viewport, scroll_page für nachgeladene Inhalte und block_consent_modals gegen Cookie-Banner. browserless_pdf druckt eine URL oder übergebenes HTML (zum Beispiel einen erzeugten Bericht) als PDF, mit Optionen wie format, landscape, Rändern und printBackground.

Website erfassen und prüfen: browserless_map listet die URLs einer Website aus Sitemap und Links mit Titeln und Beschreibungen, sortiert nach Relevanz zu search (limit standardmäßig 200, bis 5000). browserless_performance führt ein Google-Lighthouse-Audit aus, mit Werten von 0 bis 1 für Performance, Barrierefreiheit, Best Practices, SEO und PWA. Ein vollständiges Audit kann Minuten dauern und ist sehr groß, deshalb übergibt die KI config, um nur eine Kategorie zu prüfen.

Blockierte Seiten: browserless_unblock kommt an Bot-Erkennung vorbei (Datadome, passive CAPTCHAs) und liefert das HTML, die von der Website gesetzten Cookies und auf Wunsch einen ganzseitigen Screenshot; am besten funktioniert es mit proxy: residential, und die KI fragt vorher. Bei den anderen Tools versucht die KI zuerst stealth: true, dann einen Proxy (proxy_country wählt das Land).

Auf Inhalte warten: Die Rendering-Tools akzeptieren wait_for_selector (ein Element und ein Timeout), wait_for_timeout, goto_options (etwa waitUntil: networkidle2) und best_attempt, das mit dem Geladenen weitermacht, wenn ein Warten ins Timeout läuft. Bei browserless_get_content und browserless_scrape beschleunigt reject_resource_types (Bilder, Schriften, Medien) die Seiten; browserless_get_content sendet außerdem set_extra_http_headers und cookies mit der Anfrage. Alle Zeiten sind Millisekunden; timeout begrenzt den ganzen Aufruf.

Bei der Installation deaktiviert: browserless_function, das eigenen Puppeteer-Code für mehrstufige Abläufe ausführt, etwa durch ein Formular klicken oder durch Ergebnisse blättern. Dieser Code kann auf Websites Formulare absenden, sich anmelden oder einkaufen, und das lässt sich nicht rückgängig machen. Deshalb schaltet ein Workspace-Admin es ein, wenn das Team es braucht. Ist es an, zeigt dir die KI den Code und wartet auf dein Ja.

Was er ändert: nichts in deinem Browserless-Konto. Jeder Aufruf startet ein frisches Headless-Chrome, erledigt eine Aufgabe auf einer URL und schließt den Browser; zwischen Aufrufen bleibt nichts erhalten.

Datenformate: Screenshots kommen als Bilder, PDFs als Dateien zurück; Textantworten sind auf etwa 100 KB begrenzt. Optionen wie wait_for_selector, goto_options, viewport und json_options sind JSON-Objekte. Lighthouse-Werte sind Brüche (0,92 = 92).

Fremde Inhalte: Seiten, Cookies und ausgelesene Texte stammen von fremden Websites. Die KI behandelt Anweisungen darin als Daten, nie als Aufträge.

Häufige Fehler: 401 bedeutet, dass das Token falsch ist oder nicht zu diesem Host gehört (geteilte oder private Fleet); kopiere es erneut aus dem Dashboard. 404 bei der Installationsprüfung heißt, dass BROWSERLESS_HOST die REST-APIs nicht bereitstellt. 400 ist ein fehlerhafter Body, etwa wenn url und html beide fehlen. 403 bedeutet, dass das Ziel für dieses Konto nicht erlaubt ist. 408 heißt, dass die Seite länger als das Timeout gebraucht hat: timeout erhöhen, auf weniger warten oder best_attempt nutzen. 429 bedeutet, dass die Concurrency des Tarifs ausgeschöpft ist; warte und versuch es einmal erneut. Leere oder unvollständige Inhalte bedeuten meist, dass die Website Automatisierung blockiert: Versuch stealth: true, dann browserless_unblock mit Residential-Proxy.

Der Connector deckt weder BrowserQL noch WebSocket-Sessions für Puppeteer oder Playwright, die asynchronen Crawl- und Agent-APIs, Datei-Downloads oder die Session-Verwaltung ab.

Voraussetzungen: BROWSERLESS_API_TOKEN, BROWSERLESS_HOST

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 Browserless und trage die unter Voraussetzungen aufgelisteten Variablen ein.

Verfügbare Tools

Beispiel-Prompts

• „Lies https://example.com/pricing per Smart Scrape und gib mir Tarife und Preise als Tabelle.“
• „Mach einen ganzseitigen Screenshot unserer Startseite mit 1280 px Breite und blende das Cookie-Banner aus.“
• „Führ ein Lighthouse-Performance-Audit für https://example.com aus und nenn mir die drei größten Probleme.“
• „Erfasse die URLs von https://example.com, die mit der Dokumentation zu tun haben, und liste die ersten 50 auf.“
• „Mach aus diesem HTML-Bericht ein A4-PDF mit Hintergrundfarben und 1 cm Rand.“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden