Bright Data
oficialDescubra, 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 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.
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âmetro | Descrição | Exemplo |
|---|---|---|
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
- Acesse: Settings → Connectors → Add custom connector
- Nome:
Bright Data - URL:
https://mcp.brightdata.com/mcp?token=YOUR_API_TOKEN - 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 coleta | Navegação no navegador | |
|---|---|---|
| Pague conforme o uso | US$ 1,50 / 1 mil resultados | US$ 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.
| Tarefa | Ferramentas |
|---|---|
| Pesquisar informações atuais na web | search_engine, search_engine_batch |
| Ler uma página específica como Markdown limpo | scrape_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.
| Tarefa | Ferramentas |
|---|---|
| Produtos, avaliações e resultados de pesquisa da Amazon, Walmart, eBay, Best Buy, Etsy, Home Depot, Zara e outras lojas | search_scrapers → get_scraper_details → run_scraper |
| Comparação de preços entre varejistas | o 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.
| Tarefa | Ferramentas |
|---|---|
| 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 concorrentes | scrape_as_markdown, scrape_batch |
| Descoberta de mercado | search_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.
| Tarefa | Ferramentas |
|---|---|
| Substituição direta da pesquisa na web integrada | search_engine |
| Substituição direta da busca integrada de URLs | scrape_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.
| Tarefa | Ferramentas |
|---|---|
| Versão, README e metadados de pacotes npm e PyPI | run_scraper com o scraper npmjs ou pypi (encontre-os com search_scrapers) |
| Ler arquivos de repositórios do GitHub | run_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).
| Tarefa | Ferramentas |
|---|---|
| Respostas do ChatGPT com citações e recomendações | chatgpt_ai_insights |
| Respostas do Perplexity com fontes | perplexity_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.
| Plataforma | Exemplos de scrapers |
|---|---|
| perfis de pessoas, perfis de empresas, vagas, publicações, pesquisa de pessoas | |
| perfis, publicações, reels, comentários | |
| TikTok | perfis, publicações, loja, comentários |
| perfis, publicações, anúncios do marketplace, avaliações de empresas, eventos | |
| YouTube | vídeos, canais, comentários |
| X (Twitter) | publicações, publicações por perfil |
| publicaçõ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.
| Tarefa | Ferramentas |
|---|---|
| Coletar várias fontes em uma chamada | scrape_batch (até 5 URLs) |
| Notícias e dados financeiros | search_engine com consultas de notícias, run_scraper com o scraper do Yahoo Finance |
Comparação
| Recurso | Bright Data MCP | Servidores MCP da web típicos |
|---|---|---|
| Total de ferramentas | 30 | 2–10 |
| Extratores de JSON estruturado específicos por plataforma | Mais 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 ferramentas | Raros; 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ções | Geralmente nenhum; bloqueados em sites protegidos |
| Mecanismos de pesquisa | Bing, Google | Geralmente um |
| Automação de navegador | 14 ferramentas, navegador remoto, sem configuração local | Limitada ou inexistente |
| Coleta de respostas de LLMs (ChatGPT, Perplexity) | Sim | Não oferecida |
| Dados de registros de pacotes (npm, PyPI) | Sim | Não oferecidos |
| Operações em lote | 10 pesquisas ou 10 extrações por chamada | Geralmente apenas uma solicitação |
| Segmentação geográfica | Sim | Limitada ou inexistente |
| Plano gratuito | 5.000 solicitações/mês, automação de navegador incluída, sem cartão de crédito | Varia; 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
GROUPSouTOOLS, todas as 30 ferramentas ficam habilitadas. Definir qualquer um deles limita o servidor apenas às ferramentas especificadas GROUPShabilita conjuntos de ferramentas. Separe por vírgulas:GROUPS="scrapers,browser"(local) ou&groups=scrapers,browser(URL hospedada)TOOLSadiciona ferramentas individuais:TOOLS="scrape_batch,session_stats". Usado sozinho, habilita apenas as ferramentas listadas- Cada grupo também inclui
search_engine,scrape_as_markdowneask_brightdata_assistant - O ID de grupo
customé reservado; useTOOLSpara 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_markdowncomformat: '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
errorexplicam entradas que falharam, por exemplo, uma URL do tipo errado - Os resultados podem ser grandes. Mantenha
limit_per_inputbaixo para métodosdiscover_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_markdownfunciona na mesma URL como alternativa
Pesquisa e extração — 5 ferramentas
| Ferramenta | Descrição | Grupo |
|---|---|---|
search_engine | Pesquise 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_batch | Até 5 consultas de pesquisa em uma chamada | padrão / advanced_scraping |
scrape_as_markdown | Qualquer URL. Retorna o conteúdo como Markdown (padrão), texto, HTML ou ld_json | padrão / todos os grupos |
scrape_batch | Até 5 URLs em uma chamada. Retorna o conteúdo como Markdown (padrão), texto, HTML ou ld_json | padrão / advanced_scraping |
session_stats | Contagem de uso das ferramentas na sessão atual | padrã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).
| Ferramenta | Descrição | Grupo |
|---|---|---|
search_scrapers | Encontre 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 coleta | padrão / scrapers |
get_scraper_details | Descrição, campos de entrada, exemplo de entrada e principais campos de saída de um método de scraper | padrão / scrapers |
run_scraper | Execute um método de scraper. Aguarda até 45 segundos; se ainda estiver em execução, retorna um snapshot_id para consultar mais tarde | padrão / scrapers |
get_scraper_progress | Status de uma execução: starting, running, ready, failed ou canceled | padrão / scrapers |
get_scraper_results | Registros de uma execução concluída | padrão / scrapers |
refresh_scrapers | Recarregue a lista de scrapers agora, em vez de aguardar a atualização diária | padrã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.
| Ferramenta | Descrição |
|---|---|
scraping_browser_navigate | Abra ou reutilize uma sessão de navegador e navegue até uma URL |
scraping_browser_go_back | Volte |
scraping_browser_go_forward | Avance |
scraping_browser_snapshot | Instantâneo ARIA da página, listando elementos interativos com referências. Necessário antes de ações baseadas em referências |
scraping_browser_click_ref | Clique em um elemento pela referência do instantâneo mais recente |
scraping_browser_type_ref | Digite em um elemento pela referência; opcionalmente, pressione Enter para enviar |
scraping_browser_fill_form | Preencha vários campos de formulário por referência em uma chamada |
scraping_browser_screenshot | Captura de tela da página atual; full_page opcional |
scraping_browser_get_text | Conteúdo textual do corpo da página |
scraping_browser_get_html | HTML da página atual |
scraping_browser_scroll | Role até o fim da página |
scraping_browser_scroll_to_ref | Role até que um elemento fique visível |
scraping_browser_wait_for_ref | Aguarde até que um elemento fique visível, com tempo limite opcional |
scraping_browser_network_requests | Solicitaçõ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
| Ferramenta | Entrada | Retorna |
|---|---|---|
chatgpt_ai_insights | Solicitação | Resposta do ChatGPT em Markdown |
perplexity_ai_insights | Solicitação | Resposta 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.
| Ferramenta | Descrição | Grupo |
|---|---|---|
list_dataset_fields | Campos filtráveis de um conjunto de dados (nome, tipo, descrição). Chame antes de search_dataset | padrão / social, business |
search_dataset | Registros que correspondem a um filtro, até 10 por chamada, com um cursor para buscar mais | padrão / social, business |
Assistente da Bright Data — 1 ferramenta
| Ferramenta | Descrição | Grupo |
|---|---|---|
ask_brightdata_assistant | Pergunte à 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 conversa | padrã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:
| Skill | O que faz |
|---|---|
| bright-data-mcp | Define 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-intel | Instantâ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-comparison | Localiza um produto na Amazon, Walmart, eBay, Best Buy e Google Shopping e indica a opção disponível em estoque mais barata |
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ável | Descrição | Padrão | Exemplo |
|---|---|---|---|
API_TOKEN | Seu token de API da Bright Data (obrigatório) | - | your-token-here |
RATE_LIMIT | Limitação de taxa personalizada | ilimitada | 100/1h, 50/30m |
SERP_ZONE | Nome personalizado da zona da SERP API, usado pelas ferramentas de pesquisa | mcp_serp | my_serp_zone |
BROWSER_ZONE | Nome personalizado da zona do Browser | mcp_browser | my_browser_zone |
CONTENT_GATE | Quando 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 desativar | on | off |
CONTENT_GATE_TIMEOUT | Segundos de espera pela resposta do usuário antes de reter o conteúdo | 120 | 60, 300 |
BROWSER_FILTERED_SNAPSHOT | scraping_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_text | off | on |
BASE_TIMEOUT | Tempo limite de solicitação, em segundos, para ferramentas básicas (pesquisa e extração) | Sem limite | 60, 120 |
BASE_MAX_RETRIES | Número máximo de novas tentativas para ferramentas básicas em erros transitórios (0-3) | 0 | 1, 3 |
GROUPS | IDs de grupos de ferramentas separados por vírgulas. Limita o servidor a esses grupos | Todas as ferramentas | scrapers,browser |
TOOLS | Nomes de ferramentas individuais separados por vírgulas. Limita o servidor a essas ferramentas | Todas as ferramentas | scrape_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
| Recurso | Link |
|---|---|
| Documentação da API | docs.brightdata.com/ai/mcp-server/overview |
| Referência completa das ferramentas | docs.brightdata.com/ai/mcp-server/tools |
| Habilidades de agentes | github.com/brightdata/skills |
| Exemplos de uso | examples |
| Registro de alterações | CHANGELOG.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
| Canal | Link |
|---|---|
| Problemas no GitHub | github.com/brightdata-com/brightdata-mcp/issues |
| Documentação | docs.brightdata.com/ai/mcp-server/overview |
| support@brightdata.com |
Licença
MIT © Bright Data Ltd.