Bright Data MCP Server
oficialDescubra, extraia e interaja com a web - uma interface que alimenta o acesso automatizado em toda a internet pública.
Documentação
The Web MCP
🌐 Dê à sua IA superpoderes da web em tempo real
Conecte LLMs à web ao vivo sem bloqueios
Início Rápido • Recursos • Preços • Demonstrações • Documentação • Suporte
🎉 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:
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:
- Vá para: Configurações → Conectores → Adicionar conector personalizado
- Nome:
Bright Data Web - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - Clique em "Adicionar" e pronto! ✨
{
"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ês5.000 créditos ✅ Pesquisa na Web Modo Padrão
|
Pague conforme o usoTudo do rápido mais 60+ ferramentas ✅ Controle de Navegador |
Baseado no usoEscolha as ferramentas que precisa ✅ Combine grupos de ferramentas 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 ferramentasweb_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
GROUPSpermite habilitar pacotes de ferramentas selecionados. Use IDs de grupo separados por vírgula, comoecommerce,browser.TOOLSadiciona 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; useTOOLSpara escolhas personalizadas.
| ID do Grupo | Descrição | Ferramentas em destaque |
|---|---|---|
ecommerce | Conjuntos de dados de varejo e marketplace | web_data_amazon_product,
web_data_walmart_product,
web_data_google_shopping |
social | Insights sociais, de comunidade e de criadores | web_data_linkedin_posts,
web_data_tiktok_posts,
web_data_youtube_videos |
browser | Ferramentas de automação do Bright Data Scraping Browser | scraping_browser_snapshot,
scraping_browser_click_ref,
scraping_browser_screenshot |
finance | Conjuntos de dados de inteligência financeira | web_data_yahoo_finance_business |
business | Conjuntos de dados de inteligência empresarial e de localização | web_data_crunchbase_company,
web_data_zoominfo_company_profile,
web_data_zillow_properties_listing |
research | Feeds de dados de notícias e para desenvolvedores | web_data_github_repository_file,
web_data_reuter_news |
app_stores | Dados de lojas de aplicativos | web_data_google_play_store,
web_data_apple_app_store |
travel | Informações de viagem | web_data_booking_hotel_listings |
geo | Visibilidade de marca GEO & LLM | web_data_chatgpt_ai_insights,
web_data_grok_ai_insights,
web_data_perplexity_ai_insights |
code | Inteligência de pacotes para agentes de codificação | web_data_npm_package,
web_data_pypi_package |
advanced_scraping | Auxiliares de extração em lote e assistida por IA | search_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
🔧 Ferramentas Disponíveis
⚡ Ferramentas do Modo Rápido (Padrão - Grátis)
| Ferramenta | Descrição | Caso de Uso |
|---|---|---|
🔍 search_engine | Busca web com resultados otimizados para IA | Pesquisa, verificação de fatos, eventos atuais |
📄 scrape_as_markdown | Converte qualquer página web em markdown limpo | Extração de conteúdo, documentação |
🎯 discover | Busca web com ranqueamento por IA e pontuação de relevância baseada em intenção | Pesquisa aprofundada, pipelines RAG, análise competitiva |
💎 Ferramentas do Modo Pro (Mais de 60 Ferramentas)
Clique para ver todas as ferramentas Pro
| Categoria | Ferramentas | Descrição |
|---|---|---|
| Controle de Navegador | scraping_browser.* | Automação completa de navegador |
| APIs de Dados Web | web_data_* | Extração de dados estruturados |
| E-commerce | Scrapers de produtos | Dados da Amazon, eBay, Walmart |
| Redes Sociais | Scrapers sociais | Twitter, LinkedIn, Instagram |
| Mapas & Local | Ferramentas de localização | Google Maps, dados de negócios |
🎮 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ável | Descrição | Padrão | Exemplo |
|---|---|---|---|
API_TOKEN | Seu token de API Bright Data (obrigatório) | - | your-token-here |
PRO_MODE | Habilita todas as mais de 60 ferramentas | false | true |
RATE_LIMIT | Limite de taxa personalizado | ilimitado | 100/1h, 50/30m |
WEB_UNLOCKER_ZONE | Nome da zona Web Unlocker personalizada | mcp_unlocker | my_custom_zone |
BROWSER_ZONE | Nome da zona Browser personalizada | mcp_browser | my_browser_zone |
POLLING_TIMEOUT | Tempo limite para consulta das ferramentas web_data_* (segundos) | 600 | 300, 1200 |
BASE_TIMEOUT | Tempo limite de requisição para ferramentas base em segundos (busca & scrape) | Sem limite | 60, 120 |
BASE_MAX_RETRIES | Máximo de tentativas para ferramentas base em erros transitórios (0-3) | 0 | 1, 3 |
GROUPS | IDs de grupos de ferramentas separados por vírgula | - | ecommerce,browser |
TOOLS | Nomes de ferramentas individuais separados por vírgula | - | extract,scrape_as_html |
Notas:
POLLING_TIMEOUTcontrola 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
🤝 Contribuindo
Adoramos contribuições! Veja como você pode ajudar:
- 🐛 Reportar bugs
- 💡 Sugerir funcionalidades
- 🔧 Enviar PRs
- ⭐ Dê uma estrela neste repositório!
Por favor, siga os padrões de codificação da Bright Data.
📞 Suporte
|
🐛 GitHub Issues Reporte bugs & funcionalidades |
📚 Documentação Guias completos |
✉️ Email [email protected] |
📜 Licença
MIT © Bright Data Ltd.
A plataforma de dados web nº 1 do mundo