Oxylabs

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 de 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 de más de 195 países.

Está construido sobre el Protocolo de Contexto de Modelo (MCP), el estándar abierto para conectar asistentes de IA con herramientas y datos externos.

🛠️ Herramientas MCP

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

Herramientas de la API Web Scraper de Oxylabs

1. universal_scraper: extrae cualquier URL, con renderizado de JavaScript opcional, geo-targeting 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

5. ai_scraper: extrae contenido de cualquier URL con extracción impulsada por IA, en formato JSON, CSV, Markdown o TOON;
6. ai_crawler: rastrea un sitio web desde una URL inicial basándose en un prompt y recopila datos de múltiples páginas;
7. ai_browser_agent: controla un navegador real basándose en un prompt — navega, hace clic, rellena formularios — y devuelve el resultado;
8. ai_search: busca en la web y opcionalmente devuelve el contenido en Markdown de cada resultado;
9. ai_map: mapea las URLs de un sitio web, filtradas por palabras clave o un prompt;
10. 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 API Web Scraper de Oxylabs: 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: conéctate a la instancia alojada (sin instalación) o ejecútalo 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 la solicitud:

Credencial	Encabezado
API Web Scraper	Authorization: Basic <base64(username:password)>
API Web Scraper (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 MCP de Oxylabs admite las siguientes variables de entorno:

Nombre	Descripción	Predeterminado
OXYLABS_USERNAME	Tu nombre de usuario de la API Web Scraper de Oxylabs
OXYLABS_PASSWORD	Tu contraseña de la API Web Scraper de Oxylabs
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 la API Web Scraper;
• 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 resultará en herramientas expuestas que no funcionan.

Configurar con uvx

Instala el paquete desde 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 un checkout 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
API Web Scraper	Authorization: Basic <base64(username:password)> (autenticación básica HTTP estándar)
API Web Scraper (alternativa)	X-Oxylabs-Username y X-Oxylabs-Password encabezados
AI Studio	X-Oxylabs-AI-Studio-Api-Key encabezado

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 → Configuración → Desarrollador → Editar configuración y agrega una de las configuraciones anteriores al archivo claude_desktop_config.json.

Configuración con Cursor AI

Navega a Cursor → Configuración → Configuración de Cursor → MCP. Haz clic en Agregar nuevo servidor MCP global 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 clave

Extrae 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 interfaz
• Elige renderizado completo de JavaScript, solo HTML o ninguno
• Emula viewports móviles y de escritorio para un renderizado realista

Obtén automáticamente datos listos para IA

• 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

Gestiona CAPTCHA y restricciones geográficas

• Navega sistemas sofisticados de gestión automatizada de solicitudes con alta tasa de éxito
• Extrae de manera confiable 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

Configuración flexible y soporte multiplataforma

• 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

Manejo de errores y gestión de solicitudes integrados

• Manejo y reporte integral de errores
• Limitación de velocidad inteligente y gestión de solicitudes

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

Imagina decirle a tu LLM "Resume la discusión más reciente de Hacker News sobre GPT‑5" – y simplemente responde. El servidor MCP de Oxylabs hace que eso suceda 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 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 LICENCIA 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 conocimientos basados en datos.

mcp-name: io.oxylabs/oxylabs-mcp

Soluciones creadas basadas en este MCP:

Michelin Detour