Servidor Mcp de Oxylabs

¿Qué es Oxylabs MCP?

Oxylabs MCP (Proxy en la Nube Administrado) es una solución robusta diseñada para proporcionar a los usuarios acceso sin interrupciones a datos web a través de una red de proxies residenciales y de centros de datos. Este servicio está diseñado para empresas y desarrolladores que requieren capacidades de raspado web confiables y eficientes, asegurando que puedan recopilar datos de diversas fuentes en línea sin ser bloqueados o restringidos.

Características de Oxylabs MCP

• Red de Proxies Extensa: Oxylabs MCP cuenta con una vasta red de más de 100 millones de IPs residenciales y proxies de centros de datos, permitiendo a los usuarios acceder a contenido geo-dirigido y eludir restricciones.
• Alta Anonimidad: El servicio garantiza la anonimidad del usuario, dificultando que los sitios web detecten actividades de raspado, reduciendo así el riesgo de bloqueos de IP.
• Panel de Control Amigable: El panel intuitivo proporciona a los usuarios una fácil gestión de sus configuraciones de proxy, estadísticas de uso e información de facturación.
• Planes de Precios Flexibles: Oxylabs ofrece varios planes de precios para adaptarse a diferentes necesidades, ya sea para pequeños proyectos o grandes operaciones de raspado de datos.
• Soporte al Cliente 24/7: Los usuarios tienen acceso a soporte continuo para ayudar con cualquier problema o consulta relacionada con el servicio.

Cómo Usar Oxylabs MCP

1. Regístrate: Crea una cuenta en el sitio web de Oxylabs para obtener acceso al servicio MCP.
2. Elige un Plan: Selecciona un plan de precios que se ajuste a tus necesidades de raspado de datos.
3. Configura Tus Proxies: Utiliza el panel para configurar tus configuraciones de proxy, incluyendo la selección del tipo de proxies que necesitas (residenciales o de centro de datos).
4. Integra con Tu Aplicación: Utiliza la API proporcionada o las herramientas de integración para conectar Oxylabs MCP con tu aplicación de raspado web.
5. Comienza a Raspado: Inicia tu proceso de recopilación de datos, asegurándote de monitorear el uso y el rendimiento a través del panel.

Preguntas Frecuentes

P: ¿Qué tipos de proxies ofrece Oxylabs MCP?

R: Oxylabs MCP proporciona tanto proxies residenciales como de centros de datos, permitiendo a los usuarios elegir según sus requisitos específicos de raspado.

P: ¿Hay un límite en la cantidad de datos que puedo raspar?

R: Los límites dependen del plan de precios que selecciones. Cada plan viene con su propia asignación de datos, por lo que es esencial elegir uno que se alinee con tus necesidades de raspado.

P: ¿Puedo usar Oxylabs MCP para propósitos de SEO?

R: Sí, muchos usuarios aprovechan Oxylabs MCP para tareas de SEO como seguimiento de posiciones, análisis de competidores e investigación de mercado, gracias a su capacidad para acceder a datos localizados.

P: ¿Qué sucede si mi IP es bloqueada?

R: Oxylabs MCP está diseñado para minimizar el riesgo de bloqueos de IP a través de su función de proxy rotativo, que cambia automáticamente tu dirección IP a intervalos establecidos o después de cada solicitud.

P: ¿Cómo contacto al soporte al cliente?

R: Puedes comunicarte con el soporte al cliente de Oxylabs a través del formulario de contacto en su sitio web o mediante la función de chat en vivo disponible en el panel.

<p align="center"> <img src="https://storage.googleapis.com/oxylabs-public-assets/oxylabs_mcp.svg" alt="Oxylabs + MCP"> </p> <h1 align="center" style="border-bottom: none;"> Oxylabs MCP Server </h1> <p align="center"> <em>The missing link between AI models and the real‑world web: one API that delivers clean, structured data from any site.</em> </p> <div align="center">

<br/> <a href="https://glama.ai/mcp/servers/@oxylabs/oxylabs-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@oxylabs/oxylabs-mcp/badge" alt="Oxylabs Server MCP server" /> </a> </div>

📖 Overview

The Oxylabs MCP server provides a bridge between AI models and the web. It enables them to scrape any URL, render JavaScript-heavy pages, extract and format content for AI use, bypass anti-scraping measures, and access geo-restricted web data from 195+ countries.

This implementation leverages the Model Context Protocol (MCP) to create a secure, standardized way for AI assistants to interact with web content.

Why Oxylabs MCP?  🕸️ ➜ 📦 ➜ 🤖

Imagine telling your LLM "Summarise the latest Hacker News discussion about GPT‑7" – and it simply answers.
MCP (Multi‑Client Proxy) makes that happen by doing the boring parts for you:

| What Oxylabs MCP does | Why it matters to you | |-|| | Bypasses anti‑bot walls with the Oxylabs global proxy network | Keeps you unblocked and anonymous | | Renders JavaScript in headless Chrome | Single‑page apps, sorted | | Cleans HTML → JSON | Drop straight into vector DBs or prompts | | Optional structured parsers (Google, Amazon, etc.) | One‑line access to popular targets |

✨ Key Features

<details> <summary><strong> Scrape content from any site</strong></summary> <br>

• Extract data from any URL, including complex single-page applications
• Fully render dynamic websites using headless browser support
• Choose full JavaScript rendering, HTML-only, or none
• Emulate Mobile and Desktop viewports for realistic rendering

</details> <details> <summary><strong> Automatically get AI-ready data</strong></summary> <br>

• Automatically clean and convert HTML to Markdown for improved readability
• Use automated parsers for popular targets like Google, Amazon, and etc.

</details> <details> <summary><strong> Bypass blocks & geo-restrictions</strong></summary> <br>

• Bypass sophisticated bot protection systems with high success rate
• Reliably scrape even the most complex websites
• Get automatically rotating IPs from a proxy pool covering 195+ countries

</details> <details> <summary><strong> Flexible setup & cross-platform support</strong></summary> <br>

• Set rendering and parsing options if needed
• Feed data directly into AI models or analytics tools
• Works on macOS, Windows, and Linux

</details> <details> <summary><strong> Built-in error handling and request management</strong></summary> <br>

• Comprehensive error handling and reporting
• Smart rate limiting and request management

</details>

🛠️ MCP Tools

Oxylabs MCP provides the following tools:

1. universal_scraper: Uses Oxylabs Web Scraper API for general website scraping.
2. google_search_scraper: Uses Oxylabs Web Scraper API to extract results from Google Search.
3. amazon_search_scraper: Uses Oxylabs Web Scraper API to scrape Amazon search result pages.
4. amazon_product_scraper: Uses Oxylabs Web Scraper API to extract data from individual Amazon product pages.

💡 Example Queries

When you've set up the MCP server with Claude, you can make requests like:

• Could you scrape https://www.google.com/search?q=ai page?
• Scrape https://www.amazon.de/-/en/Smartphone-Contract-Function-Manufacturer-Exclusive/dp/B0CNKD651V with parse enabled
• Scrape https://www.amazon.de/-/en/gp/bestsellers/beauty/ref=zg_bs_nav_beauty_0 with parse and render enabled
• Use web unblocker with render to scrape https://www.bestbuy.com/site/top-deals/all-electronics-on-sale/pcmcat1674241939957.c

✅ Prerequisites

Before you begin, make sure you have:

• Oxylabs Account: Obtain your username and password from Oxylabs (1-week free trial available)

Basic Usage

Via Smithery CLI:

• Node.js (v16+)
• npx command-line tool

Via uv:

• uv package manager – install it using this guide

Local/Dev Setup

• Python 3.12+
• uv package manager – install it using this guide

🧩 API Parameters

The Oxylabs MCP Universal Scraper accepts these parameters:

| Parameter | Description | Values | |-|-|| | url | The URL to scrape | Any valid URL | | render | Use headless browser rendering | html or None | | geo_location | Sets the proxy's geo location to retrieve data. | Brasil, Canada, etc. | | user_agent_type | Device type and browser | desktop, tablet, etc. | | output_format | The format of the output | links, md, html |

🔧 Configuration

<details> <summary><strong><code>smithery</code></strong></summary>

1. Go to https://smithery.ai/server/@oxylabs/oxylabs-mcp
2. Login with GitHub
3. Find the Install section
4. Follow the instructions to generate the config

Auto install with Smithery CLI

### example for Claude Desktop
npx -y @smithery/cli@latest install @upstash/context7-mcp --client claude --key <smithery_key>

</details> <details> <summary><strong><code>uvx</code></strong></summary>

1. Install the 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"

2. Use the following config

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

</details> <details> <summary><strong><code>uv</code></strong></summary>

1. Install the 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"

2. Use the following config

{
  "mcpServers": {
    "oxylabs": {
      "command": "uv",
      "args": [
        "--directory",
        "/<Absolute-path-to-folder>/oxylabs-mcp",
        "run",
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_USERNAME": "OXYLABS_USERNAME",
        "OXYLABS_PASSWORD": "OXYLABS_PASSWORD"
      }
    }
  }
}

</details>

Manual Setup with Claude Desktop

Navigate to Claude → Settings → Developer → Edit Config and add one of the configurations above to the claude_desktop_config.json file.

Manual Setup with Cursor AI

Navigate to Cursor → Settings → Cursor Settings → MCP. Click Add new global MCP server and add one of the configurations above.

⚙️ Environment variables

Oxylabs MCP server supports the following environment variables

| Name | Description | Mandatory | Default | |--|--||| | OXYLABS_USERNAME | Your Oxylabs username | true | | | OXYLABS_PASSWORD | Your Oxylabs password | true | | | LOG_LEVEL | Log level for the logs returned to the client | false | INFO |

📝 Logging

Server provides additional information about the tool calls in notification/message events

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

🛡️ License

Distributed under the MIT License – see LICENSE for details.

About Oxylabs

Established in 2015, Oxylabs is a market-leading web intelligence collection platform, driven by the highest business, ethics, and compliance standards, enabling companies worldwide to unlock data-driven insights.

<div align="center"> _{Made with ☕ by <a href="https://oxylabs.io">Oxylabs</a>. Feel free to give us a ⭐ if MCP saved you a weekend.} </div>