Skip to main content
Glama
Oxylabs MCP Server

Oxylabs MCP Server

Official

pypi package Licence Coverage badge


📖 Ü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

  1. universal_scraper: scrapet beliebige URLs, mit optionalem JavaScript-Rendering, Geo-Targeting und Markdown/HTML/Links-Ausgabe;

  2. google_search_scraper: extrahiert Ergebnisse aus der Google-Suche, mit optionalem Parsing in strukturiertes JSON;

  3. amazon_search_scraper: scrapet Amazon-Suchergebnisseiten, mit optionalem Parsing in strukturiertes JSON;

  4. amazon_product_scraper: extrahiert Daten aus einzelnen Amazon-Produktseiten.

Oxylabs-AI-Studio-Tools

  1. ai_scraper: scrapet Inhalte von beliebigen URLs mit KI-gestützter Extraktion, im JSON-, CSV-, Markdown- oder TOON-Format;

  2. ai_crawler: durchsucht eine Website ausgehend von einer Start-URL basierend auf einem Prompt und sammelt Daten über mehrere Seiten;

  3. ai_browser_agent: steuert einen echten Browser basierend auf einem Prompt – navigiert, klickt, füllt Formulare aus – und gibt das Ergebnis zurück;

  4. ai_search: durchsucht das Web und gibt optional den Markdown-Inhalt jedes Ergebnisses zurück;

  5. ai_map: kartiert die URLs einer Website, gefiltert nach Schlüsselwörtern oder einem Prompt;

  6. 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/mcp

Anmeldedaten werden über Request-Header übergeben:

Anmeldedaten

Header

Web Scraper API

Authorization: Basic <base64(username:password)>

Web Scraper API (alternativ)

X-Oxylabs-Username und X-Oxylabs-Password

AI Studio

X-Oxylabs-AI-Studio-Api-Key

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

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

Protokollierungsgrad für die an den Client zurückgegebenen Protokolle

INFO

Basierend auf den bereitgestellten Anmeldedaten 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 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-mcp

Beim HTTP-Transport werden Anmeldedaten pro Request übergeben, statt über Umgebungsvariablen:

Anmeldedaten

So übergeben Sie sie

Web Scraper API

Authorization: Basic <base64(username:password)> (Standard-HTTP-Basic-Auth)

Web Scraper API (alternativ)

X-Oxylabs-Username- und X-Oxylabs-Password-Header

AI Studio

X-Oxylabs-AI-Studio-Api-Key-Header

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.

image

mcp-name: io.oxylabs/oxylabs-mcp

Available Tools

10 tools
ai_browser_agentC
Read-only
Inspect

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_crawlerC
Read-only
Inspect

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_mapD
Read-only
Inspect

Tool useful for mapping website's URLs.

Inputs: url (required), limit, user_prompt, geo_location, +5 more. Returns: result

ai_scraperA
Read-only
Inspect

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

amazon_product_scraperA
Read-only
Inspect

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_scraperB
Read-only
Inspect

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_schemaC
Read-only
Inspect

Generate a json schema in openapi format.

Inputs: app_name (required), user_prompt (required). Returns: result

google_search_scraperA
Read-only
Inspect

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_scraperB
Read-only
Inspect

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

    B3/5.0

    Scored across 10 tools

    Disambiguation2/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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 PyPI
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      33
      859 npm
      41
      ISC
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      5
      35 PyPI
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      Enables web scraping, structured data extraction, and screenshot capture with automatic anti-bot bypass, supporting JavaScript rendering, proxy rotation, and tiered pricing.
      26
      2,618 npm
      2
      MIT