ScrapingBee MCP-Server: Seiten, Suche und Screenshots

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

ScrapingBee

Web Scraping mit ScrapingBee aus deiner KI: jede Seite als gerendertes HTML, Markdown oder Text über rotierende, Premium- oder Stealth-Proxys abrufen, strukturierte Daten mit CSS-, XPath- oder KI-Regeln extrahieren, Screenshots erstellen, geparste Google- und Amazon-Ergebnisse holen und das Restguthaben des Tarifs prüfen. Alle Tools außer der Verbrauchsabfrage verbrauchen ScrapingBee-Credits.

Einrichtung

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein ScrapingBee-Konto; die kostenlose Testphase enthält 1.000 Credits.

1. Melde dich unter https://dashboard.scrapingbee.com an.
2. Kopiere den API key aus dem Dashboard (https://dashboard.scrapingbee.com/account/manage/api_key).
3. Füge ihn in SCRAPINGBEE_API_KEY ein. Er wird als Bearer-Token gesendet, nur an app.scrapingbee.com.
4. Installiere den Connector und führe scrapingbee_get_usage aus: Es zeigt verbrauchte und enthaltene Credits und bestätigt den Schlüssel.

Was Credits kostet: Alle Tools außer scrapingbee_get_usage verbrauchen API-Credits deines Tarifs, und zwar nur bei erfolgreichen Aufrufen (auch Antworten mit 404 und 410 zählen). Seitenabrufe mit scrapingbee_scrape_page und scrapingbee_extract_data kosten 1 Credit ohne JavaScript, 5 mit JavaScript (Standard), 10 oder 25 mit premium_proxy (ohne oder mit JavaScript) und 75 mit stealth_proxy; KI-Extraktion kostet 5 zusätzlich. scrapingbee_take_screenshot rendert immer JavaScript und kostet daher 5 Credits, 25 mit Premium-Proxy und 75 mit Stealth-Proxy. scrapingbee_google_search kostet 10 Credits (15 mit light_request: false), scrapingbee_fast_search 10. scrapingbee_amazon_search und scrapingbee_amazon_product kosten 5 pro einfacher und 15 pro gerenderter Seite, und pages vervielfacht die Kosten. Die KI fragt dich vor einer Reihe kostenpflichtiger Aufrufe.

Seiten lesen: scrapingbee_scrape_page liefert HTML oder den Hauptinhalt als Markdown (return_page_markdown) oder reinen Text (return_page_text). Bei statischen Seiten setzt die KI render_js: false (1 Credit statt 5). Bei einer blockierten Seite nutzt sie mode: auto, das zuerst die günstigste Konfiguration versucht und nur die erfolgreiche abrechnet (max_cost deckelt das, etwa 25, damit nie der Stealth-Proxy greift), oder versucht es erneut mit premium_proxy, dann stealth_proxy. Weitere Optionen: country_code für das Proxy-Land, wait (bis 35.000 ms), wait_for auf einen CSS-Selektor, wait_browser, block_ads, block_resources (standardmäßig an), device, cookies, session_id (dieselbe IP für 5 Minuten), timeout und js_scenario, das vor der Erfassung klickt, scrollt und Formulare ausfüllt. json_response verpackt die Antwort mit Headern, Cookies, Kosten und der aufgelösten URL.

Daten extrahieren: scrapingbee_extract_data liefert JSON statt der Seite. Bei bekannter Struktur schreibt die KI extract_rules (CSS- oder XPath-Selektoren als JSON-Text, mit Ausgaben wie text, html, @href, table_json oder table_array). Ist die Struktur unbekannt, nutzt sie ai_query (eine Frage zur Seite) oder ai_extract_rules (die Felder in Alltagssprache beschrieben), auf Wunsch mit ai_selector auf einen Teil der Seite beschränkt.

Screenshots: scrapingbee_take_screenshot liefert ein PNG des sichtbaren Bereichs (standardmäßig 1920 x 1080), der ganzen Seite (screenshot_full_page) oder eines Elements (screenshot_selector), auf Desktop oder Mobilgerät.

Suche: scrapingbee_fast_search liefert schnell eine Liste organischer Google-Treffer (Rang, Titel, Link, Beschreibung) und Top-Meldungen. scrapingbee_google_search gibt die geparste Ergebnisseite mit organischen Treffern, Anzeigen, Knowledge Graph, lokalen und Kartenergebnissen, Top-Meldungen und verwandten Fragen zurück; search_type wählt news, maps, images, shopping, lens, ai_mode oder ads. KI-Übersichten brauchen light_request: false. Filter: country_code, language, device, date_range und beim Shopping sort_by, min_price und max_price.

Amazon: scrapingbee_amazon_search liefert Produkte zu einer Suche (ASIN, Titel, Preis, Währung, Bewertung, Sponsored-Kennzeichen, Position) auf einem gewählten Marktplatz (domain, etwa com, de oder co.uk), mit Sortierung sowie Kategorie- und Händlerfilter. scrapingbee_amazon_product liest ein Produkt per ASIN: Preis, Buy Box, Bewertung und Anzahl der Rezensionen, Marke, Stichpunkte, Bilder, Varianten, Details, Lieferung, Bestand und Verkaufsrang. zip_code liefert lokale Preise und Lieferzeiten; currency legt die Anzeigewährung fest.

Was er ändert: nichts in deinem ScrapingBee-Konto; alle Tools lesen nur. Kein Tool ist bei der Installation deaktiviert, aber jeder Aufruf außer der Verbrauchsabfrage kostet Credits.

Datenformate: Die JSON-Optionen extract_rules, ai_extract_rules und js_scenario werden als JSON-Text übergeben. country_code ist ein ISO-3166-1-Code in Kleinbuchstaben; ohne Premium- oder Stealth-Proxy fällt ein nicht unterstütztes Land ohne Hinweis auf us zurück. Bei Amazon sendest du nicht das Land des Marktplatzes als country, sondern nutzt zip_code. Preise stehen in der Währung des Marktplatzes, außer currency ist gesetzt.

Blättern und Grenzen: scrapingbee_google_search nimmt page und pages (1 bis 10 zusammengefasste Ergebnisseiten, 3 oder weniger empfohlen), scrapingbee_amazon_search nimmt start_page und pages, jede Seite wird berechnet, und scrapingbee_fast_search nimmt page. Antworten sind auf etwa 100 KB begrenzt, daher nutzt die KI bei langen Seiten Markdown, Text oder Extraktionsregeln. scrapingbee_get_usage erlaubt 6 Aufrufe pro Minute, und parallele Anfragen sind durch die Concurrency des Tarifs begrenzt.

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

Häufige Fehler: 401 Invalid api key oder kein Guthaben mehr: Kopiere den Schlüssel erneut oder prüf den Tarif im Dashboard. 400 bedeutet eine ungültige Parameterkombination, etwa mode: auto zusammen mit render_js, premium_proxy oder stealth_proxy, oder ein country, das dem Land der Amazon-Domain entspricht; wird nicht berechnet. 429 heißt, dass das Concurrency-Limit des Tarifs erreicht ist; warte und versuch es einmal erneut, wird nicht berechnet. 500 bedeutet, dass die Seite nicht geladen werden konnte (Fehler beim Ziel, Sperre oder Timeout); wird nicht berechnet, und ein neuer Versuch mit premium_proxy oder stealth_proxy hilft oft.

Der Connector nutzt keinen Proxy-Modus, leitet keine POST- oder PUT-Anfragen an das Ziel weiter, lädt keine Dateien über 2 MB herunter und deckt weder die Endpunkte für Walmart, YouTube, ChatGPT und Gemini noch die CLI ab.

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

Verfügbare Tools

Beispiel-Prompts

• „Wie viele ScrapingBee-Credits haben wir in diesem Zeitraum noch, und wann verlängert sich der Tarif?“
• „Scrape https://example.com/blog/launch ohne JavaScript als Markdown und fass den Artikel zusammen.“
• „Extrahier Produktname, Preis und Lagerstatus von dieser Shopseite mit KI-Extraktionsregeln.“
• „Mach einen ganzseitigen mobilen Screenshot von https://example.com und sag mir, was ohne Scrollen sichtbar ist.“
• „Such auf Amazon.de nach einem USB-C-Ladegerät mit 65 W, sortiert nach Bewertung, und liste die ersten 10 mit ASIN und Preis auf.“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden