Oxylabs MCP Server

offiziell

Websites mit der Oxylabs Web API scrapen, die dynamisches Rendering und Parsing für strukturierte Datenextraktion unterstützt.

GitHub

100

Dokumentation

Oxylabs + MCP

Oxylabs MCP Server

Das fehlende Bindeglied zwischen KI-Modellen und dem realen Web: eine API, die saubere, strukturierte Daten von jeder Website liefert.

📖 Übersicht

Der Oxylabs MCP-Server stellt eine Brücke zwischen KI-Modellen und dem Web her. Er ermöglicht ihnen, jede URL zu scrapen, JavaScript-lastige Seiten zu rendern, Inhalte für die KI-Nutzung zu extrahieren und zu formatieren, CAPTCHA zu verwalten und auf geografisch eingeschränkte Webdaten aus über 195 Ländern zuzugreifen.

🛠️ MCP-Tools

Oxylabs MCP bietet zwei Tool-Sets, die zusammen oder unabhängig voneinander verwendet werden können:

Oxylabs Web Scraper API Tools

universal_scraper: Verwendet die Oxylabs Web Scraper API für allgemeines Website-Scraping;
google_search_scraper: Verwendet die Oxylabs Web Scraper API, um Ergebnisse aus der Google-Suche zu extrahieren;
amazon_search_scraper: Verwendet die Oxylabs Web Scraper API, um Amazon-Suchergebnisseiten zu scrapen;
amazon_product_scraper: Verwendet die Oxylabs Web Scraper API, um Daten von einzelnen Amazon-Produktseiten zu extrahieren.

Oxylabs AI Studio Tools

ai_scraper: Inhalte von einer beliebigen URL im JSON- oder Markdown-Format mit KI-gestützter Datenextraktion scrapen;
ai_crawler: Basierend auf einem Prompt eine Website crawlen und Daten im Markdown- oder JSON-Format über mehrere Seiten sammeln;
ai_browser_agent: Basierend auf einem Prompt einen Browser steuern und Daten in den Formaten Markdown, JSON, HTML oder Screenshot zurückgeben;
ai_search: Das Web nach URLs und deren Inhalten mit KI-gestützter Inhaltsextraktion durchsuchen.

✅ Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie mindestens eines der folgenden Dinge haben:

Oxylabs Web Scraper API-Konto: Beziehen Sie Ihren Benutzernamen und Ihr Passwort von Oxylabs (1-wöchige kostenlose Testversion verfügbar);
Oxylabs AI Studio API-Schlüssel: Beziehen Sie Ihren API-Schlüssel vom Oxylabs AI Studio. (1000 Credits kostenlos).

📦 Konfiguration

Umgebungsvariablen

Der Oxylabs MCP-Server unterstützt die folgenden Umgebungsvariablen:

Name	Beschreibung	Standard
`OXYLABS_USERNAME`	Ihr Oxylabs Web Scraper API-Benutzername
`OXYLABS_PASSWORD`	Ihr Oxylabs Web Scraper API-Passwort
`OXYLABS_AI_STUDIO_API_KEY`	Ihr Oxylabs AI Studio API-Schlüssel
`LOG_LEVEL`	Log-Level für die an den Client zurückgegebenen Logs	`INFO`

Basierend auf den bereitgestellten Anmeldeinformationen stellt der Server automatisch die entsprechenden Tools bereit:

Wenn nur OXYLABS_USERNAME und OXYLABS_PASSWORD angegeben werden, stellt der Server die Web Scraper API-Tools bereit;
Wenn nur OXYLABS_AI_STUDIO_API_KEY angegeben wird, stellt der Server die AI Studio-Tools bereit;
Wenn sowohl OXYLABS_USERNAME und OXYLABS_PASSWORD als auch OXYLABS_AI_STUDIO_API_KEY angegeben werden, stellt der Server alle Tools bereit.

❗❗❗ Wichtiger Hinweis: Wenn Sie keine Anmeldeinformationen für die Web Scraper API oder das Oxylabs AI Studio haben, löschen Sie die entsprechenden Platzhalter für Umgebungsvariablen. Das Belassen von Platzhalterwerten führt dazu, dass Tools bereitgestellt werden, die nicht funktionieren.

Konfiguration mit uvx

Installieren Sie den uvx-Paketmanager:

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

ODER:

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Verwenden Sie die folgende Konfiguration:

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "OXYLABS_USERNAME",
        "OXYLABS_PASSWORD": "OXYLABS_PASSWORD",
        "OXYLABS_AI_STUDIO_API_KEY": "OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }
}

Konfiguration mit uv

Installieren Sie den uv-Paketmanager:

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

ODER:

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Verwenden Sie die folgende Konfiguration:

{
  "mcpServers": {
    "oxylabs": {
      "command": "uv",
      "args": [
        "--directory",
        "/<Absolute-path-to-folder>/oxylabs-mcp",
        "run",
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_USERNAME": "OXYLABS_USERNAME",
        "OXYLABS_PASSWORD": "OXYLABS_PASSWORD",
        "OXYLABS_AI_STUDIO_API_KEY": "OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }
}

Konfiguration mit Smithery Oauth2

Gehen Sie zu https://smithery.ai/server/@oxylabs/oxylabs-mcp;
Klicken Sie auf Auto, um die Oxylabs MCP-Konfiguration für den jeweiligen Client zu installieren;
ODER verwenden Sie die folgende Konfiguration:

  {
    "mcpServers": {
      "oxylabs": {
        "url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp"
      }
    }
  }

Befolgen Sie die Anweisungen, um Oxylabs MCP mit dem Oauth2-Flow zu authentifizieren

Konfiguration mit Smithery-Abfrageparametern

Falls Ihr Client die Oauth2-Authentifizierung nicht unterstützt, können Sie die Oxylabs-Authentifizierungsparameter direkt in der URL übergeben

  {
    "mcpServers": {
      "oxylabs": {
        "url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp?oxylabsUsername=OXYLABS_USERNAME&oxylabsPassword=OXYLABS_PASSWORD&oxylabsAiStudioApiKey=OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }

Manuelle Einrichtung mit Claude Desktop

Navigieren Sie zu Claude → Einstellungen → Entwickler → Konfiguration bearbeiten und fügen Sie eine der oben genannten Konfigurationen zur Datei claude_desktop_config.json hinzu.

Manuelle 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 oben genannten 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"
  }
}

🛡️ Lizenz

Vertrieben unter der MIT-Lizenz – siehe LICENSE für Details.

Über Oxylabs

Oxylabs wurde 2015 gegründet und ist eine marktführende Plattform zur Sammlung von Web-Intelligence, die von höchsten Geschäfts-, Ethik- und Compliance-Standards angetrieben wird und Unternehmen weltweit ermöglicht, datengestützte Erkenntnisse zu gewinnen.

_{Gemacht mit ☕ von Oxylabs. Geben Sie uns gerne einen ⭐, wenn MCP Ihnen ein Wochenende erspart hat.}

✨ Hauptfunktionen

Inhalte von jeder Website scrapen

Daten von jeder URL extrahieren, einschließlich komplexer Single-Page-Anwendungen
Dynamische Websites mit Headless-Browser-Unterstützung vollständig rendern
Vollständiges JavaScript-Rendering, nur HTML oder keines wählen
Mobile- und Desktop-Viewports für realistisches Rendering emulieren

Automatisch KI-fähige Daten erhalten

HTML automatisch bereinigen und in Markdown für verbesserte Lesbarkeit konvertieren
Automatisierte Parser für beliebte Ziele wie Google, Amazon und mehr verwenden

CAPTCHA & Geo-Beschränkungen verwalten

Ausgeklügelte automatisierte Anfrageverwaltungssysteme mit hoher Erfolgsquote navigieren
Selbst die komplexesten Websites zuverlässig scrapen
Automatisch rotierende IPs aus einem Proxy-Pool mit über 195 Ländern erhalten

Flexible Einrichtung & plattformübergreifende Unterstützung

Rendering- und Parsing-Optionen bei Bedarf festlegen
Daten direkt in KI-Modelle oder Analysetools einspeisen
Funktioniert unter macOS, Windows und Linux

Integrierte Fehlerbehandlung und Anfrageverwaltung

Umfassende Fehlerbehandlung und Berichterstattung
Intelligente Ratenbegrenzung und Anfrageverwaltung

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. MCP (Multi‑Client Proxy) macht das möglich, indem es die langweiligen Teile für Sie erledigt:

Was Oxylabs MCP tut	Warum es für Sie wichtig ist
Automatisierte Anfrage-Barrieren verwalten mit dem globalen Proxy-Netzwerk von Oxylabs	Ermöglicht Website-Zugriff und Anonymität
JavaScript rendern in headless Chrome	Single‑Page-Apps, erledigt
HTML bereinigen → JSON	Direkt in Vektordatenbanken oder Prompts einfügen
Optionale strukturierte Parser (Google, Amazon, etc.)	Einzeiliger Zugriff auf beliebte Ziele

mcp-name: io.oxylabs/oxylabs-mcp