Bright Data MCP Server

oficial

Descubra, extraia e interaja com a web - uma interface que alimenta o acesso automatizado em toda a internet pública.

Documentação

Bright Data Logo

The Web MCP

🌐 Dê à sua IA superpoderes da web em tempo real
Conecte LLMs à web ao vivo sem bloqueios

npm version npm downloads License

Início RápidoRecursosPreçosDemonstraçõesDocumentaçãoSuporte

🎉 Plano Gratuito Disponível! 🎉

5.000 créditos/mês GRÁTIS
Sem cartão de crédito · Renovação automática mensal · Perfeito para prototipagem e fluxos de trabalho diários com IA


NOVO: Grupo de Ferramentas Code - O Melhor Amigo do Seu Agente de Codificação

Acesso instantâneo a dados de pacotes npm e PyPI, direto do seu agente de IA.

Precisa da versão mais recente de um pacote? Quer ler seu README sem sair do seu fluxo de trabalho?
O grupo de ferramentas Code fornece aos agentes de codificação metadados de pacotes estruturados e confiáveis sob demanda —
sem raspagem, sem caches desatualizados, apenas os dados que seu agente precisa para tomar decisões inteligentes sobre dependências.

npm
Versões de pacotes, READMEs, metadados e dependências
PyPI
Informações de pacotes Python, versões e detalhes do projeto

GROUPS="code"  ·  A ferramenta ideal para Claude Code, Cursor, Windsurf e qualquer agente de codificação compatível com MCP

Ferramentas de Visibilidade de Marca GEO & IA

Veja como o ChatGPT, Grok e Perplexity falam sobre sua marca.

Consulte os principais LLMs diretamente do seu agente e receba respostas estruturadas em formato markdown.
O ciclo de feedback definitivo para Otimização para Mecanismos Generativos (GEO) — monitore recomendações geradas por IA, rastreie menções de marca em LLMs e entenda como a IA percebe seus produtos.

ChatGPT
Insights gerados por IA, citações e recomendações
Grok
Análise de IA em tempo real com dados do X
Perplexity
Respostas de IA com busca aumentada e fontes

GROUPS="geo"  ·  Funciona com qualquer agente compatível com MCP


🌟 Visão Geral

The Web MCP é sua porta de entrada para dar aos assistentes de IA verdadeiras capacidades web. Chega de respostas desatualizadas, chega de "não consigo acessar informações em tempo real" - apenas acesso web contínuo e confiável que realmente funciona.

Criado pela Bright Data, a plataforma de dados web nº 1 do mundo, este servidor MCP garante que sua IA nunca seja bloqueada, sofra limite de taxa ou receba CAPTCHAs.

Funciona com Qualquer LLM
Claude, GPT, Gemini, Llama
🛡️ Nunca é Bloqueado
Desbloqueio de nível empresarial
🚀 5.000 Créditos Grátis
Mensal · Sem necessidade de cartão
Configuração Zero
Funciona imediatamente

🎯 Perfeito Para

  • 🔍 Pesquisa em Tempo Real - Obtenha preços atuais, notícias e dados ao vivo
  • 🛍️ Inteligência para E-commerce - Monitore produtos, preços e disponibilidade
  • 📊 Análise de Mercado - Acompanhe concorrentes e tendências do setor
  • 🤖 Agentes de IA - Crie agentes que podem realmente navegar na web
  • 💻 Agentes de Codificação - Consulte pacotes npm/PyPI, versões e READMEs em tempo real
  • 🧠 GEO & Visibilidade de Marca - Veja como ChatGPT, Grok e Perplexity percebem sua marca
  • 📝 Criação de Conteúdo - Acesse informações atualizadas para escrever
  • 🎓 Pesquisa Acadêmica - Colete dados de múltiplas fontes de forma eficiente

⚡ Início Rápido

Use o assistente de configuração:

GIF for day2

📡 Use nosso servidor hospedado - Sem necessidade de instalação!

Perfeito para usuários que querem configuração zero. Basta adicionar esta URL ao seu cliente MCP:

https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN_HERE

Configuração no Claude Desktop:

  1. Vá para: Configurações → Conectores → Adicionar conector personalizado
  2. Nome: Bright Data Web
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. Clique em "Adicionar" e pronto! ✨
Execute localmente na sua máquina
{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}

🚀 Preços e Modos

⚡ Modo Rápido (Plano gratuito)💎 Modo Pro🔧 Modo Personalizado

$0/mês

5.000 créditos


✅ Pesquisa na Web
✅ Raspagem com desbloqueador Web
✅ Pesquisa Discover com ranqueamento IA
❌ Automação de Navegador
❌ Ferramentas de dados web


Modo Padrão

Pague conforme o uso

Tudo do rápido mais 60+ ferramentas


✅ Controle de Navegador
✅ APIs de Dados Web



PRO_MODE=true

Baseado no uso

Escolha as ferramentas que precisa


✅ Combine grupos de ferramentas
✅ Adicione ferramentas individuais
❌ Substitui a elegibilidade Pro


GROUPS="browser"
TOOLS="scrape_as_html"

💡 Como funciona o plano gratuito: Sua conta recebe 5.000 créditos/mês (~$7,50 em valor), renovados automaticamente no dia 1º sem necessidade de cartão de crédito. As requisições MCP consomem deste pool compartilhado — ferramentas base (search_engine, scrape_as_markdown, discover) custam 1 crédito por requisição, enquanto ferramentas web_data_* custam 1 crédito por registro retornado. Créditos não utilizados não acumulam, e quando acabam as requisições param (sem cobranças surpresa a menos que você tenha depositado fundos). O modo Pro não está incluído no plano gratuito e incorre em cobranças adicionais baseadas no uso.


🧠 Seleção Avançada de Ferramentas

  • GROUPS permite habilitar pacotes de ferramentas selecionados. Use IDs de grupo separados por vírgula, como ecommerce,browser.
  • TOOLS adiciona nomes de ferramentas explícitos além dos grupos selecionados.
  • Prioridade de modo: PRO_MODE=true (todas as ferramentas) → GROUPS / TOOLS (lista de permissões) → modo rápido padrão (kit de ferramentas base).
  • Ferramentas base sempre habilitadas: search_engine, search_engine_batch, scrape_as_markdown, scrape_batch, discover.
  • ID de grupo custom é reservado; use TOOLS para escolhas personalizadas.
ID do GrupoDescriçãoFerramentas em destaque
ecommerceConjuntos de dados de varejo e marketplaceweb_data_amazon_product, web_data_walmart_product, web_data_google_shopping
socialInsights sociais, de comunidade e de criadoresweb_data_linkedin_posts, web_data_tiktok_posts, web_data_youtube_videos
browserFerramentas de automação do Bright Data Scraping Browserscraping_browser_snapshot, scraping_browser_click_ref, scraping_browser_screenshot
financeConjuntos de dados de inteligência financeiraweb_data_yahoo_finance_business
businessConjuntos de dados de inteligência empresarial e de localizaçãoweb_data_crunchbase_company, web_data_zoominfo_company_profile, web_data_zillow_properties_listing
researchFeeds de dados de notícias e para desenvolvedoresweb_data_github_repository_file, web_data_reuter_news
app_storesDados de lojas de aplicativosweb_data_google_play_store, web_data_apple_app_store
travelInformações de viagemweb_data_booking_hotel_listings
geoVisibilidade de marca GEO & LLMweb_data_chatgpt_ai_insights, web_data_grok_ai_insights, web_data_perplexity_ai_insights
codeInteligência de pacotes para agentes de codificaçãoweb_data_npm_package, web_data_pypi_package
advanced_scrapingAuxiliares de extração em lote e assistida por IAsearch_engine_batch, scrape_batch, extract

Exemplo para Claude Desktop

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>",
        "GROUPS": "browser,advanced_scraping",
        "TOOLS": "extract"
      }
    }
  }
}

Exemplo para agente de codificação (Claude Code / Cursor / Windsurf)

Forneça ao seu agente de codificação inteligência de pacotes em tempo real — últimas versões, READMEs, dependências e metadados do npm e PyPI sem fazer scraping:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>",
        "GROUPS": "code"
      }
    }
  }
}

✨ Funcionalidades

🔥 Capacidades Principais

🔍 Busca Web Inteligente
Resultados com qualidade Google otimizados para IA
📄 Markdown Limpo
Extração de conteúdo pronta para IA
🌍 Acesso Global
Contorne restrições geográficas automaticamente
🛡️ Proteção Anti-Bot
Nunca seja bloqueado ou sofra limite de taxa
🤖 Automação de Navegador
Controle navegadores reais remotamente (Pro)
Ultrarrápido
Otimizado para latência mínima

🎯 Exemplos de Consultas que Simplesmente Funcionam

✅ "What's Tesla's current stock price?"
✅ "Find the best-rated restaurants in Tokyo right now"
✅ "Get today's weather forecast for New York"
✅ "What movies are releasing this week?"
✅ "What are the trending topics on Twitter today?"
✅ "What's the latest version of express on npm?"
✅ "Get the README for the langchain-brightdata PyPI package"

🎬 Demonstrações

Nota: Estes vídeos mostram versões anteriores. Novas demonstrações em breve! 🎥

Ver Vídeos de Demonstração

Demonstração de Busca Web Básica

https://github.com/user-attachments/assets/59f6ebba-801a-49ab-8278-1b2120912e33

Demonstração de Scraping Avançado

https://github.com/user-attachments/assets/61ab0bee-fdfa-4d50-b0de-5fab96b4b91d

📺 Mais tutoriais no YouTube →


🔧 Ferramentas Disponíveis

⚡ Ferramentas do Modo Rápido (Padrão - Grátis)

FerramentaDescriçãoCaso de Uso
🔍 search_engineBusca web com resultados otimizados para IAPesquisa, verificação de fatos, eventos atuais
📄 scrape_as_markdownConverte qualquer página web em markdown limpoExtração de conteúdo, documentação
🎯 discoverBusca web com ranqueamento por IA e pontuação de relevância baseada em intençãoPesquisa aprofundada, pipelines RAG, análise competitiva

💎 Ferramentas do Modo Pro (Mais de 60 Ferramentas)

Clique para ver todas as ferramentas Pro
CategoriaFerramentasDescrição
Controle de Navegadorscraping_browser.*Automação completa de navegador
APIs de Dados Webweb_data_*Extração de dados estruturados
E-commerceScrapers de produtosDados da Amazon, eBay, Walmart
Redes SociaisScrapers sociaisTwitter, LinkedIn, Instagram
Mapas & LocalFerramentas de localizaçãoGoogle Maps, dados de negócios

📚 Ver documentação completa de ferramentas →


🎮 Experimente Agora!

🧪 Playground Online

Experimente o Web MCP sem nenhuma configuração:


🔧 Configuração

Configuração Básica

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "your-token-here"
      }
    }
  }
}

Configuração Avançada

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "your-token-here",
        "PRO_MODE": "true",              // Enable all 60+ tools
        "RATE_LIMIT": "100/1h",          // Custom rate limiting
        "WEB_UNLOCKER_ZONE": "custom",   // Custom unlocker zone
        "BROWSER_ZONE": "custom_browser", // Custom browser zone
        "POLLING_TIMEOUT": "600"         // Polling timeout in seconds (default: 600)
      }
    }
  }
}

Variáveis de Ambiente

VariávelDescriçãoPadrãoExemplo
API_TOKENSeu token de API Bright Data (obrigatório)-your-token-here
PRO_MODEHabilita todas as mais de 60 ferramentasfalsetrue
RATE_LIMITLimite de taxa personalizadoilimitado100/1h, 50/30m
WEB_UNLOCKER_ZONENome da zona Web Unlocker personalizadamcp_unlockermy_custom_zone
BROWSER_ZONENome da zona Browser personalizadamcp_browsermy_browser_zone
POLLING_TIMEOUTTempo limite para consulta das ferramentas web_data_* (segundos)600300, 1200
BASE_TIMEOUTTempo limite de requisição para ferramentas base em segundos (busca & scrape)Sem limite60, 120
BASE_MAX_RETRIESMáximo de tentativas para ferramentas base em erros transitórios (0-3)01, 3
GROUPSIDs de grupos de ferramentas separados por vírgula-ecommerce,browser
TOOLSNomes de ferramentas individuais separados por vírgula-extract,scrape_as_html

Notas:

  • POLLING_TIMEOUT controla por quanto tempo as ferramentas web_data_* aguardam pelos resultados. Cada segundo = 1 tentativa de consulta.
  • Valores mais baixos (ex.: 300) falharão mais rápido em coletas de dados lentas.
  • Valores mais altos (ex.: 1200) permitem mais tempo para tarefas de scraping complexas.

📚 Documentação


🚨 Problemas Comuns & Soluções

🔧 Guia de Solução de Problemas

❌ Erro "spawn npx ENOENT"

Solução: Instale o Node.js ou use o caminho completo para o node:

"command": "/usr/local/bin/node"  // macOS/Linux
"command": "C:\\Program Files\\nodejs\\node.exe"  // Windows

⏱️ Tempos Limite em Sites Complexos

Solução: Aumente o tempo limite nas configurações do seu cliente para 180s

🔑 Problemas de Autenticação

Solução: Certifique-se de que seu token de API é válido e tem as permissões adequadas

📡 Conexão com Servidor Remoto

Solução: Verifique sua conexão com a internet e configurações de firewall

Mais solução de problemas →


🤝 Contribuindo

Adoramos contribuições! Veja como você pode ajudar:

Por favor, siga os padrões de codificação da Bright Data.


📞 Suporte


📜 Licença

MIT © Bright Data Ltd.


Construído com ❤️ por
Bright Data

A plataforma de dados web nº 1 do mundo


⭐ Dê uma estrela no GitHubLeia nosso Blog