Oxylabs MCP Server

oficial

Extraia dados de sites com a Oxylabs Web API, com suporte a renderização dinâmica e parsing para extração estruturada de dados.

GitHub

100

Documentação

Oxylabs + MCP

Servidor MCP Oxylabs

O elo perdido entre modelos de IA e a web do mundo real: uma API que entrega dados limpos e estruturados de qualquer site.

📖 Visão Geral

O servidor MCP Oxylabs fornece uma ponte entre modelos de IA e a web. Ele permite que eles façam scraping de qualquer URL, renderizem páginas com muito JavaScript, extraiam e formatem conteúdo para uso de IA, gerenciem CAPTCHA e acessem dados web com restrição geográfica de mais de 195 países.

🛠️ Ferramentas MCP

O MCP Oxylabs fornece dois conjuntos de ferramentas que podem ser usados juntos ou independentemente:

Ferramentas da API Web Scraper Oxylabs

universal_scraper: Usa a API Web Scraper Oxylabs para scraping geral de sites;
google_search_scraper: Usa a API Web Scraper Oxylabs para extrair resultados da Pesquisa Google;
amazon_search_scraper: Usa a API Web Scraper Oxylabs para fazer scraping de páginas de resultados de busca da Amazon;
amazon_product_scraper: Usa a API Web Scraper Oxylabs para extrair dados de páginas de produtos individuais da Amazon.

Ferramentas do AI Studio Oxylabs

ai_scraper: Faz scraping de conteúdo de qualquer URL em formato JSON ou Markdown com extração de dados alimentada por IA;
ai_crawler: Com base em um prompt, rastreia um site e coleta dados em formato Markdown ou JSON em várias páginas;
ai_browser_agent: Com base em um prompt, controla um navegador e retorna dados em formatos Markdown, JSON, HTML ou captura de tela;
ai_search: Pesquisa na web por URLs e seus conteúdos com extração de conteúdo alimentada por IA.

✅ Pré-requisitos

Antes de começar, certifique-se de ter pelo menos um dos seguintes:

Conta da API Web Scraper Oxylabs: Obtenha seu nome de usuário e senha em Oxylabs (teste gratuito de 1 semana disponível);
Chave de API do AI Studio Oxylabs: Obtenha sua chave de API no AI Studio Oxylabs. (1000 créditos grátis).

📦 Configuração

Variáveis de ambiente

O servidor MCP Oxylabs suporta as seguintes variáveis de ambiente:

Nome	Descrição	Padrão
`OXYLABS_USERNAME`	Seu nome de usuário da API Web Scraper Oxylabs
`OXYLABS_PASSWORD`	Sua senha da API Web Scraper Oxylabs
`OXYLABS_AI_STUDIO_API_KEY`	Sua chave de API do AI Studio Oxylabs
`LOG_LEVEL`	Nível de log para os logs retornados ao cliente	`INFO`

Com base nas credenciais fornecidas, o servidor exporá automaticamente as ferramentas correspondentes:

Se apenas OXYLABS_USERNAME e OXYLABS_PASSWORD forem fornecidos, o servidor exporá as ferramentas da API Web Scraper;
Se apenas OXYLABS_AI_STUDIO_API_KEY for fornecida, o servidor exporá as ferramentas do AI Studio;
Se ambos OXYLABS_USERNAME e OXYLABS_PASSWORD e OXYLABS_AI_STUDIO_API_KEY forem fornecidos, o servidor exporá todas as ferramentas.

❗❗❗ Nota importante: se você não tiver credenciais da API Web Scraper ou do AI Studio Oxylabs, exclua os espaços reservados das variáveis de ambiente correspondentes. Deixar valores de espaço reservado resultará em ferramentas expostas que não funcionam.

Configurar com uvx

Instale o gerenciador de pacotes 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"

Use a seguinte configuração:

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

Configurar com uv

Instale o gerenciador de pacotes 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"

Use a seguinte configuração:

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

Configurar com Smithery Oauth2

Vá para https://smithery.ai/server/@oxylabs/oxylabs-mcp;
Clique em Auto para instalar a configuração MCP Oxylabs para o respectivo cliente;
OU use a seguinte configuração:

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

Siga as instruções para autenticar o MCP Oxylabs com o fluxo Oauth2

Configurar com parâmetros de consulta Smithery

Caso seu cliente não suporte a autenticação Oauth2, você pode passar os parâmetros de autenticação Oxylabs diretamente na url

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

Configuração Manual com Claude Desktop

Navegue até Claude → Configurações → Desenvolvedor → Editar Config e adicione uma das configurações acima ao arquivo claude_desktop_config.json.

Configuração Manual com Cursor AI

Navegue até Cursor → Configurações → Configurações do Cursor → MCP. Clique em Adicionar novo servidor MCP global e adicione uma das configurações acima.

📝 Logging

O servidor fornece informações adicionais sobre as chamadas de ferramentas em eventos 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"
  }
}

🛡️ Licença

Distribuído sob a Licença MIT – veja LICENSE para detalhes.

Sobre a Oxylabs

Fundada em 2015, a Oxylabs é uma plataforma líder de mercado em coleta de inteligência web, orientada pelos mais altos padrões de negócios, ética e conformidade, permitindo que empresas em todo o mundo desbloqueiem insights orientados por dados.

_{Feito com ☕ pela Oxylabs. Sinta-se à vontade para nos dar uma ⭐ se o MCP te poupou um fim de semana.}

✨ Principais Funcionalidades

Raspe conteúdo de qualquer site

Extraia dados de qualquer URL, incluindo aplicações de página única complexas
Renderize totalmente sites dinâmicos usando suporte a navegador headless
Escolha renderização JavaScript completa, somente HTML ou nenhuma
Emule viewports de dispositivos móveis e desktop para renderização realista

Obtenha dados prontos para IA automaticamente

Limpe e converta automaticamente HTML para Markdown para melhor legibilidade
Use parsers automatizados para alvos populares como Google, Amazon e mais

Gerencie CAPTCHA e restrições geográficas

Navegue por sistemas sofisticados de gerenciamento de requisições automatizadas com alta taxa de sucesso
Raspe de forma confiável até mesmo os sites mais complexos
Obtenha IPs rotativos automaticamente de um pool de proxy cobrindo mais de 195 países

Configuração flexível e suporte multiplataforma

Defina opções de renderização e parsing se necessário
Alimente dados diretamente em modelos de IA ou ferramentas de análise
Funciona no macOS, Windows e Linux

Tratamento de erros e gerenciamento de requisições integrados

Tratamento e relatório de erros abrangentes
Limitação de taxa inteligente e gerenciamento de requisições

Por que Oxylabs MCP? 🕸️ ➜ 📦 ➜ 🤖

Imagine dizer ao seu LLM "Resuma a última discussão do Hacker News sobre GPT‑5" – e ele simplesmente responder. O MCP (Multi‑Client Proxy) torna isso possível fazendo as partes chatas para você:

O que o Oxylabs MCP faz	Por que isso importa para você
Gerencia barreiras de requisições automatizadas com a rede global de proxy Oxylabs	Permite acesso a sites e anonimato
Renderiza JavaScript em Chrome headless	Aplicações de página única, resolvidas
Limpa HTML → JSON	Insira diretamente em bancos de dados vetoriais ou prompts
Parsers estruturados opcionais (Google, Amazon, etc.)	Acesso de uma linha a alvos populares

mcp-name: io.oxylabs/oxylabs-mcp