Decodo

offiziell

Einfacher 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

Install MCP Server

Decodo: one-click web access for your AI agents

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

  1. Erstellen Sie ein kostenloses Konto unter dashboard.decodo.com – bis zu 10.000 kostenlose Anfragen, keine Kreditkarte erforderlich.
  2. 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).
  3. Laden Sie Node.js 18+ herunter von https://nodejs.org.
  4. Besorgen Sie sich einen MCP-Client, zum Beispiel Claude Desktop, Cursor, Windsurf oder andere MCP-kompatible Tools.
  5. 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

ZugangsdatenWo Sie sie erhaltenHeader für gehosteten ServerUmgebungsvariable für lokalen Server
API-Schlüssel (empfohlen)Web Data API-Abonnement im DashboardAuthorization: Bearer <api_key>SCRAPER_API_TOKEN=<api_key>
Basic-Authentifizierungstoken (ältere Tarife)Seite der Web Scraping API im DashboardAuthorization: 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

  1. Öffnen Sie Claude Desktop → Settings → Developer → Edit Config.
  2. 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"
      }
    }
  }
}
  1. Speichern Sie die Datei und starten Sie Claude Desktop neu.

Cursor

  1. Öffnen Sie Settings → MCP.
  2. Klicken Sie auf Add a new global MCP server (öffnet mcp.json).
  3. Fügen Sie dieselbe Konfiguration wie oben hinzu.
  4. Speichern Sie die Datei – neben Decodo sollte eine grüne Statusanzeige erscheinen.

Windsurf

  1. Öffnen Sie Settings → Windsurf Settings.
  2. Scrollen Sie zu Cascade → Add custom server + (öffnet mcp_config.json).
  3. Fügen Sie dieselbe Konfiguration wie oben hinzu.
  4. 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

Schritt-für-Schritt-Anleitung

  1. Klonen Sie dieses Repository:
git clone https://github.com/Decodo/mcp-server
  1. Führen Sie die folgenden Befehle im Terminal aus:
cd mcp-server
npm install
npm run build
  1. 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
  1. 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:

ToolsetTools
webscrape_as_markdown, screenshot, map, crawl_start, crawl_status, crawl_results, crawl_cancel
searchsearch

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.

ToolsetTools
webscrape_as_markdown, screenshot, map, crawl_start, crawl_status, crawl_results, crawl_cancel
searchsearch, google_search, google_ads, google_lens, google_travel_hotels, bing_search
ecommerceamazon_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_mediatiktok_post, youtube_metadata, youtube_channel, youtube_subtitles, youtube_search
aichatgpt, perplexity, google_ai_mode

Tools

Der Server stellt die folgenden Tools bereit:

ToolBeschreibungBeispiel-Prompt
scrape_as_markdownRuft 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.
screenshotErstellt einen Screenshot einer beliebigen Webseite und gibt ihn als PNG-Bild zurück.Erstelle einen Screenshot von github.com von einer US-IP-Adresse.
mapListet 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_startStartet 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_statusMeldet den Fortschritt eines Crawls: entdeckte, abgeschlossene und fehlgeschlagene Seiten. Nur mit API-Schlüssel.Ist mein Crawl schon abgeschlossen?
crawl_resultsGibt 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_cancelStoppt einen laufenden Crawl; die bis dahin gecrawlten Seiten bleiben lesbar. Nur mit API-Schlüssel.Brich meinen Crawl ab.
searchDurchsucht 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_searchRuft 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_adsRuft Google-Ads-Suchergebnisse ab.Rufe Google Ads für Laptops ab und zeige mir die Top-Anzeigen.
google_lensRuft die Bildsuchergebnisse von Google Lens ab.Suche mit Google Lens nach diesem Bild: https://example.com/image.jpg
google_ai_modeRuft die Ergebnisse von Google AI Mode (Suche mit KI) ab.Frage Google AI Mode: Was sind die drei beliebtesten Hunderassen?
google_travel_hotelsRuft die Suchergebnisse von Google Travel Hotels ab.Suche in Google Travel Hotels nach Hotels in Paris.
amazon_searchRuft 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_productRuft eine Amazon-Produktseite ab.Rufe das Amazon-Produkt B09H74FXNW ab und zeige mir die Details.
amazon_pricingRuft Preisinformationen zu Amazon-Produkten ab.Ermittle den Preis für das Amazon-Produkt B09H74FXNW.
amazon_sellersRuft Informationen zu Amazon-Verkäufern ab.Ermittle Informationen zum Amazon-Verkäufer A1R0Z7FJGTKESH.
amazon_bestsellersRuft die Amazon-Bestsellerliste ab.Zeige mir die Amazon-Bestseller im Bereich Elektronik.
walmart_searchRuft die Walmart-Suchergebnisse für eine bestimmte Suchanfrage ab und gibt die geparsten Ergebnisse zurück.Rufe die Walmart-Suche nach Campingzelten ab.
walmart_productRuft eine Walmart-Produktseite ab.Rufe das Walmart-Produkt 15296401808 ab.
target_searchRuft 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_productRuft eine Target-Produktseite ab.Rufe das Target-Produkt 92186007 ab.
tiktok_postRuft 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_searchRuft 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_productRuft eine TikTok-Shop-Produktseite ab.Rufe das TikTok-Shop-Produkt 1731541214379741272 ab.
tiktok_shop_urlRuft eine TikTok-Shop-Seite anhand ihrer URL ab.Rufe diese TikTok-Shop-URL ab: https://www.tiktok.com/shop/s?q=HEADPHONES
youtube_metadataRuft Metadaten zu YouTube-Videos ab.Ermittle die Metadaten zum YouTube-Video dFu9aKJoqGg.
youtube_channelRuft Videos eines YouTube-Kanals ab.Rufe den YouTube-Kanal @decodo_official ab.
youtube_subtitlesRuft Untertitel von YouTube-Videos ab.Ermittle die Untertitel zum YouTube-Video L8zSWbQN-v8.
youtube_searchDurchsucht YouTube-Videos.Suche auf YouTube nach "How to care for chinchillas".
bing_searchRuft Bing-Suchergebnisse ab.Suche auf Bing nach Laptop-Tests.
chatgptSendet einen einzelnen Prompt an ChatGPT und gibt die Antwort zurück (ohne Gesprächsverlauf).Bitte ChatGPT, Quantencomputing einfach zu erklären.
perplexitySendet 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:

ParameterBeschreibung
jsRenderRendert die Ziel-URL in einem Headless-Browser.
geoLegt das Land fest, aus dem die Anfrage gesendet wird.
localeLegt die Spracheinstellung der Anfrage fest.
tokenLimitMaximale Anzahl der zurückzugebenden Zeichen (Standardwert: 45000). Nützlich bei kleinem Kontextfenster.
promptAn KI-Tools zu sendender Prompt (chatgpt, perplexity).
searchAktiviert die Websuche von ChatGPT (nur chatgpt).
xhrWenn aktiviert, werden, sofern unterstützt, XHR- oder Fetch-Antworten in das Scraping-Ergebnis aufgenommen (z. B. tiktok_post).
deviceTypeZu 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.
domainFür die Anfrage zu verwendende Domain (z. B. amazon.com, amazon.co.uk, bing.com).
pageFromStartseitennummer für die Paginierung.
deliveryZipPostleitzahl des Lieferorts (Target, Walmart).
storeIdFilial-ID für den lokalen Lagerbestand (Walmart).
countryLand für TikTok-Shop-Anfragen.
limitMaximale Anzahl der zurückzugebenden Ergebnisse (z. B. Videos eines YouTube-Kanals).
language_codeSprachcode 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.