Oxylabs MCP Server

oficial

Extraiga datos de sitios web con Oxylabs Web API, compatible con renderizado dinámico y análisis para la extracción estructurada de datos.

GitHub

100

Documentación

Oxylabs + MCP

Servidor MCP de Oxylabs

El eslabón perdido entre los modelos de IA y la web del mundo real: una API que entrega datos limpios y estructurados desde cualquier sitio.

📖 Descripción general

El servidor MCP de Oxylabs proporciona un puente entre los modelos de IA y la web. Les 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 con restricciones geográficas desde más de 195 países.

🛠️ Herramientas MCP

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

Herramientas de la API de Web Scraper de Oxylabs

universal_scraper: Utiliza la API de Web Scraper de Oxylabs para el raspado general de sitios web;
google_search_scraper: Utiliza la API de Web Scraper de Oxylabs para extraer resultados de Google Search;
amazon_search_scraper: Utiliza la API de Web Scraper de Oxylabs para raspar páginas de resultados de búsqueda de Amazon;
amazon_product_scraper: Utiliza la API de Web Scraper de Oxylabs para extraer datos de páginas de productos individuales de Amazon.

Herramientas de AI Studio de Oxylabs

ai_scraper: Raspa contenido de cualquier URL en formato JSON o Markdown con extracción de datos potenciada por IA;
ai_crawler: Basado en un prompt, rastrea un sitio web y recopila datos en formato Markdown o JSON a través de múltiples páginas;
ai_browser_agent: Basado en un prompt, controla un navegador y devuelve datos en formatos Markdown, JSON, HTML o captura de pantalla;
ai_search: Busca en la web URLs y sus contenidos con extracción de contenido potenciada por IA.

✅ Requisitos previos

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

Cuenta de la API de Web Scraper de Oxylabs: Obtén tu nombre de usuario y contraseña desde Oxylabs (prueba gratuita de 1 semana disponible);
Clave de API de AI Studio de Oxylabs: Obtén tu clave de API desde Oxylabs AI Studio. (1000 créditos gratis).

📦 Configuración

Variables de entorno

El servidor MCP de Oxylabs admite las siguientes variables de entorno:

Nombre	Descripción	Valor por defecto
`OXYLABS_USERNAME`	Tu nombre de usuario de la API de Web Scraper de Oxylabs
`OXYLABS_PASSWORD`	Tu contraseña de la API de Web Scraper de Oxylabs
`OXYLABS_AI_STUDIO_API_KEY`	Tu clave de API de AI Studio de Oxylabs
`LOG_LEVEL`	Nivel de registro para los logs devueltos al cliente	`INFO`

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

Si solo se proporcionan OXYLABS_USERNAME y OXYLABS_PASSWORD, el servidor expondrá las herramientas de la API de Web Scraper;
Si solo se proporciona OXYLABS_AI_STUDIO_API_KEY, el servidor expondrá las herramientas de AI Studio;
Si se proporcionan tanto OXYLABS_USERNAME y OXYLABS_PASSWORD como OXYLABS_AI_STUDIO_API_KEY, el servidor expondrá todas las herramientas.

❗❗❗ Nota importante: si no tienes credenciales de la API de Web Scraper o de AI Studio de Oxylabs, elimina los marcadores de posición de las variables de entorno correspondientes. Dejar valores de marcador de posición resultará en herramientas expuestas que no funcionan.

Configurar con uvx

Instala el gestor de paquetes uvx:

# 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"

Usa la siguiente configuración:

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

Configurar con uv

Instala 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"

Usa la siguiente configuración:

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

Configurar con Smithery Oauth2

Ve a https://smithery.ai/server/@oxylabs/oxylabs-mcp;
Haz clic en Auto para instalar la configuración MCP de Oxylabs para el cliente respectivo;
O usa la siguiente configuración:

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

Sigue las instrucciones para autenticar Oxylabs MCP con el flujo Oauth2

Configurar con parámetros de consulta de Smithery

En caso de que tu cliente no admita la autenticación Oauth2, puedes pasar los parámetros de autenticación de Oxylabs directamente en la url

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

Configuración manual con Claude Desktop

Navega a Claude → Configuración → Desarrollador → Editar configuración y añade una de las configuraciones anteriores al archivo claude_desktop_config.json.

Configuración manual con Cursor AI

Navega a Cursor → Configuración → Configuración de Cursor → MCP. Haz clic en Añadir nuevo servidor MCP global y añade una de las configuraciones anteriores.

📝 Registro

El servidor proporciona información adicional sobre las llamadas a las herramientas en los 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"
  }
}

🛡️ Licencia

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

Acerca de Oxylabs

Fundada 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.

_{Hecho con ☕ por Oxylabs. No dudes en darnos una ⭐ si MCP te ahorró un fin de semana.}

✨ Características clave

Raspa contenido de cualquier sitio

Extrae datos de cualquier URL, incluidas aplicaciones complejas de una sola página
Renderiza completamente sitios web dinámicos usando soporte de navegador sin cabeza
Elige renderizado completo de JavaScript, solo HTML o ninguno
Emula ventanas gráficas de escritorio y móviles para un renderizado realista

Obtén automáticamente datos listos para IA

Limpia y convierte automáticamente HTML a Markdown para mejorar la legibilidad
Utiliza analizadores automáticos para objetivos populares como Google, Amazon y más

Gestiona CAPTCHA y restricciones geográficas

Navega por sofisticados sistemas de gestión de solicitudes automatizadas con una alta tasa de éxito
Raspa de forma fiable incluso los sitios web más complejos
Obtén IPs rotativas automáticamente desde un pool de proxies que cubre más de 195 países

Configuración flexible y soporte multiplataforma

Establece opciones de renderizado y análisis si es necesario
Introduce datos directamente en modelos de IA o herramientas de análisis
Funciona en macOS, Windows y Linux

Manejo de errores y gestión de solicitudes integrados

Manejo y notificación de errores exhaustivos
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 que simplemente responda.
MCP (Multi‑Client Proxy) lo hace posible encargándose de las partes aburridas por ti:

Qué hace Oxylabs MCP	Por qué es importante para ti
Gestiona los muros de solicitudes automatizadas con la red global de proxies de Oxylabs	Permite el acceso al sitio web y el anonimato
Renderiza JavaScript en Chrome sin cabeza	Aplicaciones de una sola página, resueltas
Limpia HTML → JSON	Insértalo directamente en bases de datos vectoriales o prompts
Analizadores estructurados opcionales (Google, Amazon, etc.)	Acceso en una línea a objetivos populares

mcp-name: io.oxylabs/oxylabs-mcp