Decodo
offiziellEinfacher Zugriff auf Webdaten. Vereinfachter Abruf von Informationen aus Websites und Online-Quellen.
Was kann man mit Decodo MCP machen?
- Seiten als Markdown scrapen — Bitte deinen Assistenten, eine beliebige URL zu scrapen, auch JavaScript-lastige Seiten, und Markdown zurückzugeben, das für LLMs geeignet ist.
- Screenshots erstellen — Fordere einen PNG-Screenshot einer beliebigen Webseite an, optional über eine IP-Adresse aus einem bestimmten Land.
- Websites crawlen — Starte einen Crawl, prüfe seinen Fortschritt, rufe die gecrawlten Seiten nach und nach ab oder brich ihn ab.
- Suchmaschinen — Führe Web-, Google-, Bing-, Google Ads-, Google Lens- oder Google Travel Hotels-Suchen durch und erhalte geparste Ergebnisse.
- eCommerce-Daten — Rufe Produkt-, Preis-, Verkäufer- und Bestsellerdaten von Amazon, Walmart, Target und TikTok Shop ab.
- Soziale Medien und KI-Antworten — Erfasse TikTok-Beiträge und YouTube-Metadaten, Untertitel, Kanäle oder Suchergebnisse oder stelle Anfragen an ChatGPT und Perplexity.
Dokumentation
Decodo MCP Server
Verbinden Sie LLMs und KI-Agenten über MCP (Model Context Protocol) mit Live-Webdaten. Mit dem Decodo MCP Server können Sie Websites, Suchmaschinen, eCommerce-Plattformen und soziale Medien direkt über KI-Tools wie Claude, Cursor und Windsurf scrapen – ganz ohne eigene Scraping-Infrastruktur aufbauen zu müssen.
- Strukturierte Ausgaben in JSON, Markdown und Screenshots
- Serverseitiges JavaScript-Rendering und Anti-Bot-Verarbeitung
- Über 125 Mio. IPs an mehr als 195 Standorten
Was ist der Decodo MCP Server?
Der Decodo MCP Server ist eine Web-Scraping-Schicht für KI-Agenten. Er verbindet MCP-kompatible Clients mit der Web Scraping API von Decodo und ermöglicht:
- Web-Scraping für LLMs
- Datenabruf in Echtzeit für RAG
- Browsing und Recherche durch KI-Agenten
- Extraktion strukturierter Daten aus dynamischen Websites
Anstatt Proxys, Parser und Wiederholungslogik zu verwalten, erhalten Sie einen einzigen Integrationspunkt für zuverlässigen Zugriff auf Webdaten.
Warum MCP für Web-Scraping verwenden?
Das Model Context Protocol (MCP) ist der aufkommende Standard für die Verbindung von KI-Agenten mit externen Tools und Datenquellen. Mit MCP:
- Können Agenten Tools dynamisch aufrufen
- Bleiben Integrationen standardisiert
- Lassen sich Workflows über verschiedene Umgebungen hinweg skalieren
Der Decodo MCP Server bietet Ihren Agenten über diesen Standard zuverlässigen Webzugriff für den produktiven Einsatz.
Hauptfunktionen
Web-Scraping für KI-Agenten – ohne Infrastrukturaufwand. Scrapen Sie beliebige Websites, einschließlich JavaScript-lastiger Seiten, ohne sich um Proxy-Rotation, CAPTCHA-Lösung oder Anti-Bot-Systeme kümmern zu müssen.
Strukturierte Ausgaben für LLM-Workflows. Markdown (für LLMs optimiert), JSON (für strukturierte Pipelines) und Screenshots (für visuellen Kontext) – entwickelt für RAG-Pipelines, KI-Rechercheagenten und Automatisierungsabläufe.
Integrierte Unterstützung für beliebte Ziele. Sofort einsatzbereite Tools für Google und Bing (SERPs), Amazon, Walmart und Target (eCommerce), TikTok und YouTube (soziale Medien) sowie ChatGPT und Perplexity (KI-Suche).
Globale Proxy-Infrastruktur. Über 115 Mio. Residential-IPs, mehr als 195 Geostandorte und eine Erfolgsrate von 99,99 % selbst bei den am stärksten geschützten Zielen.
Modulare MCP-Toolsets. Aktivieren Sie nur, was Sie benötigen: web, search, ecommerce, social_media,
ai für eine übersichtlichere Toolauswahl und bessere Agentenleistung.
Schneller Mehrwert. Vom API-Schlüssel bis zum ersten Scrape in wenigen Minuten – ohne Einrichtungsaufwand.
Anwendungsfälle
Verwenden Sie den Decodo MCP Server, wenn Sie Web-Scraping für KI-Agenten, die Extraktion strukturierter Daten in großem Umfang, zuverlässigen Zugriff auf dynamische Websites, Echtzeitdaten für RAG oder eine Alternative zum Aufbau eigener Scraping-Infrastruktur benötigen. Häufige Szenarien:
- KI-gestütztes Web-Scraping – ermöglichen Sie LLMs, aktuelle Daten zu sammeln, statt sich auf statische Trainingsdaten zu verlassen.
- RAG mit Live-Daten – integrieren Sie aktuelle Google-, Bing- und KI-Suchergebnisse in Retrieval- Pipelines.
- eCommerce-Informationen – verfolgen Sie Produktpreise, Angebote und Verkäufer auf verschiedenen Marktplätzen, ohne blockiert zu werden.
- Datenerfassung aus sozialen Medien – sammeln Sie Beiträge, Kanäle und Interaktionsdaten von TikTok und YouTube.
- Reise- und Preisaggregation – erstellen Sie Tools, die aktuelle Preise und Verfügbarkeiten auf verschiedenen Websites erfassen.
Schnellstart
- Erstellen Sie ein kostenloses Konto unter dashboard.decodo.com – bis zu 10.000 kostenlose Anfragen, keine Kreditkarte erforderlich.
- Rufen Sie Ihren API-Schlüssel ab. Kopieren Sie Ihren Web Data API-Schlüssel aus Ihrem Web Data API-Abonnement im Dashboard. Ältere Tarife verfügen über ein Basic-Authentifizierungstoken, das ebenfalls funktioniert (siehe Authentifizierung).
- Laden Sie Node.js 18+ herunter von https://nodejs.org.
- Besorgen Sie sich einen MCP-Client, zum Beispiel Claude Desktop, Cursor, Windsurf oder andere MCP-kompatible Tools.
- Konfigurieren Sie den MCP-Server in Ihrem KI-Client (siehe Konfigurationsbeispiele unten).
Verbindung zum Decodo MCP Server
Öffnen Sie Ihren bevorzugten MCP-Client und fügen Sie die folgende Konfiguration hinzu (Beispiele für Claude Code, Cursor und Windsurf finden Sie unten):
{
"mcpServers": {
"Decodo": {
"url": "https://mcp.decodo.com/mcp",
"headers": {
"Authorization": "Bearer <api_key>"
}
}
}
}
Authentifizierung
| Zugangsdaten | Wo Sie sie erhalten | Header für gehosteten Server | Umgebungsvariable für lokalen Server |
|---|---|---|---|
| API-Schlüssel (empfohlen) | Web Data API-Abonnement im Dashboard | Authorization: Bearer <api_key> | SCRAPER_API_TOKEN=<api_key> |
| Basic-Authentifizierungstoken (ältere Tarife) | Seite der Web Scraping API im Dashboard | Authorization: Basic <basic_auth_token> | SCRAPER_API_TOKEN=<basic_auth_token> |
Der lokale Server liest beide Zugangsdaten aus SCRAPER_API_TOKEN und erkennt automatisch, welche davon angegeben wurde.
Claude Desktop
- Öffnen Sie Claude Desktop → Settings → Developer → Edit Config.
- Fügen Sie Folgendes zu claude_desktop_config.json hinzu:
{
"mcpServers": {
"Decodo": {
"command": "npx",
"args": ["-y", "@decodo/mcp-server"],
"env": {
"SCRAPER_API_TOKEN": "<api_key>",
"TOOLSETS": "web,ai"
}
}
}
}
- Speichern Sie die Datei und starten Sie Claude Desktop neu.
Cursor
- Öffnen Sie Settings → MCP.
- Klicken Sie auf Add a new global MCP server (öffnet mcp.json).
- Fügen Sie dieselbe Konfiguration wie oben hinzu.
- Speichern Sie die Datei – neben Decodo sollte eine grüne Statusanzeige erscheinen.
Windsurf
- Öffnen Sie Settings → Windsurf Settings.
- Scrollen Sie zu Cascade → Add custom server + (öffnet mcp_config.json).
- Fügen Sie dieselbe Konfiguration wie oben hinzu.
- Speichern Sie die Datei und starten Sie Windsurf neu.
Einrichtung testen
Sobald die Verbindung hergestellt ist, probieren Sie diesen Prompt in Ihrem Client aus:
▎ „Scrape die Titel der 5 wichtigsten Artikel von Hacker News“
Sie sollten innerhalb weniger Sekunden eine strukturierte Liste erhalten. Wenn ein Authentifizierungsfehler auftritt, überprüfen Sie Ihren API-Schlüssel im Dashboard.
Lokale Entwicklung
Nur erforderlich, wenn Sie den Servercode ändern möchten.
Server aus diesem Repository erstellen und ausführen
Voraussetzungen
- Node.js 18.0+
- Ein MCP-Client – beliebte Optionen sind Claude Desktop und Cursor
Schritt-für-Schritt-Anleitung
- Klonen Sie dieses Repository:
git clone https://github.com/Decodo/mcp-server
- Führen Sie die folgenden Befehle im Terminal aus:
cd mcp-server
npm install
npm run build
- Notieren Sie sich den Speicherort des Builds:
cd build/
pwd
Wenn Sie index.js an das Ende dieses Verzeichnisses anhängen, sollte der Speicherort Ihrer Build-Datei etwa so aussehen:
/Users/your.user/projects/mcp-server/build/index.js
- Aktualisieren Sie Ihren MCP-Client mit den Serverinformationen:
{
"mcpServers": {
"decodo-mcp": {
"command": "node",
"args": ["/Users/your.user/projects/mcp-server/build/index.js"],
"env": {
"SCRAPER_API_TOKEN": "<api_key>"
}
}
}
}
Toolsets
Tools sind in Toolsets organisiert. Welche Sie erhalten, hängt davon ab, wie Sie die Verbindung herstellen.
Claude (offizieller Connector)
Der Decodo-Connector im Connector-Verzeichnis von Claude enthält ausschließlich die Web Data API-Tools:
| Toolset | Tools |
|---|---|
web | scrape_as_markdown, screenshot, map, crawl_start, crawl_status, crawl_results, crawl_cancel |
search | search |
Beliebiger MCP-Client
Sie können bestimmte Toolsets gezielt aktivieren, indem Sie eine durch Kommas getrennte Liste über den Abfrageparameter toolsets
übergeben:
"Decodo MCP Server": {
"url": "https://mcp.decodo.com/mcp?toolsets=web,ai",
"headers": {
"Authorization": "Bearer <api_key>"
}
}
Wenn keine Toolsets angegeben sind, werden alle Tools registriert.
| Toolset | Tools |
|---|---|
web | scrape_as_markdown, screenshot, map, crawl_start, crawl_status, crawl_results, crawl_cancel |
search | search, google_search, google_ads, google_lens, google_travel_hotels, bing_search |
ecommerce | amazon_search, amazon_product, amazon_pricing, amazon_sellers, amazon_bestsellers, walmart_search, walmart_product, target_search, target_product, tiktok_shop_search, tiktok_shop_product, tiktok_shop_url |
social_media | tiktok_post, youtube_metadata, youtube_channel, youtube_subtitles, youtube_search |
ai | chatgpt, perplexity, google_ai_mode |
Tools
Der Server stellt die folgenden Tools bereit:
| Tool | Beschreibung | Beispiel-Prompt |
|---|---|---|
scrape_as_markdown | Ruft eine beliebige Ziel-URL ab. Die URL muss im Prompt angegeben werden. Gibt die Ergebnisse als Markdown zurück. | Rufe peacock.com von einer US-IP-Adresse ab und nenne mir die Preise. |
screenshot | Erstellt einen Screenshot einer beliebigen Webseite und gibt ihn als PNG-Bild zurück. | Erstelle einen Screenshot von github.com von einer US-IP-Adresse. |
map | Listet die URLs einer Website auf, ohne deren Inhalte abzurufen. Nur mit API-Schlüssel. | Ermittle die Seitenstruktur von docs.decodo.com und liste die Seiten unter /scraping-api auf. |
crawl_start | Startet das Crawling einer Website und gibt die Crawl-ID zurück, ohne auf den Abschluss zu warten. Nur mit API-Schlüssel. | Crawle die ersten 10 Seiten von decodo.com/blog. |
crawl_status | Meldet den Fortschritt eines Crawls: entdeckte, abgeschlossene und fehlgeschlagene Seiten. Nur mit API-Schlüssel. | Ist mein Crawl schon abgeschlossen? |
crawl_results | Gibt gecrawlte Seiten nach und nach als Markdown zurück, jeweils einige Seiten mit einem Cursor. Nur mit API-Schlüssel. | Zeige mir die Seiten, die mein Crawl gefunden hat. |
crawl_cancel | Stoppt einen laufenden Crawl; die bis dahin gecrawlten Seiten bleiben lesbar. Nur mit API-Schlüssel. | Brich meinen Crawl ab. |
search | Durchsucht das Web und gibt nach Relevanz sortierte Ergebnisse zurück. Nur mit API-Schlüssel. | Suche im Web nach Hosting-Optionen für MCP-Server. |
google_search | Ruft die Google-Suchergebnisse für eine bestimmte Suchanfrage ab und gibt die geparsten Ergebnisse zurück. | Rufe die Google-Suche nach Schuhen ab und nenne mir die höchste Position. |
google_ads | Ruft Google-Ads-Suchergebnisse ab. | Rufe Google Ads für Laptops ab und zeige mir die Top-Anzeigen. |
google_lens | Ruft die Bildsuchergebnisse von Google Lens ab. | Suche mit Google Lens nach diesem Bild: https://example.com/image.jpg |
google_ai_mode | Ruft die Ergebnisse von Google AI Mode (Suche mit KI) ab. | Frage Google AI Mode: Was sind die drei beliebtesten Hunderassen? |
google_travel_hotels | Ruft die Suchergebnisse von Google Travel Hotels ab. | Suche in Google Travel Hotels nach Hotels in Paris. |
amazon_search | Ruft die Amazon-Suchergebnisse für eine bestimmte Suchanfrage ab und gibt die geparsten Ergebnisse zurück. | Rufe die Amazon-Suche nach kabellosen Tastaturen ab. |
amazon_product | Ruft eine Amazon-Produktseite ab. | Rufe das Amazon-Produkt B09H74FXNW ab und zeige mir die Details. |
amazon_pricing | Ruft Preisinformationen zu Amazon-Produkten ab. | Ermittle den Preis für das Amazon-Produkt B09H74FXNW. |
amazon_sellers | Ruft Informationen zu Amazon-Verkäufern ab. | Ermittle Informationen zum Amazon-Verkäufer A1R0Z7FJGTKESH. |
amazon_bestsellers | Ruft die Amazon-Bestsellerliste ab. | Zeige mir die Amazon-Bestseller im Bereich Elektronik. |
walmart_search | Ruft die Walmart-Suchergebnisse für eine bestimmte Suchanfrage ab und gibt die geparsten Ergebnisse zurück. | Rufe die Walmart-Suche nach Campingzelten ab. |
walmart_product | Ruft eine Walmart-Produktseite ab. | Rufe das Walmart-Produkt 15296401808 ab. |
target_search | Ruft die Target-Suchergebnisse für eine bestimmte Suchanfrage ab und gibt die geparsten Ergebnisse zurück. | Rufe die Target-Suche nach Küchengeräten ab. |
target_product | Ruft eine Target-Produktseite ab. | Rufe das Target-Produkt 92186007 ab. |
tiktok_post | Ruft eine TikTok-Post-URL ab und liefert strukturierte Daten (z. B. Interaktionen, Bildunterschrift, Hashtags). | Rufe diesen TikTok-Post ab: https://www.tiktok.com/@nba/video/7393013274725403950 |
tiktok_shop_search | Ruft die TikTok-Shop-Suchergebnisse für eine bestimmte Suchanfrage ab und gibt die geparsten Ergebnisse zurück. | Rufe die TikTok-Shop-Suche nach Handyhüllen ab. |
tiktok_shop_product | Ruft eine TikTok-Shop-Produktseite ab. | Rufe das TikTok-Shop-Produkt 1731541214379741272 ab. |
tiktok_shop_url | Ruft eine TikTok-Shop-Seite anhand ihrer URL ab. | Rufe diese TikTok-Shop-URL ab: https://www.tiktok.com/shop/s?q=HEADPHONES |
youtube_metadata | Ruft Metadaten zu YouTube-Videos ab. | Ermittle die Metadaten zum YouTube-Video dFu9aKJoqGg. |
youtube_channel | Ruft Videos eines YouTube-Kanals ab. | Rufe den YouTube-Kanal @decodo_official ab. |
youtube_subtitles | Ruft Untertitel von YouTube-Videos ab. | Ermittle die Untertitel zum YouTube-Video L8zSWbQN-v8. |
youtube_search | Durchsucht YouTube-Videos. | Suche auf YouTube nach "How to care for chinchillas". |
bing_search | Ruft Bing-Suchergebnisse ab. | Suche auf Bing nach Laptop-Tests. |
chatgpt | Sendet einen einzelnen Prompt an ChatGPT und gibt die Antwort zurück (ohne Gesprächsverlauf). | Bitte ChatGPT, Quantencomputing einfach zu erklären. |
perplexity | Sendet einen einzelnen Prompt an Perplexity und gibt die Antwort zurück (ohne Gesprächsverlauf). | Frage Perplexity nach den neuesten Trends in der Webentwicklung. |
Parameter
Die folgenden Parameter werden aus den Prompts der Nutzer abgeleitet:
| Parameter | Beschreibung |
|---|---|
jsRender | Rendert die Ziel-URL in einem Headless-Browser. |
geo | Legt das Land fest, aus dem die Anfrage gesendet wird. |
locale | Legt die Spracheinstellung der Anfrage fest. |
tokenLimit | Maximale Anzahl der zurückzugebenden Zeichen (Standardwert: 45000). Nützlich bei kleinem Kontextfenster. |
prompt | An KI-Tools zu sendender Prompt (chatgpt, perplexity). |
search | Aktiviert die Websuche von ChatGPT (nur chatgpt). |
xhr | Wenn aktiviert, werden, sofern unterstützt, XHR- oder Fetch-Antworten in das Scraping-Ergebnis aufgenommen (z. B. tiktok_post). |
deviceType | Zu emulierender Gerätetyp (desktop, mobile, tablet). Für geparste Ziele gelten strengere Vorgaben: Amazon-Tools sind nur für Desktop verfügbar und lassen diesen Parameter daher weg; bing_search/google_ai_mode akzeptieren nur desktop und mobile. |
domain | Für die Anfrage zu verwendende Domain (z. B. amazon.com, amazon.co.uk, bing.com). |
pageFrom | Startseitennummer für die Paginierung. |
deliveryZip | Postleitzahl des Lieferorts (Target, Walmart). |
storeId | Filial-ID für den lokalen Lagerbestand (Walmart). |
country | Land für TikTok-Shop-Anfragen. |
limit | Maximale Anzahl der zurückzugebenden Ergebnisse (z. B. Videos eines YouTube-Kanals). |
language_code | Sprachcode für Untertitel (z. B. en, es). |
Beispiele
Zugriff auf geografisch eingeschränkte Inhalte
Stelle deinem KI-Agenten folgende Frage:
Scrape peacock.com from a German IP address and tell me the pricing.
In diesem Prompt wird angegeben, dass peacock.com geografisch eingeschränkt ist. So umgehst du die geografische Einschränkung:
Scrape peacock.com from a US IP address and tell me the pricing.
Begrenzen der Anzahl zurückgegebener Tokens
Wenn dein Agent ein kleines Kontextfenster hat, werden die beim Scraping zurückgegebenen Inhalte automatisch gekürzt, um einen Kontextüberlauf zu vermeiden. Du kannst die Anzahl der in deinem Prompt zurückgegebenen Tokens erhöhen:
Scrape hacker news, return 50k tokens.
Wenn dein Agent über ein großes Kontextfenster verfügt, weise ihn an, full content zurückzugeben:
Scrape hacker news, return full content.
Mit Decodo-Agent-Skills verwenden
Dieser Server stellt deinem Agenten die Scraping-Tools zur Verfügung.
Decodo/agent-skills bringt ihm bei, wann er darauf zurückgreifen sollte,
welche Schnittstelle er verwenden und wie er sie aufrufen soll – damit der Agent selbstständig
das richtige Tool und die passenden Parameter auswählt, statt zu raten.
Die Skills funktionieren mit der decodo-CLI, diesem gehosteten MCP-Server und der rohen HTTP-API und
greifen automatisch auf den MCP-Server zurück, wenn keine Shell verfügbar ist. Zusammen bieten sie deinem Agenten
sowohl die Ausführungsebene (dieser Server) als auch die Entscheidungsebene (die Skills) in einem einzigen Setup.
Schnellstart (Claude Code):
/plugin marketplace add Decodo/agent-skills
/plugin install decodo@decodo-skills
In der README zu den Agent-Skills findest du Informationen zur manuellen Installation und zu weiteren Agenten (Cursor, Codex, Gemini CLI, Windsurf).
Verwandte Repositories
Web Scraping API, Decodo-Agent-Skills, Decodo-OpenClaw-Skill
Ausprobieren
Integriere den Decodo MCP Server mit wenigen Klicks in deinen KI-Workflow und statte deine KI-Agenten mit Echtzeitdaten von jeder Website aus.
Kostenlos starten | Dokumentation | Discord
Lizenz
Der gesamte Code wird unter der MIT-Lizenz veröffentlicht.
