📖 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.
Related MCP server: MCP Firecrawl Server
✨ 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 direcciones IP rotatorias automáticas de un grupo de servidores 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/B0CNKD651Vcon análisis habilitadoRaspar
https://www.amazon.de/-/en/gp/bestsellers/beauty/ref=zg_bs_nav_beauty_0con análisis y renderizado habilitadosUtilice 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:
Parámetro | Descripción | Valores |
| La URL para raspar | Cualquier URL válida |
| Habilitar la extracción de datos estructurados |
o
|
| Utilice la representación del navegador sin cabeza |
o
|
⚙️ 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
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" } } } }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\\\"}\"" ] } } }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 conbrew install uv
Si encuentra errores conuvx , 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 .
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.
