Serveur Mcp d'Oxylabs
Aperçu
Qu'est-ce qu'Oxylabs MCP ?
Oxylabs MCP (Managed Cloud Proxy) est une solution robuste conçue pour offrir aux utilisateurs un accès fluide aux données web via un réseau de proxies résidentiels et de centres de données. Ce service est adapté aux entreprises et aux développeurs qui nécessitent des capacités de web scraping fiables et efficaces, garantissant qu'ils peuvent collecter des données à partir de diverses sources en ligne sans être bloqués ou restreints.
Caractéristiques d'Oxylabs MCP
- Réseau de Proxies Étendu : Oxylabs MCP dispose d'un vaste réseau de plus de 100 millions d'IP résidentielles et de proxies de centres de données, permettant aux utilisateurs d'accéder à du contenu géo-ciblé et de contourner les restrictions.
- Haute Anonymat : Le service garantit l'anonymat de l'utilisateur, rendant difficile pour les sites web de détecter les activités de scraping, réduisant ainsi le risque de bans d'IP.
- Tableau de Bord Convivial : Le tableau de bord intuitif permet aux utilisateurs de gérer facilement leurs paramètres de proxy, leurs statistiques d'utilisation et leurs informations de facturation.
- Plans de Tarification Flexibles : Oxylabs propose divers plans de tarification pour répondre à différents besoins, que ce soit pour de petits projets ou de grandes opérations de scraping de données.
- Support Client 24/7 : Les utilisateurs ont accès à un support disponible 24 heures sur 24 pour les aider avec tout problème ou question concernant le service.
Comment Utiliser Oxylabs MCP
- Inscription : Créez un compte sur le site web d'Oxylabs pour accéder au service MCP.
- Choisissez un Plan : Sélectionnez un plan de tarification qui correspond à vos besoins en matière de scraping de données.
- Configurez Vos Proxies : Utilisez le tableau de bord pour configurer vos paramètres de proxy, y compris la sélection du type de proxies dont vous avez besoin (résidentiels ou de centres de données).
- Intégrez avec Votre Application : Utilisez l'API fournie ou les outils d'intégration pour connecter Oxylabs MCP avec votre application de scraping web.
- Commencez à Scraper : Commencez votre processus de collecte de données, en veillant à surveiller l'utilisation et les performances via le tableau de bord.
Questions Fréquemment Posées
Q : Quels types de proxies propose Oxylabs MCP ?
R : Oxylabs MCP fournit à la fois des proxies résidentiels et des proxies de centres de données, permettant aux utilisateurs de choisir en fonction de leurs besoins spécifiques en matière de scraping.
Q : Y a-t-il une limite à la quantité de données que je peux scraper ?
R : Les limites dépendent du plan de tarification que vous sélectionnez. Chaque plan a sa propre allocation de données, il est donc essentiel de choisir celui qui correspond à vos besoins de scraping.
Q : Puis-je utiliser Oxylabs MCP à des fins de SEO ?
R : Oui, de nombreux utilisateurs exploitent Oxylabs MCP pour des tâches SEO telles que le suivi de classement, l'analyse de la concurrence et la recherche de marché, grâce à sa capacité à accéder à des données localisées.
Q : Que se passe-t-il si mon IP est bloquée ?
R : Oxylabs MCP est conçu pour minimiser le risque de bans d'IP grâce à sa fonctionnalité de proxy rotatif, qui change automatiquement votre adresse IP à intervalles réguliers ou après chaque requête.
Q : Comment contacter le support client ?
R : Vous pouvez contacter le support client d'Oxylabs via le formulaire de contact sur leur site web ou par le biais de la fonction de chat en direct disponible dans le tableau de bord.
Détail
📖 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
- Automatically clean and convert HTML to Markdown for improved readability
- Use automated parsers for popular targets like Google, Amazon, and etc.
- 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
- Set rendering and parsing options if needed
- Feed data directly into AI models or analytics tools
- Works on macOS, Windows, and Linux
- Comprehensive error handling and reporting
- Smart rate limiting and request management
🛠️ MCP Tools
Oxylabs MCP provides the following tools:
- universal_scraper: Uses Oxylabs Web Scraper API for general website scraping.
- google_search_scraper: Uses Oxylabs Web Scraper API to extract results from Google Search.
- amazon_search_scraper: Uses Oxylabs Web Scraper API to scrape Amazon search result pages.
- 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>- Go to https://smithery.ai/server/@oxylabs/oxylabs-mcp
- Login with GitHub
- Find the Install section
- 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>
- 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"
- 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>
- 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"
- 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"> <sub> Made with ☕ by <a href="https://oxylabs.io">Oxylabs</a>. Feel free to give us a ⭐ if MCP saved you a weekend. </sub> </div>Configuration du serveur
{
"mcpServers": {
"oxylabs-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--oxylabs--oxylabs-mcp--oxylabs-mcp",
"oxylabs-mcp"
],
"env": {
"OXYLABS_USERNAME": "oxylabs-username",
"OXYLABS_PASSWORD": "oxylabs-password"
}
}
}
}