Dê ao AstrBot a Capacidade de Interagir com a Web Usando o Bright Data (MCP + Skills)

Neste tutorial, você aprenderá:

• O que é o AstrBot e o que ele oferece como plataforma de agente de IA de código aberto.
• Por que adicionar acesso à web em tempo real torna o AstrBot mais eficaz para tarefas do mundo real.
• Como o Bright Data equipa o AstrBot com ferramentas empresariais de busca na web, scraping, descoberta e automação de navegador.
• Como integrar o Bright Data Web MCP ao AstrBot.
• Como aprimorar o AstrBot com conhecimento especializado sobre produtos Bright Data usando as Bright Data skills.
• Os resultados da combinação do AstrBot com o Web MCP e as Bright Data skills.

Vamos começar!

O Que É o AstrBot?

AstrBot é um framework de agente de IA de código aberto e multiplataforma. Ele integra assistentes baseados em LLM diretamente em aplicativos de chat populares como Telegram, Slack, Discord, WeChat e muito mais.

Vai além dos chatbots tradicionais ao suportar fluxos de trabalho de agentes, chamadas de ferramentas, MCP, skills e bases de conhecimento. Também conta com extensões de plugins para automação, suporte ao cliente, gestão de conhecimento empresarial e assistentes de IA pessoais.

O AstrBot acumulou mais de 36,5 mil estrelas no GitHub, possui mais de 1.000 plugins da comunidade e mais de 200 mil usuários ativos semanalmente.

Principais Recursos

As principais capacidades suportadas pelo AstrBot:

• Suporte multiplataforma: Converse com seu agente via Telegram, Slack, Discord, QQ, WeChat, Lark, DingTalk e muitas outras plataformas de mensagens.
• Suporte nativo a MCP: Integre ferramentas e serviços externos por meio do Model Context Protocol.
• Integração de skills: Amplie os agentes com skills reutilizáveis que fornecem capacidades e fluxos de trabalho especializados.
• Ecossistema com mais de 1.000 plugins: Adicione novos recursos e integrações por meio de um rico marketplace de plugins mantido pela comunidade.
• Base de conhecimento: Crie assistentes de IA que respondem perguntas usando PDFs, arquivos DOCX, Markdown e outros documentos.
• Suporte a múltiplos provedores de LLM: Funciona com OpenAI, Anthropic, Google Gemini, Ollama e muitos provedores compatíveis com OpenAI.
• Sandbox de agente: Execute código e comandos shell com segurança em ambientes de execução isolados.
• WebUI poderosa: Configure modelos, plugins, servidores MCP, logs e depuração a partir de uma interface centralizada.
• Implantação flexível: Implante com uv, Docker, aplicativos desktop, launchers ou ambientes em nuvem.
• Automação de fluxo de trabalho: Agende tarefas, orquestre ferramentas e crie agentes de IA autônomos para fluxos de trabalho do mundo real.

Saiba mais na documentação oficial.

Por Que o AstrBot Precisa de Acesso à Web

Sem dúvida, o AstrBot é um sólido framework de IA repleto de recursos avançados. No entanto, como todos os aplicativos baseados em LLM, ele herda estas limitações fundamentais:

• Conhecimento desatualizado: Os LLMs são treinados em conjuntos de dados estáticos que se encerram em um ponto específico no tempo.
• Acesso limitado à web: Por conta própria, eles não conseguem interagir de forma confiável com páginas web.

O AstrBot ajuda a superar parte desse desafio com uma ferramenta de busca na web integrada. Ainda assim, essa ferramenta pode ter dificuldades em escala ou ao acessar sites protegidos por tecnologias anti-bot como CAPTCHAs, limites de taxa e fingerprinting.

É aqui que entra o Bright Data. Ao conectar o AstrBot às soluções Bright Data, o agente recebe acesso a ferramentas empresariais para busca na web em tempo real, extração de dados, descoberta de sites, automação de navegador e recuperação de conjuntos de dados.

O diferencial do Bright Data é sua infraestrutura global de dados web, alimentada por mais de 400 milhões de IPs residenciais. Essa arquitetura oferece a escalabilidade e a confiabilidade necessárias para cargas de trabalho em produção, suportando concorrência ilimitada, uptime garantido por SLA de 99,99% e alcançando uma taxa de sucesso de requisições de 99,95%.

Como o Bright Data Apoia o AstrBot com Busca na Web, Scraping, Descoberta e Interação

O Bright Data pode se conectar ao AstrBot por meio de duas integrações:

• Bright Data Web MCP: Um servidor MCP que expõe mais de 70 ferramentas para busca na web, scraping, extração de dados estruturados e automação de navegador.
• Bright Data skills: Uma coleção de Agent Skills que fornece ao AstrBot conhecimento especializado sobre produtos Bright Data, fluxos de trabalho recomendados e melhores práticas. A maioria dessas skills depende da Bright Data CLI.

Observação: As duas abordagens são complementares. Por exemplo, uma Bright Data skill específica ajuda o AstrBot a entender quando e como usar as ferramentas do Web MCP de forma eficaz.

Juntos, o Web MCP e as Bright Data skills transformam o AstrBot em um agente de IA mais capaz. Graças a eles, ele pode realizar pesquisas web em tempo real, automação de navegador e extração de dados estruturados.

Bright Data Web MCP

O Bright Data Web MCP equipa o AstrBot com um grande conjunto de ferramentas alimentadas pelas APIs do Bright Data.

No Rapid mode (o nível gratuito com 5.000 requisições gratuitas por mês), o AstrBot pode utilizar ferramentas essenciais para pesquisa web e extração de dados. Estas incluem:

Ao ativar o Pro mode, o AstrBot ganha acesso a ferramentas para extração de dados estruturados do LinkedIn, Amazon, Instagram, Walmart, YouTube, Google Maps, Zillow, TikTok e mais de 40 outras plataformas. Também desbloqueia múltiplas ferramentas de automação de navegador baseadas na Browser API do Bright Data.

Bright Data Skills

As Bright Data skills ampliam o AstrBot com conhecimento especializado e fluxos de trabalho. Elas ajudam o agente a escolher os serviços Bright Data corretos e seguir as melhores práticas recomendadas.

Algumas das skills disponíveis incluem:

Configuração do AstrBot: Guia Passo a Passo

Nesta seção, você verá como configurar o AstrBot e conectá-lo ao Telegram.

Observação: Você pode facilmente adaptar as instruções abaixo para qualquer outra plataforma de mensagens suportada pela biblioteca.

Pré-requisitos

Certifique-se de ter:

• uv instalado em sua máquina local.
• Uma chave de API de um dos provedores de LLM suportados pelo AstrBot. Aqui, usaremos uma chave de API da OpenAI.
• Uma conta no Telegram com um bot pronto para conectar ao AstrBot. Siga o guia oficial para criar um bot no Telegram e obter seu token.

Passo #1: Instalar e Executar o AstrBot

Primeiro, instale o AstrBot executando o seguinte comando:

uv tool install astrbot, python 3.12

Em seguida, navegue até a pasta do seu projeto e inicialize a configuração do AstrBot:

astrbot init

Você receberá uma solicitação perguntando se deseja instalar o AstrBot no diretório atual. Digite “Y” para continuar:

Após a conclusão da configuração, inicie o AstrBot com:

astrbot run

Você deverá ver uma saída semelhante à seguinte:

A WebUI do AstrBot estará disponível em http://localhost:6185. Abra essa URL no seu navegador e faça login usando as credenciais fornecidas nos logs do terminal:

Após fazer login, defina uma nova senha para acessar o painel na WebUI do AstrBot. Muito bem!

Passo #2: Adicionar a Integração com LLM

Na página “Welcome” da WebUI do AstrBot, clique no botão “Configure” na seção “Configure AI Model” para começar:

Aqui, conectaremos o AstrBot à OpenAI (mas o processo é semelhante para qualquer outro provedor de LLM suportado). Selecione Add e escolha a opção “OpenAI Compatible”. O modal de configuração “openai” será aberto. Cole sua chave de API da OpenAI no campo correspondente:

Clique em “Save and Fetch Models” para recuperar dinamicamente os modelos OpenAI disponíveis. Em seguida, selecione o modelo que deseja usar. Neste exemplo, usaremos o OpenAI GPT-5.4 Mini:

Por fim, pressione “Save” para aplicar a configuração e retornar à página “Welcome”. Seu agente AstrBot agora é alimentado por um LLM da OpenAI. Incrível!

Passo #3: Configurar a Conexão com o Telegram

Na página “Welcome” da WebUI do AstrBot, clique no botão “Configure” em “Configure Platform Bot”. No modal “Add Platform Adapter”, selecione “Telegram” e cole o token do seu bot do Telegram no campo correspondente:

Pressione “Save” e abra seu bot do Telegram (chamado “AstrBot Agent” neste exemplo). Você deverá receber uma mensagem contendo o seguinte texto:

Hello, I'm AstrBot!

Para verificar se a integração com o LLM está funcionando corretamente, envie uma mensagem de teste como:

Hey, how's it going?

Você deverá receber uma resposta como esta:

Essa foi gerada pelo GPT-5.4 Mini e enviada via AstrBot.

Configuração concluída! O framework agora está totalmente configurado e você pode interagir com ele pelo Telegram.

Conectar o AstrBot ao Bright Data Web MCP

Neste capítulo, você aprenderá como configurar o Bright Data Web MCP no AstrBot.

Pré-requisitos

Para uma experiência mais tranquila ao seguir esta seção, verifique se você tem:

• Uma compreensão básica de como o MCP funciona.
• Familiaridade com as ferramentas fornecidas pelo Bright Data Web MCP.

Além disso, você deve ter uma conta Bright Data com uma chave de API configurada. Leia o guia oficial para gerar sua chave de API do Bright Data.

Passo #1: Familiarize-se com o Bright Data Web MCP

Antes de começar, tenha em mente que o AstrBot recomenda conectá-lo a servidores MCP remotos. Por esse motivo, em vez de configurar um servidor Bright Data Web MCP local com o pacote @brightdata/mcp, integraremos o servidor Web MCP remoto.

Observação: O Bright Data Web MCP remoto foi criado para implantações em escala empresarial. Suporta escalabilidade ilimitada e conexões simultâneas, assim como todos os outros serviços Bright Data.

Para começar, familiarize-se com a URL de conexão padrão do Web MCP:

https://mcp.brightdata.com/mcp?token=<YOUR_BRIGHT_DATA_API_KEY>&pro=1

Substitua <YOUR_BRIGHT_DATA_API_KEY> pela sua chave de API do Bright Data. O parâmetro token autentica suas requisições e as associa à sua conta Bright Data.

O parâmetro &pro=1 é opcional:

• Com &pro=1: Acesso ao catálogo completo de mais de 70 ferramentas e capacidades avançadas. Tarifas padrão de uso do Bright Data são aplicadas.
• Sem &pro=1: Acesso apenas às ferramentas gratuitas disponíveis no Rapid mode (até 5.000 requisições por mês).

Agora, suponha que você queira um controle mais granular sobre as ferramentas expostas. Por exemplo, deseja configurar o acesso apenas a ferramentas ou grupos de ferramentas específicos. Nesse caso, você pode gerar uma URL de conexão personalizada do Web MCP a partir do painel do Bright Data.

Faça login em sua conta Bright Data e navegue até a página “AI Gateways > MCP”. Siga o assistente de configuração para configurar seu servidor MCP e gerar uma URL de conexão personalizada:

Copie a URL de conexão “Streamable HTTP” gerada, ou construa uma usando o formato mostrado acima. Você usará essa URL na próxima etapa para conectar o AstrBot ao Bright Data Web MCP. Ótimo!

Passo #2: Adicionar a Conexão do Bright Data Web MCP no AstrBot

O AstrBot permite configurar conexões MCP diretamente de sua WebUI.

Para adicionar um novo servidor MCP, abra o menu suspenso “Extensions” à esquerda e selecione a opção “MCP Servers”. Na página “MCP”, clique no botão “+” no canto inferior direito:

Dê um nome ao seu servidor MCP (por exemplo, “Bright Data Web MCP”) e cole a seguinte configuração:

{
  "transport": "streamable_http",
  "url": "<YOUR_WEB_MCP_CONNECTION_URL>"
}

Substitua <YOUR_WEB_MCP_CONNECTION_URL> pela URL de conexão do Bright Data Web MCP obtida anteriormente.

Pressione “Test Connection” para verificar se o servidor MCP está configurado corretamente. Se a conexão for bem-sucedida, o AstrBot exibirá uma mensagem de confirmação seguida de uma lista das ferramentas disponíveis:

Ao usar o Pro mode (&pro=1), você verá todas as mais de 70 ferramentas do Bright Data Web MCP.

Conclua a integração clicando em “Save”. O arquivo de configuração ./data/mcp_server.json do AstrBot incluirá:

{
  "mcpServers": {
    "Bright Data Web MCP": {
      "active": true,
      "transport": "streamable_http",
      "url": "<YOUR_WEB_MCP_CONNECTION_URL>"
    }
  }
}

Como alternativa, você pode obter o mesmo resultado editando manualmente este arquivo de configuração.

Após salvar, a página “MCP” exibirá a nova entrada “Bright Data Web MCP”, que deve estar habilitada por padrão:

Excelente! O AstrBot agora está conectado ao Bright Data Web MCP e pode chamar suas ferramentas de interação com a web.

Mais adiante neste guia, você verá uma configuração do AstrBot com o Web MCP junto com as Bright Data skills.

Adicionar Conhecimento sobre o Bright Data ao AstrBot Usando as Skills Oficiais

Abaixo, você será guiado pelo processo de adicionar as Bright Data skills ao AstrBot usando a ferramenta CLI skills da Vercel.

Observação: Se não quiser usar o skills, você pode baixar as skills diretamente do repositório oficial. Navegue até a pasta skills/, crie um arquivo ZIP com seu conteúdo e faça o upload manualmente pela página “Extensions > Skills” no AstrBot.

Pré-requisitos

Antes de prosseguir com esta seção, verifique se você tem:

• Um ambiente baseado em UNIX (Linux, macOS ou WSL).
• Node.js 22+ instalado localmente.
• A Bright Data CLI instalada e configurada localmente. Este é o principal requisito para usar as Bright Data skills. Para uma configuração rápida, consulte o guia “Bright Data CLI: Installation & Setup“. Como alternativa, consulte o post dedicado no blog para mais detalhes.
• Uma compreensão básica de o que as Bright Data skills oferecem. Para mais informações, leia o artigo sobre Bright Data skills em nosso blog.

Alguma familiaridade com a ferramenta CLI skills padrão do Agent Skills também é recomendada, mas não obrigatória.

Passo #1: Instalar as Bright Data Skills

Para adicionar as Bright Data skills ao AstrBot usando a ferramenta CLI skills, execute:

npx skills add brightdata/skills -a astrbot

Este comando instala o pacote npm skills e inicia o processo de configuração. Isso irá:

1. Baixar as Bright Data skills do Agent Skills Directory.
2. Configurá-las para uso globalmente ou dentro do seu projeto local.

Você será solicitado a selecionar quais skills instalar:

Para instalar todas as skills disponíveis, use a Barra de Espaço para selecionar cada uma e pressione Enter para continuar.

Em seguida, escolha o escopo de instalação. Como a integração do Web MCP foi configurada localmente, você também deve instalar as Bright Data skills localmente. Portanto, selecione a opção “Project” e pressione Enter:

Pressione Enter novamente para confirmar a instalação. Após a conclusão, você verá uma mensagem de confirmação:

As Bright Data skills agora estão disponíveis no diretório ./data/skills do AstrBot. Excelente!

Passo #2: Confirmar que as Skills Estão Disponíveis

Retorne à WebUI do AstrBot e abra a página “Extensions > Skills”:

Você verá uma lista contendo todas as Bright Data skills que acabou de instalar.

Observação: Se as skills não aparecerem, tente atualizar a página.

Opcionalmente, se ainda não configurou a Bright Data CLI, execute a skill de onboarding. No Telegram, escreva:

/agent-onboarding

Isso carrega a Bright Data skill de onboarding dedicada, que orienta você pelo processo de configuração exigido pelas outras Bright Data skills. Para executá-la, você também deve fornecer ao AstrBot permissão para executar comandos shell.

Missão cumprida! No próximo capítulo, você aprenderá como usar o Bright Data Web MCP e as skills juntos dentro do AstrBot.

AstrBot + Bright Data Web MCP e Skills: Exemplo Completo

Seu agente AstrBot agora tem ferramentas e conhecimento prontos para uso empresarial para interagir com a web. Isso permite que ele lide com uma ampla gama de casos de uso do mundo real que requerem dados web ao vivo, automação de navegador e extração de dados estruturados.

Por exemplo, suponha que você queira usar o AstrBot como um assistente de compras. Os sites modernos de e-commerce frequentemente são protegidos por tecnologias anti-bot avançadas, dificultando a interação de agentes de IA com eles. Para mais informações, veja nosso guia sobre scraping de e-commerce.

Ao integrar o Bright Data, o AstrBot pode contornar essas limitações ao pesquisar na web, interagir com páginas web e extrair as informações necessárias para concluir suas solicitações.

Agora, imagine que você queira usar o AstrBot pelo Telegram para ajudá-lo a encontrar um produto no site da Zara. Veja os passos abaixo!

Passo #1: Iniciar os Prompts

Comece com um prompt como este:

Search Google for the Zara men's polo shirts sale page. Visit the page in a browser and return a full-page screenshot.

Você deverá receber uma resposta semelhante a:

Observe como o agente concluiu a tarefa. Nos bastidores, ele:

• Chamou a ferramenta search_engine (baseada na API SERP do Bright Data) para pesquisar no Google a consulta “Zara men’s polo shirts sale page”.
• Fez o parsing do SERP retornado em JSON para identificar a página correta.
• Abriu a página em uma instância de navegador na nuvem usando a ferramenta scraping_browser_navigate (alimentada pela Browser API do Bright Data).
• Capturou uma captura de tela da página inteira com a ferramenta scraping_browser_screenshot.
• Retornou tanto a captura de tela quanto a URL da página.

Se você abrir a WebUI do AstrBot e navegar até “Platforms > Platform Logs”, poderá inspecionar cada ferramenta do Web MCP e Bright Data skill que o agente utilizou:

Suponha que você abra a captura de tela, goste do terceiro produto e queira que o AstrBot recupere todas as informações sobre ele. Você pode enviar um prompt como:

I like the third product, the Zip Polo Sweatshirt. Get the URL of its product page, then scrape it to extract the main product information. Return the results in a structured text message.

A resposta deve ser semelhante a esta:

Nos bastidores, o AstrBot chama múltiplas ferramentas Bright Data para identificar a página do produto e extrair suas informações. Dependendo do fluxo de trabalho, ele pode recuperar os dados usando scrape_as_markdown ou uma ferramenta especializada como web_data_zara_products (que se baseia na API de Dados Web da Zara do Bright Data).

Passo #2: Analisar a Saída

Observe que as informações retornadas da última mensagem correspondem ao que está disponível na página oficial do produto da Zara:

Uma página de produto pode exigir várias interações manuais para revelar todas as suas informações (por exemplo, expandir a seção “PRODUCT MEASUREMENTS”). Apesar disso, o AstrBot conseguiu retornar os detalhes completos do produto graças às ferramentas especializadas expostas pelo Web MCP do Bright Data.

A partir daí, você pode continuar a conversa naturalmente. Por exemplo, poderia perguntar ao AstrBot se o produto vale a pena comprar, compará-lo com alternativas similares ou recomendar outros produtos dentro da mesma faixa de preço.

Et voilà! Este exemplo simples destaca o quanto o AstrBot se torna mais capaz quando integrado ao Bright Data. Sem o Web MCP e as Bright Data skills, ele não seria capaz de concluir de forma confiável fluxos de trabalho que dependem de busca na web em tempo real, descoberta de sites, extração de dados e interações automatizadas com o navegador.

Conclusão

Neste post do blog, você aprendeu o que é o AstrBot e o que ele oferece. Em particular, você viu como estender sua funcionalidade integrando o Bright Data por meio do Web MCP e das Bright Data skills.

Com o Bright Data, o AstrBot pode aproveitar ferramentas para pesquisa web em tempo real, scraping e descoberta de fontes. Isso permite que ele gere respostas mais fundamentadas com base em informações precisas, contextuais e verificáveis. Também pode usar ferramentas de interação com navegador na nuvem, permitindo que você delegue fluxos de trabalho web complexos diretamente ao agente.

Para cenários ainda mais avançados, explore a gama completa de soluções de dados web prontas para IA disponíveis pelo ecossistema Bright Data.

Cadastre-se gratuitamente no Bright Data hoje mesmo e comece a explorar nossas soluções de dados web!