Oxylabs MCP Server

officiel

Scrapez des sites web avec l'API Web Oxylabs, prenant en charge le rendu dynamique et l'analyse pour l'extraction de données structurées.

GitHub

100

Documentation

Oxylabs + MCP

Serveur MCP Oxylabs

Le chaînon manquant entre les modèles d’IA et le web réel : une API unique qui fournit des données propres et structurées depuis n’importe quel site.

📖 Aperçu

Le serveur MCP Oxylabs crée un pont entre les modèles d’IA et le web. Il leur permet de scraper n’importe quelle URL, d’afficher des pages riches en JavaScript, d’extraire et de formater du contenu pour l’IA, de gérer les CAPTCHA et d’accéder à des données web géo-restreintes depuis plus de 195 pays.

🛠️ Outils MCP

Oxylabs MCP propose deux ensembles d’outils, utilisables ensemble ou indépendamment :

Outils de l’API Web Scraper Oxylabs

universal_scraper : utilise l’API Web Scraper Oxylabs pour le scraping général de sites web ;
google_search_scraper : utilise l’API Web Scraper Oxylabs pour extraire les résultats de Google Search ;
amazon_search_scraper : utilise l’API Web Scraper Oxylabs pour scraper les pages de résultats de recherche Amazon ;
amazon_product_scraper : utilise l’API Web Scraper Oxylabs pour extraire les données des pages produits Amazon individuelles.

Outils Oxylabs AI Studio

ai_scraper : scrape le contenu de n’importe quelle URL au format JSON ou Markdown avec une extraction de données pilotée par l’IA ;
ai_crawler : à partir d’un prompt, explore un site web et collecte des données au format Markdown ou JSON sur plusieurs pages ;
ai_browser_agent : à partir d’un prompt, contrôle un navigateur et renvoie des données aux formats Markdown, JSON, HTML ou capture d’écran ;
ai_search : recherche sur le web des URLs et leur contenu avec une extraction de contenu pilotée par l’IA.

✅ Prérequis

Avant de commencer, assurez-vous de disposer d’au moins un des éléments suivants :

Compte API Web Scraper Oxylabs : obtenez votre nom d’utilisateur et votre mot de passe auprès d’Oxylabs (essai gratuit d’une semaine disponible) ;
Clé API Oxylabs AI Studio : obtenez votre clé API auprès d’Oxylabs AI Studio (1000 crédits gratuits).

📦 Configuration

Variables d’environnement

Le serveur MCP Oxylabs prend en charge les variables d’environnement suivantes :

Nom	Description	Valeur par défaut
`OXYLABS_USERNAME`	Votre nom d’utilisateur API Web Scraper Oxylabs
`OXYLABS_PASSWORD`	Votre mot de passe API Web Scraper Oxylabs
`OXYLABS_AI_STUDIO_API_KEY`	Votre clé API Oxylabs AI Studio
`LOG_LEVEL`	Niveau de journalisation renvoyé au client	`INFO`

En fonction des identifiants fournis, le serveur exposera automatiquement les outils correspondants :

Si seuls OXYLABS_USERNAME et OXYLABS_PASSWORD sont fournis, le serveur exposera les outils de l’API Web Scraper ;
Si seule OXYLABS_AI_STUDIO_API_KEY est fournie, le serveur exposera les outils AI Studio ;
Si à la fois OXYLABS_USERNAME et OXYLABS_PASSWORD et OXYLABS_AI_STUDIO_API_KEY sont fournis, le serveur exposera tous les outils.

❗❗❗ Remarque importante : si vous ne possédez pas d’identifiants API Web Scraper ou Oxylabs AI Studio, supprimez les espaces réservés des variables d’environnement correspondantes. Laisser des valeurs d’espace réservé entraînera l’exposition d’outils qui ne fonctionnent pas.

Configurer avec uvx

Installez le gestionnaire de paquets uvx :

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

OU :

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Utilisez la configuration suivante :

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

Configurer avec uv

Installez le gestionnaire de paquets uv :

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

OU :

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Utilisez la configuration suivante :

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

Configurer avec Smithery Oauth2

Allez sur https://smithery.ai/server/@oxylabs/oxylabs-mcp;
Cliquez sur Auto pour installer la configuration MCP Oxylabs pour le client concerné ;
OU utilisez la configuration suivante :

  {
    "mcpServers": {
      "oxylabs": {
        "url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp"
      }
    }
  }

Suivez les instructions pour authentifier Oxylabs MCP avec le flux Oauth2

Configurer avec les paramètres de requête Smithery

Si votre client ne prend pas en charge l’authentification Oauth2, vous pouvez passer les paramètres d’authentification Oxylabs directement dans l’URL

  {
    "mcpServers": {
      "oxylabs": {
        "url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp?oxylabsUsername=OXYLABS_USERNAME&oxylabsPassword=OXYLABS_PASSWORD&oxylabsAiStudioApiKey=OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }

Configuration manuelle avec Claude Desktop

Accédez à Claude → Paramètres → Développeur → Modifier la configuration et ajoutez l’une des configurations ci-dessus au fichier claude_desktop_config.json.

Configuration manuelle avec Cursor AI

Accédez à Cursor → Paramètres → Paramètres Cursor → MCP. Cliquez sur Ajouter un nouveau serveur MCP global et ajoutez l’une des configurations ci-dessus.

📝 Journalisation

Le serveur fournit des informations supplémentaires sur les appels d’outils dans les événements 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"
  }
}

🛡️ Licence

Distribué sous licence MIT – voir LICENSE pour plus de détails.

À propos d’Oxylabs

Fondée en 2015, Oxylabs est une plateforme leader de collecte de renseignements web, animée par les plus hauts standards d’éthique, de conformité et d’excellence commerciale, permettant aux entreprises du monde entier de débloquer des insights basés sur les données.

_{Fait avec ☕ par Oxylabs. N’hésitez pas à nous donner une ⭐ si MCP vous a fait gagner un week-end.}

✨ Fonctionnalités clés

Scraper le contenu de n’importe quel site

Extraire des données depuis n’importe quelle URL, y compris les applications monopages complexes
Afficher entièrement les sites web dynamiques grâce à la prise en charge d’un navigateur headless
Choisir le rendu JavaScript complet, HTML uniquement ou aucun
Émuler des fenêtres d’affichage mobiles et bureau pour un rendu réaliste

Obtenir automatiquement des données prêtes pour l’IA

Nettoyer et convertir automatiquement le HTML en Markdown pour une meilleure lisibilité
Utiliser des analyseurs automatisés pour des cibles populaires comme Google, Amazon, et plus encore

Gérer les CAPTCHA et les géo-restrictions

Naviguer dans les systèmes sophistiqués de gestion des requêtes automatisées avec un taux de réussite élevé
Scraper de manière fiable même les sites web les plus complexes
Obtenir des IP à rotation automatique depuis un pool de proxies couvrant plus de 195 pays

Configuration flexible et prise en charge multiplateforme

Définir les options de rendu et d’analyse si nécessaire
Alimenter directement les modèles d’IA ou les outils d’analyse
Fonctionne sur macOS, Windows et Linux

Gestion intégrée des erreurs et des requêtes

Gestion complète des erreurs et rapports
Limitation intelligente du débit et gestion des requêtes

Pourquoi Oxylabs MCP ? 🕸️ ➜ 📦 ➜ 🤖

Imaginez dire à votre LLM « Résume la dernière discussion Hacker News à propos de GPT‑5 » – et qu’il réponde simplement.
MCP (Multi‑Client Proxy) rend cela possible en s’occupant des tâches fastidieuses pour vous :

Ce que fait Oxylabs MCP	Pourquoi c’est important pour vous
Gère les murs de requêtes automatisées avec le réseau proxy mondial Oxylabs	Permet l’accès aux sites web et l’anonymat
Exécute JavaScript dans Chrome headless	Applications monopages, réglées
Nettoie HTML → JSON	Intégration directe dans les bases vectorielles ou les prompts
Analyseurs structurés optionnels (Google, Amazon, etc.)	Accès en une ligne aux cibles populaires

mcp-name: io.oxylabs/oxylabs-mcp