Oxylabs MCP Server

📖 Descripción general

El servidor MCP de Oxylabs conecta los modelos de IA con la web. Les permite extraer cualquier URL, renderizar páginas con alto contenido de JavaScript, extraer y formatear contenido para su uso con IA, eludir las medidas anti-scraping y acceder a datos web con restricciones geográficas de más de 195 países.

Esta implementación aprovecha el Protocolo de Contexto de Modelo (MCP) para crear una forma segura y estandarizada para que los asistentes de IA interactúen con el contenido web.

✨ Características principales

• Extraiga datos de cualquier URL, incluidas aplicaciones complejas de una sola página
• Renderice sitios web completamente dinámicos mediante compatibilidad con navegadores sin interfaz gráfica
• Elija entre representación completa de JavaScript, solo HTML o ninguna
• Emule las vistas móviles y de escritorio para una representación realista
• Limpia y convierte automáticamente HTML a Markdown para mejorar la legibilidad
• Utilice analizadores automáticos para objetivos populares como Google, Amazon, etc.
• Evita los sofisticados sistemas de protección contra bots con una alta tasa de éxito
• Rasgue de forma fiable incluso los sitios web más complejos
• Obtenga IP rotatorias automáticas de un grupo de proxy que cubre más de 195 países
• Establezca las opciones de representación y análisis si es necesario
• Introduzca datos directamente en modelos de IA o herramientas de análisis
• Funciona en macOS, Windows y Linux
• Gestión y generación de informes de errores integrales
• Limitación inteligente de velocidad y gestión de solicitudes

💡 Consultas de ejemplo

Cuando haya configurado el servidor MCP con Claude , podrá realizar solicitudes como:

• ¿Podrías raspar la página https://www.google.com/search?q=ai ?
• Raspar https://www.amazon.de/-/en/Smartphone-Contract-Function-Manufacturer-Exclusive/dp/B0CNKD651V con análisis habilitado
• Raspar https://www.amazon.de/-/en/gp/bestsellers/beauty/ref=zg_bs_nav_beauty_0 con análisis y renderizado habilitados
• Utilice el desbloqueador web con render para raspar https://www.bestbuy.com/site/top-deals/all-electronics-on-sale/pcmcat1674241939957.c

✅ Requisitos previos

Antes de comenzar, asegúrese de tener:

• Cuenta Oxylabs : Obtenga su nombre de usuario y contraseña de Oxylabs (prueba gratuita de 1 semana disponible)

Uso básico

A través de Smithery CLI:

• Node.js (v16+)
• herramienta de línea de comandos npx

Vía uv:

• Gestor de paquetes uv : instálelo siguiendo esta guía

Configuración local/de desarrollo

• Python 3.12+
• Gestor de paquetes uv : instálelo siguiendo esta guía

🧩 Parámetros de la API

El servidor MCP de Oxylabs admite estos parámetros:

⚙️ Instrucciones básicas de configuración

Instalar a través de Smithery

Instalar automáticamente el servidor MCP de Oxylabs a través de Smithery :

Listado de clientes soportados por Oxylabs actualmente:

• claudio
• cursor

Opciones de configuración manual de MCP

1. Configuración con uvx . Instalará el cliente CLI y el servidor MCP de Oxylabs, que realiza llamadas directamente a la API de Oxylabs. Recomendado y la opción más estable actualmente.
   { "mcpServers": { "oxylabs_scraper_uvx": { "command": "uvx", "args": [ "oxylabs-mcp" ], "env": { "OXYLABS_USERNAME": "OXYLABS_USERNAME", "OXYLABS_PASSWORD": "OXYLABS_PASSWORD" } } } }
2. Configuración con npx . Instalará el cliente CLI de Smithery que realiza llamadas al servidor MCP de Oxylabs alojado en Smithery.
   { "mcpServers": { "oxylabs-mcp": { "command": "npx", "args": [ "-y", "@smithery/cli@latest", "run", "@oxylabs/oxylabs-mcp", "--config", "\"{\\\"oxylabsUsername\\\":\\\"OXYLABS_USERNAME\\\",\\\"oxylabsPassword\\\":\\\"OXYLABS_PASSWORD\\\"}\"" ] } } }
3. Configuración con uv . Se instalará el cliente CLI y el servidor MCP de Oxylabs que referencia el código local. Para el desarrollo local.
   { "mcpServers": { "oxylabs_scraper": { "command": "uv", "args": [ "--directory", "/<Absolute-path-to-folder>/oxylabs-mcp", "run", "oxylabs-mcp" ], "env": { "OXYLABS_USERNAME": "OXYLABS_USERNAME", "OXYLABS_PASSWORD": "OXYLABS_PASSWORD" } } } }

[!NOTA] Si no tiene la utilidad uvx , primero debe instalarla con brew install uv

[!TIP] Si encuentra errores con uvx , intente usar la ruta completa de uvx en el campo command . Por ejemplo, /Users/my-user/.local/bin/uvx . Si usa Windows y tiene problemas con Cursor, consulte las instrucciones descritas aquí .

Configuración manual con Claude Desktop

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

Configuración manual con Cursor AI

Vaya a Cursor → Configuración → Configuración del cursor → MCP . Haga clic en "Agregar nuevo servidor MCP global" y agregue una de las configuraciones anteriores.

Instrucciones de configuración local/de desarrollo

Repositorio de clones

Instalar dependencias

Instalar las dependencias del servidor MCP:

🐞 Depuración

A continuación, acceda al Inspector de MCP en http://localhost:5173 . Es posible que deba agregar su nombre de usuario y contraseña como variables de entorno en el inspector, bajo OXYLABS_USERNAME y OXYLABS_PASSWORD .

🛠️ Detalles técnicos

Este servidor proporciona dos herramientas principales:

1. oxylabs_scraper : utiliza la API de raspador web de Oxylabs para el raspado general de sitios web
2. oxylabs_web_unblocker : Utiliza Oxylabs Web Unblocker para sitios web de difícil acceso.

La API de Web Scraper admite la renderización de JavaScript, el análisis de datos estructurados y la limpieza de HTML en formato Markdown. Web Unblocker ofrece renderización de JavaScript y limpieza de HTML, pero no devuelve datos analizados.

Licencia

Este proyecto está licenciado bajo la licencia MIT .

Acerca de Oxylabs

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