Bright Data

oficial

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

O que você pode fazer com Bright Data MCP?

  • Pesquisa na web — Peça ao seu assistente para fazer pesquisas no Bing ou no Google e retornar resultados estruturados com links, títulos e descrições.
  • Raspagem de páginas — Busque qualquer URL como Markdown, texto, HTML ou ld_json limpo, com detecção de bots e tratamento de CAPTCHA integrados.
  • Dados estruturados de plataformas — Encontre e execute scrapers pré-criados para sites como Amazon, LinkedIn, TikTok e npm para obter JSON limpo em vez de analisar HTML.
  • Automação de navegador — Navegue, clique, digite, role e capture telas em uma sessão remota do navegador para sites interativos ou protegidos por login.
  • Coleta de respostas de LLMs — Envie prompts ao ChatGPT ou ao Perplexity e receba as respostas para comparar como cada um descreve uma marca.
  • Coleta em lote — Faça até 5 pesquisas ou raspe até 5 URLs em uma única chamada para coletar dados em paralelo.

Documentação

Bright Data Logo

Bright Data MCP

Pesquisa na web, extração de páginas, extração de dados estruturados e automação de navegador para agentes de IA e LLMs por meio do Model Context Protocol.

Compatível com agentes de IA, agentes de programação, assistentes de chat e qualquer cliente compatível com MCP.

npm version npm downloads License

Início rápido • Preços • Casos de uso • Ferramentas • Habilidades de agente • Documentação • Suporte

Plano gratuito: 5.000 solicitações por mês. Não é necessário cartão de crédito. Renovação mensal.


Visão geral

O servidor MCP da Bright Data oferece aos agentes de IA acesso em tempo real a dados públicos da web. Ele disponibiliza 30 ferramentas que abrangem:

  • Pesquisa na web — resultados do Bing e do Google como dados estruturados
  • Extração de páginas — qualquer URL como Markdown ou HTML, com detecção de bots, resolução de CAPTCHA e rotação de proxy tratadas automaticamente em cada solicitação
  • Dados estruturados (Web Scraper API) — JSON limpo de mais de 1.200 scrapers pré-configurados: Amazon, LinkedIn, Instagram, TikTok, YouTube, X, Reddit, Facebook, Crunchbase, Zillow, npm, PyPI e muito mais, sem analisar HTML. Seis ferramentas permitem encontrar e executar qualquer um deles
  • Automação de navegador — navegar, clicar, digitar, fazer capturas de tela e ler páginas em uma sessão de navegador remota
  • Coleta de respostas de LLMs — enviar prompts ao ChatGPT e ao Perplexity e receber as respostas como dados estruturados

Todas as solicitações passam pela infraestrutura de desbloqueio da Bright Data, para que páginas que bloqueiam clientes HTTP comuns (detecção de bots, CAPTCHAs, limites de taxa, restrições geográficas) sejam acessadas normalmente. Não é necessário configurar proxies, manter navegadores headless nem escrever lógica de repetição.

Duas opções de implantação: um servidor remoto hospedado (uma URL, sem instalação) ou uma instância local via npx @brightdata/mcp.


Início rápido

Servidor hospedado — sem instalação. Adicione esta URL ao seu cliente MCP:

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

Obtenha seu token de API nas configurações da sua conta Bright Data. Novas contas recebem 5.000 solicitações gratuitas por mês.

Parâmetros de URL opcionais:

ParâmetroDescriçãoExemplo
groups=<ids>Limita a grupos específicos de ferramentas (padrão: todas as ferramentas)...&groups=scrapers,browser
tools=<names>Limita a ferramentas específicas...&tools=search_engine,scrape_as_markdown
Claude Desktop
  1. Acesse: Settings → Connectors → Add custom connector
  2. Nome: Bright Data
  3. URL: https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN
  4. Clique em "Add"

Ou execute localmente:

{
  "mcpServers": {
    "Bright Data": {
      "command": "npx",
      "args": ["@brightdata/mcp"],
      "env": {
        "API_TOKEN": "<your-api-token-here>"
      }
    }
  }
}
Claude Code
claude mcp add --transport http brightdata "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
Cursor

Adicione a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
VS Code

Adicione a .vscode/mcp.json:

{
  "servers": {
    "brightdata": {
      "type": "http",
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "brightdata": {
      "serverUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Gemini CLI

Adicione a ~/.gemini/settings.json:

{
  "mcpServers": {
    "brightdata": {
      "httpUrl": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Zed

Adicione às configurações do Zed:

{
  "context_servers": {
    "brightdata": {
      "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
    }
  }
}
Warp

Acesse Settings > MCP Servers > Add MCP Server e adicione:

{
  "brightdata": {
    "url": "https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN"
  }
}
Outros clientes (npx local)

Para qualquer cliente que ofereça suporte a servidores MCP locais:

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

Preços e plano gratuito

Todas as contas incluem um plano gratuito mensal recorrente. Não é necessário cartão de crédito nem compromisso para começar.

5.000 solicitações gratuitas por mês, com renovação no dia 1º de cada mês. As solicitações não utilizadas não são acumuladas. Em contas de equipe, o plano gratuito é compartilhado entre todos os usuários da conta.

O que está incluído gratuitamente:

  • Buscar qualquer página da web e extrair seu conteúdo como Markdown
  • Acesso a mais de 60 scrapers pré-configurados para domínios populares
  • Pesquisa na web (Bing, Google)
  • Desbloqueio da web (contorno da detecção de bots, resolução de CAPTCHA, rotação de proxy)
  • Automação de navegador
  • Segmentação geográfica

Além do plano gratuito — pague conforme o uso, sem compromisso:

Pesquisa, extração e coletaNavegação no navegador
Pague conforme o usoUS$ 1,50 / 1 mil resultadosUS$ 8 / GB
  • Quando as solicitações gratuitas se esgotam, as solicitações são interrompidas. Não há cobranças inesperadas — a menos que você tenha depositado fundos
  • Adicionar um cartão de crédito é apenas uma etapa de verificação; você não será cobrado, a menos que seu plano gratuito se esgote e você tenha fundos depositados
  • Defina um limite de gastos no painel de controle para que o uso pago nunca ultrapasse seu orçamento

Preços completos, planos por volume e opções empresariais →


Casos de uso

Pesquisa em tempo real

Responda a perguntas usando dados atuais da web em vez de dados de treinamento. Pesquise e, em seguida, leia as fontes.

TarefaFerramentas
Pesquisar informações atuais na websearch_engine, search_engine_batch
Ler uma página específica como Markdown limposcrape_as_markdown, scrape_batch

Exemplos de prompts: "Qual é o preço atual das ações da Tesla?", "Consulte a previsão do tempo de hoje para Nova York", "Encontre as fontes mais citadas sobre a regulamentação de IA da UE nos últimos 6 meses".

Inteligência de comércio eletrônico

Leia dados de produtos como JSON estruturado: preço, disponibilidade, avaliação, número de avaliações, vendedor e imagens.

TarefaFerramentas
Produtos, avaliações e resultados de pesquisa da Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara e outras lojassearch_scrapers → get_scraper_details → run_scraper
Comparação de preços entre varejistaso mesmo fluxo com o scraper do Google Shopping

Exemplos de prompts: "Compare o preço deste laptop na Amazon, Walmart e Best Buy", "Consulte a avaliação e o número de avaliações do ASIN B0D2Q9397Y", "Este produto está em estoque?".

Análise de mercado e concorrência

Crie perfis de concorrentes com dados atuais: financiamento, número de funcionários, contratações, avaliações de clientes e páginas de preços.

TarefaFerramentas
Financiamento, porte, funcionários e vagas da empresa (Crunchbase, ZoomInfo, LinkedIn)search_scrapers → run_scraper
Opinião dos clientes (Google Maps, Facebook, avaliações de lojas de aplicativos)search_scrapers → run_scraper
Páginas de preços dos concorrentesscrape_as_markdown, scrape_batch
Descoberta de mercadosearch_engine_batch

Exemplo de prompt: "Analise o Notion como concorrente: preços, financiamento, foco das contratações e reclamações dos clientes".

Agentes de IA com acesso confiável à web

Substitua as ferramentas integradas de busca e busca na web que são bloqueadas em sites protegidos. Todas as solicitações passam pela infraestrutura de desbloqueio, para que os agentes não falhem diante de detecção de bots, CAPTCHAs ou restrições geográficas.

TarefaFerramentas
Substituição direta da pesquisa na web integradasearch_engine
Substituição direta da busca integrada de URLsscrape_as_markdown
Coleta paralela de dados (5 por vez)search_engine_batch, scrape_batch
Sites interativos (barreiras de login, rolagem infinita, conteúdo dinâmico)scraping_browser_* (14 ferramentas)

Agentes de programação

Dados de registros de pacotes sob demanda — sem extração de dados nem caches desatualizados.

TarefaFerramentas
Versão, README e metadados de pacotes npm e PyPIrun_scraper com o scraper npmjs ou pypi (encontre-os com search_scrapers)
Ler arquivos de repositórios do GitHubrun_scraper com o scraper de repositórios do GitHub

Exemplos de prompts: "Qual é a versão mais recente do express no npm?", "Obtenha o README do pacote PyPI langchain-brightdata".

GEO e visibilidade da marca

Envie prompts aos principais LLMs e receba as respostas como dados estruturados. Avalie como os assistentes de IA descrevem sua marca, quais fontes citam e o que recomendam — o ciclo de feedback para otimização para mecanismos generativos (GEO).

TarefaFerramentas
Respostas do ChatGPT com citações e recomendaçõeschatgpt_ai_insights
Respostas do Perplexity com fontesperplexity_ai_insights

Exemplo de prompt: "Pergunte ao ChatGPT e ao Perplexity 'qual é o melhor provedor de proxy' e compare como cada um nos classifica".

Monitoramento de redes sociais

Dados estruturados de todas as principais plataformas: perfis, publicações, comentários e métricas de engajamento. Cada plataforma tem scrapers por tipo de dado (perfis do LinkedIn, reels do Instagram, comentários do TikTok, ...); encontre-os com search_scrapers e execute-os com run_scraper.

PlataformaExemplos de scrapers
LinkedInperfis de pessoas, perfis de empresas, vagas, publicações, pesquisa de pessoas
Instagramperfis, publicações, reels, comentários
TikTokperfis, publicações, loja, comentários
Facebookperfis, publicações, anúncios do marketplace, avaliações de empresas, eventos
YouTubevídeos, canais, comentários
X (Twitter)publicações, publicações por perfil
Redditpublicações, comentários

Exemplo de prompt: "Obtenha as últimas 10 publicações deste perfil do TikTok e resuma o engajamento".

Criação de conteúdo e pesquisa acadêmica

Reúna material de referência de várias páginas de uma só vez, filtrado por atualidade e relevância.

TarefaFerramentas
Coletar várias fontes em uma chamadascrape_batch (até 5 URLs)
Notícias e dados financeirossearch_engine com consultas de notícias, run_scraper com o scraper do Yahoo Finance

Comparação

RecursoBright Data MCPServidores MCP da web típicos
Total de ferramentas302–10
Extratores de JSON estruturado específicos por plataformaMais de 1.200 scrapers pré-configurados para comércio eletrônico, redes sociais, negócios, finanças, viagens e lojas de aplicativos, por meio de 6 ferramentasRaros; apenas extração genérica
Desbloqueio (contorno da detecção de bots, resolução de CAPTCHA, rotação de proxy)Integrado a todas as solicitaçõesGeralmente nenhum; bloqueados em sites protegidos
Mecanismos de pesquisaBing, GoogleGeralmente um
Automação de navegador14 ferramentas, navegador remoto, sem configuração localLimitada ou inexistente
Coleta de respostas de LLMs (ChatGPT, Perplexity)SimNão oferecida
Dados de registros de pacotes (npm, PyPI)SimNão oferecidos
Operações em lote10 pesquisas ou 10 extrações por chamadaGeralmente apenas uma solicitação
Segmentação geográficaSimLimitada ou inexistente
Plano gratuito5.000 solicitações/mês, automação de navegador incluída, sem cartão de créditoVaria; muitas vezes acesso sem chave com limite de taxa

Seleção de ferramentas: grupos

As ferramentas são organizadas em grupos para que você carregue apenas o que precisa. Menos ferramentas significam menos contexto para o agente processar.

  • Sem GROUPS ou TOOLS, todas as 30 ferramentas ficam habilitadas. Definir qualquer um deles limita o servidor apenas às ferramentas especificadas
  • GROUPS habilita conjuntos de ferramentas. Separe por vírgulas: GROUPS="scrapers,browser" (local) ou &groups=scrapers,browser (URL hospedada)
  • TOOLS adiciona ferramentas individuais: TOOLS="scrape_batch,session_stats". Usado sozinho, habilita apenas as ferramentas listadas
  • Cada grupo também inclui search_engine, scrape_as_markdown e ask_brightdata_assistant
  • O ID de grupo custom é reservado; use TOOLS para selecionar ferramentas individuais | ID do grupo | Conteúdo | Número de ferramentas | |----------|-----------|-----------| | scrapers | Pesquise e execute qualquer scraper pré-criado da Web Scraper API (Amazon, LinkedIn, TikTok, npm, ...) | 6 | | browser | Automação remota de navegador | 14 | | geo | Coleta de respostas do ChatGPT e do Perplexity | 2 | | advanced_scraping | Ferramentas em lote, estatísticas da sessão | 3 |

IDs de grupo mais antigos (ecommerce, social, business, finance, research, app_stores, travel, code) ainda funcionam e habilitam as ferramentas scrapers; social e business também adicionam search_dataset e list_dataset_fields. Nomes antigos de web_data_* em TOOLS também habilitam as ferramentas scrapers.

Exemplos de configuração

Servidor local com automação de navegador e ferramentas em lote:

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

Configuração de agente de programação (Claude Code / Cursor / Windsurf) — dados do npm, PyPI e GitHub por meio dos scrapers pré-criados:

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

Referência de ferramentas (30 ferramentas)

Qual ferramenta usar

  • URL conhecida, precisa do conteúdo: scrape_as_markdown. Várias URLs (até 5): scrape_batch
  • Precisa encontrar informações: search_engine. Várias consultas (até 5): search_engine_batch
  • Dados estruturados de uma plataforma conhecida (Amazon, LinkedIn, TikTok, npm, PyPI etc.): search_scrapers → get_scraper_details → run_scraper — retorna JSON limpo, mais rápido e confiável do que extrair os dados da mesma página
  • HTML bruto: scrape_as_markdown com format: 'html'
  • A página exige interação (clique, digitação, rolagem, login): ferramentas scraping_browser_*
  • Como o ChatGPT/Perplexity responde a uma solicitação: chatgpt_ai_insights / perplexity_ai_insights
  • Pergunta sobre a própria Bright Data (produtos, zonas, erros, configuração): ask_brightdata_assistant

Observações sobre execuções de scrapers:

  • Retornam JSON estruturado, com cobrança por registro retornado
  • Registros com um campo error explicam entradas que falharam, por exemplo, uma URL do tipo errado
  • Os resultados podem ser grandes. Mantenha limit_per_input baixo para métodos discover_by_* e execute a coleta em massa em um subagente, quando sua estrutura oferecer suporte, para que os registros não inundem a janela de contexto principal
  • Se uma execução falhar, scrape_as_markdown funciona na mesma URL como alternativa
Pesquisa e extração — 5 ferramentas
FerramentaDescriçãoGrupo
search_enginePesquise no Bing (padrão) ou no Google. Retorna JSON (link, título, descrição), 10 resultados por página. Parâmetros: country, page (a partir de 0), time_range (hour, day, week, month, year, any; o Bing oferece suporte apenas a day, week, year)padrão / todos os grupos
search_engine_batchAté 5 consultas de pesquisa em uma chamadapadrão / advanced_scraping
scrape_as_markdownQualquer URL. Retorna o conteúdo como Markdown (padrão), texto, HTML ou ld_jsonpadrão / todos os grupos
scrape_batchAté 5 URLs em uma chamada. Retorna o conteúdo como Markdown (padrão), texto, HTML ou ld_jsonpadrão / advanced_scraping
session_statsContagem de uso das ferramentas na sessão atualpadrão / advanced_scraping
Web Scraper API — 6 ferramentas

Pesquise e execute qualquer um dos mais de 1.200 scrapers pré-criados da Bright Data. A lista de scrapers é carregada de docs.brightdata.com/scrapers.json e atualizada diariamente. Disponível tanto no servidor hospedado quanto no local. Habilitada por padrão quando nenhuma ferramenta ou grupo é selecionado; caso contrário, adicione o grupo scrapers (&groups=scrapers na URL hospedada, GROUPS=scrapers localmente).

Fluxo típico: search_scrapers → get_scraper_details → run_scraper. As execuções são cobradas por registro; os métodos discover_by_* coletam até limit_per_input registros por entrada (padrão: 10).

FerramentaDescriçãoGrupo
search_scrapersEncontre scrapers por site ou tipo de dado (por exemplo, "avaliações da amazon", "linkedin.com"). Retorna o ID do conjunto de dados, nome, domínio e métodos de coletapadrão / scrapers
get_scraper_detailsDescrição, campos de entrada, exemplo de entrada e principais campos de saída de um método de scraperpadrão / scrapers
run_scraperExecute um método de scraper. Aguarda até 45 segundos; se ainda estiver em execução, retorna um snapshot_id para consultar mais tardepadrão / scrapers
get_scraper_progressStatus de uma execução: starting, running, ready, failed ou canceledpadrão / scrapers
get_scraper_resultsRegistros de uma execução concluídapadrão / scrapers
refresh_scrapersRecarregue a lista de scrapers agora, em vez de aguardar a atualização diáriapadrão / scrapers
Automação de navegador — 14 ferramentas

Sessão remota de navegador. Sequência típica: navegar → capturar instantâneo → interagir por referência → extrair ou fazer captura de tela.

FerramentaDescrição
scraping_browser_navigateAbra ou reutilize uma sessão de navegador e navegue até uma URL
scraping_browser_go_backVolte
scraping_browser_go_forwardAvance
scraping_browser_snapshotInstantâneo ARIA da página, listando elementos interativos com referências. Necessário antes de ações baseadas em referências
scraping_browser_click_refClique em um elemento pela referência do instantâneo mais recente
scraping_browser_type_refDigite em um elemento pela referência; opcionalmente, pressione Enter para enviar
scraping_browser_fill_formPreencha vários campos de formulário por referência em uma chamada
scraping_browser_screenshotCaptura de tela da página atual; full_page opcional
scraping_browser_get_textConteúdo textual do corpo da página
scraping_browser_get_htmlHTML da página atual
scraping_browser_scrollRole até o fim da página
scraping_browser_scroll_to_refRole até que um elemento fique visível
scraping_browser_wait_for_refAguarde até que um elemento fique visível, com tempo limite opcional
scraping_browser_network_requestsSolicitações de rede desde o carregamento da página: método, URL, status

As referências vêm do instantâneo mais recente. Se a página mudar após um clique ou uma navegação, capture um novo instantâneo antes da próxima ação baseada em referência. Para páginas estáticas, scrape_as_markdown é mais rápido e econômico do que uma sessão de navegador.

Visibilidade GEO e de LLM — 2 ferramentas
FerramentaEntradaRetorna
chatgpt_ai_insightsSolicitaçãoResposta do ChatGPT em Markdown
perplexity_ai_insightsSolicitaçãoResposta do Perplexity em Markdown

Use para otimização para mecanismos generativos (acompanhamento de como LLMs descrevem sua marca) e fluxos de trabalho de LLM como avaliador.

Pesquisa em conjuntos de dados — 2 ferramentas

Pesquisa filtrada em conjuntos de dados armazenados do LinkedIn; retorna os registros correspondentes de uma só vez, sem executar um scraper.

FerramentaDescriçãoGrupo
list_dataset_fieldsCampos filtráveis de um conjunto de dados (nome, tipo, descrição). Chame antes de search_datasetpadrão / social, business
search_datasetRegistros que correspondem a um filtro, até 10 por chamada, com um cursor para buscar maispadrão / social, business
Assistente da Bright Data — 1 ferramenta
FerramentaDescriçãoGrupo
ask_brightdata_assistantPergunte à Sophie, assistente de suporte da Bright Data, sobre produtos, APIs, zonas, erros ou configuração da conta. Passe o dialog_id retornado para fazer uma pergunta de acompanhamento na mesma conversapadrão / todos os grupos

Referência completa das ferramentas na documentação →


Skills de agente

Skills prontas para uso que ensinam seu agente a usar este servidor MCP corretamente. A coleção completa está em github.com/brightdata/skills — 21 skills que abrangem orquestração de MCP, inteligência competitiva, comparação de preços, monitoramento de marca, auditorias de SEO, criação de scrapers, pipelines de RAG e muito mais.

Três das skills de maior impacto:

SkillO que faz
bright-data-mcpDefine o Bright Data MCP como padrão para todas as operações de dados da Web, substituindo WebFetch, WebSearch e outras ferramentas Web integradas que falham na detecção de bots
competitive-intelInstantâneos de concorrentes, comparação de preços, análise de avaliações, sinais de contratação, análise de conteúdo/SEO e mapas do cenário de mercado com dados da Web em tempo real
price-comparisonLocaliza um produto na Amazon, Walmart, eBay, Best Buy e Google Shopping e indica a opção disponível em estoque mais barata

Explore todas as 21 skills →


Configuração

Configuração básica (local)

{
  "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",
        "RATE_LIMIT": "100/1h",
        "SERP_ZONE": "custom_serp",
        "BROWSER_ZONE": "custom_browser"
      }
    }
  }
}

Variáveis de ambiente

VariávelDescriçãoPadrãoExemplo
API_TOKENSeu token de API da Bright Data (obrigatório)-your-token-here
RATE_LIMITLimitação de taxa personalizadailimitada100/1h, 50/30m
SERP_ZONENome personalizado da zona da SERP API, usado pelas ferramentas de pesquisamcp_serpmy_serp_zone
BROWSER_ZONENome personalizado da zona do Browsermcp_browsermy_browser_zone
CONTENT_GATEQuando o conteúdo de página retornado por uma ferramenta de dados parecer conter instruções para alterar a configuração do MCP, o servidor pergunta ao usuário (via elicitação do MCP) antes de retorná-lo. Defina como off para desativaronoff
CONTENT_GATE_TIMEOUTSegundos de espera pela resposta do usuário antes de reter o conteúdo12060, 300
BROWSER_FILTERED_SNAPSHOTscraping_browser_snapshot sempre lista apenas botões, links e campos. Economiza tokens e impede que o texto da página se passe por um elemento clicável (em tarefas sensíveis). Se necessário, o texto da página pode ser lido com scraping_browser_get_textoffon
BASE_TIMEOUTTempo limite de solicitação, em segundos, para ferramentas básicas (pesquisa e extração)Sem limite60, 120
BASE_MAX_RETRIESNúmero máximo de novas tentativas para ferramentas básicas em erros transitórios (0-3)01, 3
GROUPSIDs de grupos de ferramentas separados por vírgulas. Limita o servidor a esses gruposTodas as ferramentasscrapers,browser
TOOLSNomes de ferramentas individuais separados por vírgulas. Limita o servidor a essas ferramentasTodas as ferramentasscrape_batch,session_stats

Filtro de conteúdo

scrape_as_markdown, search_engine e suas variantes em lote retornam qualquer conteúdo que uma página da Web apresente. Se esse conteúdo incluir texto que pareça instruir a alteração da configuração do MCP — registrar um servidor, executar um pacote npx -y, editar o arquivo de configuração do MCP —, o servidor pausa e pergunta a você, por meio do cliente MCP, antes de retorná-lo. Aprove a solicitação e o conteúdo será retornado sem alterações; recuse e ele será retido, com uma breve explicação ao assistente. Páginas sem esse tipo de texto são retornadas exatamente como antes, sem solicitação. Em uma chamada em lote, apenas os itens correspondentes são retidos.

Páginas sobre configuração do MCP (documentação, READMEs) naturalmente gerarão uma solicitação. Clientes que não oferecem suporte à elicitação do MCP terão o conteúdo correspondente retido; defina CONTENT_GATE=off se aceitar o risco. Enquanto o servidor aguarda sua resposta, ele informa o progresso; clientes que não estendem o tempo limite da ferramenta durante o progresso limitarão a espera ao próprio limite — CONTENT_GATE_TIMEOUT é o parâmetro de ajuste no lado do servidor. As ferramentas de navegador não são abrangidas.


Documentação

RecursoLink
Documentação da APIdocs.brightdata.com/ai/mcp-server/overview
Referência completa das ferramentasdocs.brightdata.com/ai/mcp-server/tools
Habilidades de agentesgithub.com/brightdata/skills
Exemplos de usoexamples
Registro de alteraçõesCHANGELOG.md

Solução de problemas

Problemas comuns e soluções

Erro "spawn npx ENOENT"

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

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

Tempos limite em sites complexos

Aumente o tempo limite nas configurações do cliente para 180s.

Problemas de autenticação

Verifique se seu token de API é válido e tem as permissões necessárias. Os tokens são gerenciados nas configurações da conta.

run_scraper retorna erros ou nenhum dado

Os registros com um campo error explicam as entradas que falharam. Compare sua entrada com sample_input de get_scraper_details (por exemplo, URLs de produtos da Amazon contêm /dp/, enquanto as do Walmart contêm /ip/) e verifique se a página está acessível publicamente. scrape_as_markdown funciona na mesma URL como alternativa.

Falha na conexão com o servidor remoto

Verifique sua conexão com a internet e as configurações do firewall.


Contribuição

Siga os padrões de codificação da Bright Data.


Suporte

CanalLink
Problemas no GitHubgithub.com/brightdata-com/brightdata-mcp/issues
Documentaçãodocs.brightdata.com/ai/mcp-server/overview
E-mailsupport@brightdata.com

Licença

MIT © Bright Data Ltd.