Neste artigo, você vai aprender:
- O que é o ZeroClaw e o que ele oferece.
- Por que adicionar acesso à web eleva as capacidades do seu assistente de IA.
- Como a Bright Data viabiliza a integração com o ZeroClaw por meio de ferramentas de web scraping, busca, descoberta e automação de navegador.
- Como conectar a Bright Data ao ZeroClaw usando MCP.
- Como fornecer ao seu assistente de IA do ZeroClaw o conhecimento da Bright Data por meio de Agent Skills dedicados.
- O que a integração ZeroClaw + Bright Data suporta, com um exemplo completo.
Vamos começar!
O que é o ZeroClaw?
O ZeroClaw é um runtime de agente de IA leve, baseado em Rust, projetado para rodar inteiramente na sua própria máquina. Ele funciona como um assistente de IA pessoal que se conecta a múltiplos provedores de LLM, interage em dezenas de canais e executa tarefas reais por meio de ferramentas como shell, navegador e APIs. O que o diferencia dos concorrentes é sua abordagem voltada à privacidade e completamente local. O ZeroClaw vem ganhando tração rapidamente na comunidade open-source, alcançando mais de 30 mil estrelas no GitHub em menos de dois meses.
Os recursos principais que ele oferece são:
- Runtime de binário único: Roda como um binário Rust compacto, com inicialização rápida e uso mínimo de recursos.
- Independente de provedor: Compatível com mais de 50 provedores de IA, incluindo OpenAI, Anthropic, Ollama e outros.
- Suporte multicanal: Conecta-se a mais de 20 plataformas, como Discord, Telegram, e-mail e CLI.
- Privacidade local em primeiro lugar: Tudo roda na sua máquina, garantindo total propriedade dos dados (sem nuvem, sem telemetria).
- Motor de execução de ferramentas: Interage com shell, navegador, HTTP APIs, hardware e servidores MCP.
- Segurança e sandboxing: Proteções integradas, permissões e isolamento de workspace para automação segura.
- Motor de automação e SOP: Suporta workflows via cron jobs, webhooks e procedimentos orientados a eventos.
- Integração com hardware: Funciona com dispositivos como Raspberry Pi, Arduino e ESP32.
- Arquitetura extensível: Adicione facilmente novos provedores, ferramentas, canais e integrações personalizadas.
Saiba mais na documentação oficial.
Por que dar ao seu assistente de IA do ZeroClaw acesso à web
Mesmo os LLMs mais avançados que alimentam o ZeroClaw compartilham uma limitação fundamental: seu conhecimento é congelado no tempo. Como dependem de dados de treinamento estáticos, eles não conseguem acompanhar naturalmente as mudanças do mundo real.
Em um ambiente que muda rapidamente, isso é uma desvantagem séria. Sem acesso a informações atualizadas, um assistente de IA pode fornecer respostas desatualizadas, alucinar fatos ou tomar ações incorretas.
Para se manter confiável, seus agentes de IA do ZeroClaw precisam de acesso à web ao vivo. É por isso que o ZeroClaw vem com ferramentas integradas para web scraping e busca. Ainda assim, essas ferramentas nem sempre estão prontas para produção e podem enfrentar bloqueios ou resultados inconsistentes.
É aqui que a Bright Data entra em cena!
A Bright Data se destaca com uma rede de mais de 400 milhões de IPs residenciais em 195 países, oferecendo 99,99% de uptime e uma taxa de sucesso de 99,95%. Ela transforma seu agente de IA em uma solução com acesso escalável e de nível de produção a dados da web.
Ao integrar a infraestrutura de IA da Bright Data, seu assistente ZeroClaw pode ir além dos limites do seu treinamento:
- Realizando pesquisas em tempo real: Acesse informações atualizadas por meio de consultas de busca ao vivo no Google, Bing, Yandex e mais
- Validando a precisão das informações: Verifique os resultados com fontes online confiáveis
- Coletando dados ao vivo: Extraia conteúdo atualizado, como preços, avaliações e insights de mercado
- Suportando muitos outros casos de uso
Como estender o ZeroClaw com a Bright Data: 2 abordagens
A Bright Data suporta o ZeroClaw por meio de duas integrações complementares:
- Bright Data Web MCP: O servidor MCP oficial que expõe mais de 70 ferramentas para interagir com as APIs e serviços da Bright Data.
- Bright Data Skills: Uma coleção de Agent Skills que ensinam o ZeroClaw a usar as soluções da Bright Data de forma eficaz.
Importante: essas duas abordagens não são alternativas. Na verdade, funcionam melhor juntas. Em particular, os Bright Data Skills incluem um skill dedicado para ajudar seus agentes de IA a aproveitarem ao máximo as ferramentas do Web MCP.
Bright Data Web MCP
O Bright Data Web MCP oferece mais de 70 ferramentas para coleta automatizada de dados da web, extração estruturada e automação de navegador. Mesmo no plano gratuito (5 mil requisições/mês), você tem acesso às ferramentas principais, como:
| Ferramenta | Descrição |
|---|---|
| search_engine + versão em lote | Recupera resultados do Google, Bing ou Yandex em formato JSON ou Markdown |
| scrape_as_markdown + versão em lote | Converte qualquer página web em Markdown limpo, contornando proteções contra bots |
| discover | Realiza busca na web com IA, retornando resultados relevantes e ranqueados |
O modo Pro desbloqueia as capacidades completas do Web MCP. Isso inclui ferramentas avançadas para extração estruturada de plataformas como Amazon, LinkedIn, Yahoo Finance, YouTube, TikTok, Zillow e Google Maps. Além disso, expõe ferramentas de automação de navegador.
Bright Data Skills
Os Bright Data Skills expandem o conhecimento do ZeroClaw por meio de:
| Skill | Descrição |
|---|---|
| search | Busca estruturada no Google com paginação e saída JSON limpa |
| scrape | Scraping de páginas web como Markdown com bypass de bots, tratamento de CAPTCHA e renderização de JavaScript |
| data-feeds | Datasets estruturados pré-construídos de mais de 40 plataformas |
| brightdata-cli | Utilitários CLI para scraping, busca, proxies, extração e monitoramento |
| bright-data-mcp | Orquestra ferramentas MCP para busca, scraping, extração e automação |
| competitive-intel | Inteligência competitiva em tempo real (preços, avaliações, contratações, sinais de SEO) |
| scraper-builder | Orienta a criação de scrapers prontos para produção, da análise à implementação |
| design-mirror | Replica padrões de UI, tokens e sistemas de design |
| python-sdk-best-practices | Guia de uso do SDK Python da Bright Data |
| bright-data-best-practices | Melhores práticas para Web Unlocker, SERP API, Scraper API e Browser API |
Etapas comuns
Antes de ver como integrar a Bright Data ao ZeroClaw, conclua as etapas de configuração comuns.
Pré-requisitos
Para seguir este tutorial, certifique-se de ter:
- Um sistema operacional baseado em UNIX (Linux ou macOS).
- Node.js 20 ou superior instalado localmente (versão LTS recomendada).
- Rust instalado localmente.
- Uma chave de API de um dos provedores de LLM suportados pelo ZeroClaw (aqui, usaremos uma chave de API do OpenAI).
- Uma conta na Bright Data com uma chave de API configurada.
Etapa 1: Instalar o ZeroClaw
No seu terminal, execute o comando abaixo para baixar e executar o script de instalação do ZeroClaw:
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bashReinicie seu shell. Verifique com:
zeroclaw --versionO resultado será parecido com:
zeroclaw 0.7.3O ZeroClaw foi instalado com sucesso na sua máquina.
Etapa 2: Concluir a configuração
Para uma configuração guiada, execute:
zeroclaw onboardO processo de onboarding do ZeroClaw será iniciado. Você será guiado por um assistente de 9 etapas para configurar o ZeroClaw. Comece selecionando seu provedor de IA preferido (OpenAI) e cole sua chave de API. Em seguida, busque os modelos mais recentes e selecione um (gpt-5-mini). Ative o “Sovereign Mode” para controle total. Por fim, personalize seu assistente de IA.
O ZeroClaw será configurado e o daemon iniciado automaticamente. Verifique com:
zeroclaw agentConectando seu assistente de IA do ZeroClaw ao Bright Data MCP
Nesta seção guiada, você aprenderá a configurar uma instância local do Bright Data Web MCP no ZeroClaw.
Pré-requisitos: familiaridade com o padrão MCP; conhecimento das ferramentas do Bright Data Web MCP. Os pré-requisitos das Etapas Comuns também se aplicam.
Etapa 1: Configurar o Web MCP da Bright Data
Instale o Web MCP globalmente:
npm install -g @brightdata/mcpVerifique se ele inicia corretamente:
API_TOKEN="<YOUR_BRIGHT_DATA_API>" npx -y @brightdata/mcpSubstitua <YOUR_BRIGHT_DATA_API> pela sua chave de API real da Bright Data. Na primeira execução, duas zonas são criadas: mcp_unlocker (Web Unlocker) e mcp_browser (Browser API).
Para desbloquear todas as 70+ ferramentas, ative o modo Pro:
API_TOKEN="<YOUR_BRIGHT_DATA_API>" PRO_MODE="true" npx -y @brightdata/mcpObservação: o modo Pro gera cobranças adicionais.
Etapa 2: Adicionar a configuração do Web MCP
Adicione o seguinte ao ~/.zeroclaw/config.toml:
# ~/.zeroclaw/config.toml
[mcp]
enabled = true
deferred_loading = true
servers = [{ name = "bright-data", command = "npx", transport = "stdio", args = ["@brightdata/mcp"], env = { API_TOKEN = "<YOUR_BRIGHT_DATA_API_KEY", PRO_MODE = "true" }, headers = {} }]- API_TOKEN (obrigatório): sua chave de API da Bright Data.
- PRO_MODE (opcional): ativa recursos avançados.
Observação: os servidores MCP no ZeroClaw são carregados de forma lazy no momento em que o assistente é iniciado.
Etapa 3: Verificar a conexão
Inicie uma sessão do ZeroClaw:
zeroclaw agentExperimente o prompt: “Which Bright Data MCP tools do you have access to?” Você deverá receber uma lista de todas as ferramentas disponíveis do Web MCP. Parabéns!
Fornecendo ao seu assistente de IA do ZeroClaw o conhecimento da infraestrutura da Bright Data via Skills
Pré-requisitos:
- Compreensão básica do padrão Agent Skills.
- Familiaridade com os Bright Data Skills.
- Git instalado localmente.
- Uma zona de API Web Unlocker na sua conta da Bright Data.
- Biblioteca jq instalada.
Instale o jq em sistemas baseados em Debian:
sudo apt-get install curl jqNo macOS:
brew install curl jqEtapa 1: Criar uma zona de API Web Unlocker
Faça login na Bright Data. Vá para “Proxies & Scraping Infrastructure”. Se uma zona Web Unlocker já existir, pule para a próxima etapa. Caso contrário, crie uma a partir do card “Unblocker API”.
Etapa 2: Finalizar a configuração dos Skills
Defina estas variáveis de ambiente:
export BRIGHTDATA_API_KEY="<YOUR_BRIGHT_DATA_API_KEY>"
export BRIGHTDATA_UNLOCKER_ZONE="<YOUR_BRIGHT_DATA_WEB_UNLOCKER_API_ZONE_NAME>"Etapa 3: Adicionar os Bright Data Skills no ZeroClaw
Habilite scripts shell no ~/.zeroclaw/config.toml:
# ~/.zeroclaw/config.toml
[skills]
allow_scripts = trueClone e instale os skills:
git clone https://github.com/brightdata/skillscp -r skills/skills/* ~/.zeroclaw/workspace/skills/Etapa 4: Verificar se os Skills estão disponíveis
zeroclaw skills listOs Bright Data Skills devem aparecer na lista.
ZeroClaw + Bright Data em ação
Suponha que você seja um empresário que deseja resumos automatizados das avaliações do Google Maps para o seu estabelecimento. Use um prompt pedindo ao ZeroClaw para recuperar avaliações postadas nos últimos 2 dias, agrupá-las em um relatório com pontuação média atualizada, contagem de avaliações, análise de sentimento com temas positivos e negativos, citações de clientes e principais conclusões.
Execute com:
zeroclaw agentOu diretamente:
zeroclaw agent --message "<YOUR_PROMPT>"O workflow utiliza: search_engine (SERP API), web_data_google_maps_reviews, scrape_as_markdown (Web Unlocker API), produzindo um relatório de sentimento estruturado a partir de dados ao vivo do Google Maps.
Conclusão
Neste tutorial, você explorou o que é o ZeroClaw e o valor que ele oferece. Em particular, aprendeu por que e como aprimorá-lo integrando a Bright Data por meio do Web MCP e dos seus skills oficiais.
Essa configuração eleva seu assistente de IA do ZeroClaw ao habilitar acesso direto à web. Isso desbloqueia capacidades como busca na web, descoberta de conteúdo, extração de dados estruturados e interações automatizadas com sites.
Crie uma conta gratuita na Bright Data hoje mesmo e comece a integrar nossas poderosas ferramentas de dados da web!
