Oxylabs MCP Server
Official
📖 Übersicht
Der Oxylabs-MCP-Server stellt eine Brücke zwischen KI-Modellen und dem Web dar. Er ermöglicht es ihnen, beliebige URLs zu scrapen, JavaScript-lastige Seiten zu rendern, Inhalte für die KI-Nutzung zu extrahieren und zu formatieren, CAPTCHAs zu verwalten und auf geobeschränkte Webdaten aus über 195 Ländern zuzugreifen.
Er basiert auf dem Model Context Protocol (MCP), dem offenen Standard für die Verbindung von KI-Assistenten mit externen Tools und Daten.
Related MCP server: Decodo MCP Server
🛠️ MCP-Tools
Oxylabs MCP stellt zwei Toolsets bereit, die zusammen oder unabhängig voneinander verwendet werden können:
Oxylabs-Web-Scraper-API-Tools
universal_scraper: scrapet beliebige URLs, mit optionalem JavaScript-Rendering, Geo-Targeting und Markdown/HTML/Links-Ausgabe;
google_search_scraper: extrahiert Ergebnisse aus der Google-Suche, mit optionalem Parsing in strukturiertes JSON;
amazon_search_scraper: scrapet Amazon-Suchergebnisseiten, mit optionalem Parsing in strukturiertes JSON;
amazon_product_scraper: extrahiert Daten aus einzelnen Amazon-Produktseiten.
Oxylabs-AI-Studio-Tools
ai_scraper: scrapet Inhalte von beliebigen URLs mit KI-gestützter Extraktion, im JSON-, CSV-, Markdown- oder TOON-Format;
ai_crawler: durchsucht eine Website ausgehend von einer Start-URL basierend auf einem Prompt und sammelt Daten über mehrere Seiten;
ai_browser_agent: steuert einen echten Browser basierend auf einem Prompt – navigiert, klickt, füllt Formulare aus – und gibt das Ergebnis zurück;
ai_search: durchsucht das Web und gibt optional den Markdown-Inhalt jedes Ergebnisses zurück;
ai_map: kartiert die URLs einer Website, gefiltert nach Schlüsselwörtern oder einem Prompt;
generate_schema: generiert ein JSON-Schema im OpenAPI-Format für die strukturierte Extraktion mit den oben genannten KI-Tools.
✅ Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie mindestens eines der Folgenden besitzen:
Oxylabs-Web-Scraper-API-Konto: Erhalten Sie Ihren Benutzernamen und Ihr Passwort von Oxylabs (kostenlose 1-Wochen-Testversion verfügbar);
Oxylabs-AI-Studio-API-Schlüssel: Erhalten Sie Ihren API-Schlüssel von Oxylabs AI Studio (1000 Credits kostenlos).
Um den Server lokal auszuführen (Option 2 unten), benötigen Sie außerdem den Paketmanager uv:
# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"📦 Konfiguration
Es gibt zwei Möglichkeiten, den Server zu nutzen: Verbinden Sie sich mit der gehosteten Instanz (keine Installation) oder führen Sie ihn lokal mit Anmeldedaten in Umgebungsvariablen aus.
Option 1: Gehosteter Server (keine Installation)
Oxylabs betreibt einen gehosteten MCP-Server unter:
https://mcp.oxylabs.io/mcpAnmeldedaten werden über Request-Header übergeben:
Anmeldedaten | Header |
Web Scraper API |
|
Web Scraper API (alternativ) |
|
AI Studio |
|
Einrichtung mit Claude Code:
claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp \
--header "Authorization: Basic $(echo -n 'YOUR_USERNAME:YOUR_PASSWORD' | base64)" \
--header "X-Oxylabs-AI-Studio-Api-Key: YOUR_API_KEY"Einrichtung mit Cursor oder einem beliebigen Client, der Remote-MCP-Server mit benutzerdefinierten Headern unterstützt:
{
"mcpServers": {
"oxylabs": {
"url": "https://mcp.oxylabs.io/mcp",
"headers": {
"Authorization": "Basic <base64 of username:password>",
"X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
}
}
}
}Der Server ist auch auf Smithery gelistet.
Hinweis: Clients, die für Remote-Server nur OAuth unterstützen (z. B. das Hinzufügen eines benutzerdefinierten Connectors in der claude.ai-Weboberfläche), können noch keine Header übergeben – die OAuth-Anmeldung steht auf unserer Roadmap. Verwenden Sie in der Zwischenzeit die lokale Einrichtung unten mit diesen Clients.
Option 2: Lokal ausführen
Umgebungsvariablen
Der Oxylabs-MCP-Server unterstützt die folgenden Umgebungsvariablen:
Name | Beschreibung | Standard |
| Ihr Oxylabs-Web-Scraper-API-Benutzername | |
| Ihr Oxylabs-Web-Scraper-API-Passwort | |
| Ihr Oxylabs-AI-Studio-API-Schlüssel | |
| Protokollierungsgrad für die an den Client zurückgegebenen Protokolle |
|
Basierend auf den bereitgestellten Anmeldedaten stellt der Server automatisch die entsprechenden Tools bereit:
Wenn nur
OXYLABS_USERNAMEundOXYLABS_PASSWORDangegeben werden, stellt der Server die Web-Scraper-API-Tools bereit;Wenn nur
OXYLABS_AI_STUDIO_API_KEYangegeben wird, stellt der Server die AI-Studio-Tools bereit;Wenn alle drei angegeben werden, stellt der Server alle Tools bereit.
❗ Wichtig: Setzen Sie nur die Umgebungsvariablen, für die Sie echte Anmeldedaten besitzen. Platzhalterwerte führen dazu, dass Tools bereitgestellt werden, die nicht funktionieren.
Mit uvx konfigurieren
Installiert das Paket von PyPI und führt es automatisch aus:
{
"mcpServers": {
"oxylabs": {
"command": "uvx",
"args": ["oxylabs-mcp"],
"env": {
"OXYLABS_USERNAME": "YOUR_USERNAME",
"OXYLABS_PASSWORD": "YOUR_PASSWORD",
"OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
}
}
}
}Mit einem lokalen Checkout konfigurieren
Nützlich für die Entwicklung – führt den Server aus einem lokalen Klon dieses Repositorys aus:
{
"mcpServers": {
"oxylabs": {
"command": "uv",
"args": [
"--directory",
"/<absolute-path-to-folder>/oxylabs-mcp",
"run",
"oxylabs-mcp"
],
"env": {
"OXYLABS_USERNAME": "YOUR_USERNAME",
"OXYLABS_PASSWORD": "YOUR_PASSWORD",
"OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
}
}
}
}Als Remote-HTTP-Server ausführen (Self-Hosting)
Der Server unterstützt auch den MCP-Streamable-HTTP-Transport. Starten Sie ihn mit:
MCP_TRANSPORT=streamable-http MCP_HOST=0.0.0.0 MCP_PORT=8000 uvx oxylabs-mcpBeim HTTP-Transport werden Anmeldedaten pro Request übergeben, statt über Umgebungsvariablen:
Anmeldedaten | So übergeben Sie sie |
Web Scraper API |
|
Web Scraper API (alternativ) |
|
AI Studio |
|
Beispiel-Client-Konfiguration:
{
"mcpServers": {
"oxylabs": {
"url": "https://your-host:8000/mcp",
"headers": {
"Authorization": "Basic <base64 of username:password>",
"X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
}
}
}
}Alle Tools werden unabhängig von den bereitgestellten Anmeldedaten immer aufgelistet; der Aufruf eines Tools ohne die benötigten Anmeldedaten gibt eine Fehlermeldung zurück, die genau erklärt, was zu konfigurieren ist.
Einrichtung mit Claude Desktop
Navigieren Sie zu Claude → Einstellungen → Entwickler → Konfiguration bearbeiten und fügen Sie eine der obigen Konfigurationen zur Datei claude_desktop_config.json hinzu.
Einrichtung mit Cursor AI
Navigieren Sie zu Cursor → Einstellungen → Cursor-Einstellungen → MCP. Klicken Sie auf Neuen globalen MCP-Server hinzufügen und fügen Sie eine der obigen Konfigurationen hinzu.
📝 Protokollierung
Der Server stellt zusätzliche Informationen über die Tool-Aufrufe in notification/message-Ereignissen bereit:
{
"method": "notifications/message",
"params": {
"level": "info",
"data": "Create job with params: {\"url\": \"https://ip.oxylabs.io\"}"
}
}{
"method": "notifications/message",
"params": {
"level": "info",
"data": "Job info: job_id=7333113830223918081 job_status=done"
}
}{
"method": "notifications/message",
"params": {
"level": "error",
"data": "Error: request to Oxylabs API failed"
}
}✨ Wichtige Funktionen
Daten aus beliebigen URLs extrahieren, einschließlich komplexer Single-Page-Anwendungen
Dynamische Websites mit Headless-Browser-Unterstützung vollständig rendern
Zwischen vollständigem JavaScript-Rendering, nur HTML oder keiner Rendering-Option wählen
Mobile- und Desktop-Viewports für realistisches Rendering emulieren
HTML automatisch bereinigen und für bessere Lesbarkeit in Markdown konvertieren
Automatisierte Parser für beliebte Ziele wie Google, Amazon und mehr verwenden
Anspruchsvolle automatisierte Request-Management-Systeme mit hoher Erfolgsquote umgehen
Auch die komplexesten Websites zuverlässig scrapen
Automatisch rotierende IPs aus einem Proxy-Pool mit Abdeckung von über 195 Ländern erhalten
Bei Bedarf Rendering- und Parsing-Optionen festlegen
Daten direkt in KI-Modelle oder Analysetools einspeisen
Funktioniert unter macOS, Windows und Linux
Umfassende Fehlerbehandlung und -meldung
Intelligentes Rate Limiting und Request-Verwaltung
Warum Oxylabs MCP? 🕸️ ➜ 📦 ➜ 🤖
Stellen Sie sich vor, Sie sagen Ihrem LLM „Fasse die neueste Hacker-News-Diskussion über GPT‑5 zusammen" – und es antwortet einfach. Der Oxylabs-MCP-Server macht das möglich, indem er die langweiligen Teile für Sie erledigt:
Was Oxylabs MCP tut | Warum es für Sie wichtig ist |
Verwaltet automatisierte Request-Wände mit dem globalen Oxylabs-Proxy-Netzwerk | Ermöglicht Website-Zugriff und Anonymität |
Rendert JavaScript in Headless-Chrome | Single-Page-Apps, erledigt |
Bereinigt HTML → Markdown | Direkt in Vektor-Datenbanken oder Prompts einfügen |
Optionale strukturierte Parser (Google, Amazon usw.) | Zugriff auf beliebte Ziele mit einer Zeile |
🛡️ Lizenz
Verteilt unter der MIT-Lizenz – siehe LICENSE für Details.
Über Oxylabs
Oxylabs wurde 2015 gegründet und ist eine marktführende Plattform für die Erfassung von Web-Intelligence, die von den höchsten Geschäfts-, Ethik- und Compliance-Standards angetrieben wird und Unternehmen weltweit datengetriebene Erkenntnisse ermöglicht.

mcp-name: io.oxylabs/oxylabs-mcp
Available Tools
10 toolsai_browser_agentCRead-onlyInspect
Run the browser agent and return the data in the specified format.
This tool is useful if you need navigate around the website and do some actions. It allows navigating to any url, clicking on links, filling forms, scrolling, etc. Finally it returns the data in the specified format. Schema is required only if output_format is json, csv or toon. 'task_prompt' describes what browser agent should achieve
Inputs: url (required), task_prompt (required), schema, geo_location, +1 more. Returns: result
ai_crawlerCRead-onlyInspect
Tool useful for crawling a website from starting url and returning data in a specified format.
Schema is required only if output_format is json, csv or toon. 'render_javascript' is used to render javascript heavy websites. 'return_sources_limit' is used to limit the number of sources to return, for example if you expect results from single source, you can set it to 1.
Inputs: url (required), user_prompt (required), schema, geo_location, +3 more. Returns: result
ai_mapDRead-onlyInspect
Tool useful for mapping website's URLs.
Inputs: url (required), limit, user_prompt, geo_location, +5 more. Returns: result
ai_scraperARead-onlyInspect
Scrape the contents of the web page and return the data in the specified format.
Schema is required only if output_format is json or csv. 'render_javascript' is used to render javascript heavy websites.
Inputs: url (required), schema, geo_location, output_format, +1 more. Returns: result
ai_searchARead-onlyInspect
Search the web based on a provided query.
'return_content' is used to return markdown content for each search result. If 'return_content' is set to True, you don't need to use ai_scraper to get the content of the search results urls, because it is already included in the search results. if 'return_content' is set to True, prefer lower 'limit' to reduce payload size.
Inputs: query (required), limit, geo_location, return_content, +1 more. Returns: result
amazon_product_scraperARead-onlyInspect
Scrape Amazon products.
Supports content parsing, different user agent types, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as currency and getting more accurate pricing data with auto select variant.
Inputs: query (required), parse, domain, locale, +6 more. Returns: result
amazon_search_scraperBRead-onlyInspect
Scrape Amazon search results.
Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as category id, merchant id, currency.
Inputs: query (required), pages, parse, domain, +9 more. Returns: result
generate_schemaCRead-onlyInspect
Generate a json schema in openapi format.
Inputs: app_name (required), user_prompt (required). Returns: result
google_search_scraperARead-onlyInspect
Scrape Google Search results.
Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats.
Inputs: query (required), limit, pages, parse, +8 more. Returns: result
universal_scraperBRead-onlyInspect
Get a content of any webpage.
Supports browser rendering, parsing of certain webpages and different output formats.
Inputs: url (required), render, geo_location, output_format, +1 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Several tools have heavily overlapping purposes: ai_scraper and universal_scraper both claim to scrape any webpage content, while ai_crawler and ai_browser_agent both navigate websites and extract data. ai_search and google_search_scraper also cover similar territory, making selection ambiguous without very careful reading.
Names are descriptive and readable, but they follow two different conventions: an ai_ prefix group (ai_crawler, ai_scraper, ai_search, ai_map, ai_browser_agent) and a target_suffix group (google_search_scraper, amazon_search_scraper, amazon_product_scraper, universal_scraper). Only generate_schema stands apart with a clear verb_noun pattern.
Ten tools is well-scoped for a web scraping and search server covering generic scraping, search, browser automation, URL mapping, schema generation, and Amazon-specific extraction. Each tool represents a distinct product capability, even if some overlap exists.
The tool surface covers the core needs of the domain: general search, Google-specific search, generic page scraping, crawling, browser-driven interaction, site mapping, and Amazon search/product scraping. There are no obvious dead ends for common web data acquisition workflows.
Maintenance
Related MCP Connectors
Fetch and extract data from any public web page, even JS-rendered or anti-bot protected
Scraping API for Google Search, Maps, Flights, Jobs, YouTube, LinkedIn, Trustpilot and more.
Oxylabs MCP — Oxylabs Web Scraper API (oxylabs.io)
Scrape any website, extract structured data, and collect web content at scale with AI agents
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables web scraping and document processing with JavaScript execution, anti-detection measures, batch processing, and structured data extraction. Supports multiple formats including markdown, HTML, screenshots, and handles PDFs with OCR capabilities.44 PyPI4MIT
- AlicenseAqualityBmaintenanceEnables web scraping and data extraction from websites with geographic flexibility, privacy features, and anti-detection capabilities. Supports scraping general websites, Google Search, Amazon Search, and Reddit with customizable parameters for rendering, geolocation, and locale.33859 npm41ISC
- AlicenseAqualityDmaintenanceEnables AI agents to scrape any website by providing tools for JavaScript rendering, antibot bypass, and automatic captcha solving. It supports synchronous, asynchronous, and batch scraping operations with built-in proxy rotation.535 PyPIMIT
- AlicenseAqualityAmaintenanceEnables web scraping, structured data extraction, and screenshot capture with automatic anti-bot bypass, supporting JavaScript rendering, proxy rotation, and tiered pricing.262,618 npm2MIT