Skip to main content
Glama
Oxylabs MCP Server

Oxylabs MCP Server

Official

pypi package Licence Coverage badge


📖 Resumen

El servidor Oxylabs MCP proporciona un puente entre los modelos de IA y la web. Permite extraer cualquier URL, renderizar páginas con mucho JavaScript, extraer y formatear contenido para uso de IA, gestionar CAPTCHA y acceder a datos web restringidos geográficamente de más de 195 países.

Está construido sobre el Model Context Protocol (MCP), el estándar abierto para conectar asistentes de IA a herramientas y datos externos.

Related MCP server: Decodo MCP Server

🛠️ Herramientas MCP

Oxylabs MCP proporciona dos conjuntos de herramientas que se pueden usar juntas o de forma independiente:

Herramientas de la API Oxylabs Web Scraper

  1. universal_scraper: extrae cualquier URL, con renderizado de JavaScript opcional, geolocalización y salida en Markdown/HTML/enlaces;

  2. google_search_scraper: extrae resultados de Google Search, con análisis opcional a JSON estructurado;

  3. amazon_search_scraper: extrae páginas de resultados de búsqueda de Amazon, con análisis opcional a JSON estructurado;

  4. amazon_product_scraper: extrae datos de páginas individuales de productos de Amazon.

Herramientas de Oxylabs AI Studio

  1. ai_scraper: extrae contenido de cualquier URL con extracción impulsada por IA, en formato JSON, CSV, Markdown o TOON;

  2. ai_crawler: rastrea un sitio web desde una URL inicial basándose en un prompt y recopila datos en múltiples páginas;

  3. ai_browser_agent: controla un navegador real basándose en un prompt — navega, hace clic, rellena formularios — y devuelve el resultado;

  4. ai_search: busca en la web y opcionalmente devuelve el contenido en Markdown de cada resultado;

  5. ai_map: mapea las URLs de un sitio web, filtradas por palabras clave o un prompt;

  6. generate_schema: genera un esquema JSON en formato OpenAPI para extracción estructurada con las herramientas de IA anteriores.

✅ Requisitos previos

Antes de comenzar, asegúrate de tener al menos uno de los siguientes:

  • Cuenta de Oxylabs Web Scraper API: obtén tu nombre de usuario y contraseña en Oxylabs (prueba gratuita de 1 semana disponible);

  • Clave de API de Oxylabs AI Studio: obtén tu clave de API en Oxylabs AI Studio (1000 créditos gratis).

Para ejecutar el servidor localmente (Opción 2 a continuación) también necesitarás el gestor de paquetes 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"

📦 Configuración

Hay dos formas de usar el servidor: conectarse a la instancia alojada (sin instalación) o ejecutarlo localmente con credenciales en variables de entorno.

Opción 1: Servidor alojado (sin instalación)

Oxylabs ejecuta un servidor MCP alojado en:

https://mcp.oxylabs.io/mcp

Las credenciales se pasan con los encabezados de las solicitudes:

Credencial

Encabezado

Web Scraper API

Authorization: Basic <base64(username:password)>

Web Scraper API (alternativa)

X-Oxylabs-Username y X-Oxylabs-Password

AI Studio

X-Oxylabs-AI-Studio-Api-Key

Configuración con 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"

Configuración con Cursor o cualquier cliente que admita servidores MCP remotos con encabezados personalizados:

{
  "mcpServers": {
    "oxylabs": {
      "url": "https://mcp.oxylabs.io/mcp",
      "headers": {
        "Authorization": "Basic <base64 of username:password>",
        "X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

El servidor también está listado en Smithery.

Nota: los clientes que solo admiten OAuth para servidores remotos (por ejemplo, agregar un conector personalizado en la interfaz web de claude.ai) aún no pueden pasar encabezados — el inicio de sesión con OAuth está en nuestra hoja de ruta. Usa la configuración local a continuación con esos clientes mientras tanto.

Opción 2: Ejecutar localmente

Variables de entorno

El servidor Oxylabs MCP admite las siguientes variables de entorno:

Nombre

Descripción

Predeterminado

OXYLABS_USERNAME

Tu nombre de usuario de Oxylabs Web Scraper API

OXYLABS_PASSWORD

Tu contraseña de Oxylabs Web Scraper API

OXYLABS_AI_STUDIO_API_KEY

Tu clave de API de Oxylabs AI Studio

LOG_LEVEL

Nivel de registro para los registros devueltos al cliente

INFO

Según las credenciales proporcionadas, el servidor expone automáticamente las herramientas correspondientes:

  • Si solo se proporcionan OXYLABS_USERNAME y OXYLABS_PASSWORD, el servidor expone las herramientas de Web Scraper API;

  • Si solo se proporciona OXYLABS_AI_STUDIO_API_KEY, el servidor expone las herramientas de AI Studio;

  • Si se proporcionan las tres, el servidor expone todas las herramientas.

❗ Importante: solo establece las variables de entorno para las que tengas credenciales reales. Dejar valores de marcador de posición dará como resultado herramientas expuestas que no funcionan.

Configurar con uvx

Instala el paquete de PyPI y lo ejecuta automáticamente:

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

Configurar con una copia local

Útil para desarrollo — ejecuta el servidor desde un clon local de este repositorio:

{
  "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"
      }
    }
  }
}

Ejecutar como servidor HTTP remoto (autoalojamiento)

El servidor también admite el transporte MCP streamable-HTTP. Inícialo con:

MCP_TRANSPORT=streamable-http MCP_HOST=0.0.0.0 MCP_PORT=8000 uvx oxylabs-mcp

Con el transporte HTTP, las credenciales se pasan por solicitud en lugar de variables de entorno:

Credencial

Cómo pasarla

Web Scraper API

Authorization: Basic <base64(username:password)> (autenticación básica HTTP estándar)

Web Scraper API (alternativa)

Encabezados X-Oxylabs-Username y X-Oxylabs-Password

AI Studio

Encabezado X-Oxylabs-AI-Studio-Api-Key

Ejemplo de configuración de cliente:

{
  "mcpServers": {
    "oxylabs": {
      "url": "https://your-host:8000/mcp",
      "headers": {
        "Authorization": "Basic <base64 of username:password>",
        "X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Todas las herramientas siempre se listan independientemente de las credenciales proporcionadas; llamar a una herramienta sin las credenciales que necesita devuelve un mensaje de error que explica exactamente qué configurar.

Configuración con Claude Desktop

Navega a Claude → Settings → Developer → Edit Config y agrega una de las configuraciones anteriores al archivo claude_desktop_config.json.

Configuración con Cursor AI

Navega a Cursor → Settings → Cursor Settings → MCP. Haz clic en Add new global MCP server y agrega una de las configuraciones anteriores.

📝 Registro

El servidor proporciona información adicional sobre las llamadas a herramientas en eventos notification/message:

{
  "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"
  }
}

✨ Características principales

  • Extrae datos de cualquier URL, incluidas aplicaciones complejas de una sola página

  • Renderiza completamente sitios web dinámicos con soporte de navegador sin interfaz

  • Elige renderizado completo de JavaScript, solo HTML o ninguno

  • Emula viewports de móvil y escritorio para un renderizado realista

  • Limpia y convierte automáticamente HTML a Markdown para mejorar la legibilidad

  • Usa analizadores automáticos para objetivos populares como Google, Amazon y más

  • Supera sistemas sofisticados de gestión de solicitudes automatizadas con alta tasa de éxito

  • Extrae de forma fiable incluso los sitios web más complejos

  • Obtén IPs rotativas automáticamente de un grupo de proxies que cubre más de 195 países

  • Establece opciones de renderizado y análisis si es necesario

  • Alimenta datos directamente a modelos de IA o herramientas de análisis

  • Funciona en macOS, Windows y Linux

  • Gestión y notificación de errores integral

  • Limitación de velocidad inteligente y gestión de solicitudes

¿Por qué Oxylabs MCP? 🕸️ ➜ 📦 ➜ 🤖

Imagina decirle a tu LLM "Resume la última discusión de Hacker News sobre GPT‑5" – y simplemente responde. El servidor Oxylabs MCP lo hace posible haciendo las partes aburridas por ti:

Lo que hace Oxylabs MCP

Por qué te importa

Gestiona muros de solicitudes automatizadas con la red global de proxies de Oxylabs

Permite el acceso a sitios web y el anonimato

Renderiza JavaScript en Chrome sin interfaz

Aplicaciones de una sola página, resueltas

Limpia HTML → Markdown

Insértalo directamente en bases de datos vectoriales o prompts

Analizadores estructurados opcionales (Google, Amazon, etc.)

Acceso en una línea a objetivos populares


🛡️ Licencia

Distribuido bajo la Licencia MIT – consulta LICENSE para más detalles.


Acerca de Oxylabs

Establecida en 2015, Oxylabs es una plataforma líder en el mercado de recopilación de inteligencia web, impulsada por los más altos estándares de negocio, ética y cumplimiento, que permite a empresas de todo el mundo desbloquear información basada en datos.

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