Hermes Agent + Bright Data: Construindo o Assistente de IA Web-Consciente Definitivo

Neste tutorial, você aprenderá:

• O que é o Hermes Agent e o que ele oferece como framework autônomo de agente de IA.
• Por que adicionar acesso confiável à web torna os agentes de IA mais precisos e prontos para produção.
• Como a Bright Data aprimora o Hermes Agent com ferramentas de busca na web, scraping e descoberta de dados.
• Como conectar o Web MCP da Bright Data ao Hermes Agent.
• Como estender o Hermes com as skills da Bright Data.
• O que a integração Bright Data + Hermes Agent viabiliza por meio de um exemplo prático do mundo real.

Vamos lá!

O que é o Hermes Agent?

Hermes Agent é um framework de IA autônomo e auto-aperfeiçoável, com memória entre sessões e um loop automatizado de aprendizado de skills.

O Hermes pode ser executado localmente na sua máquina ou continuamente em um servidor ou VPS, sendo adequado tanto para implantações pessoais quanto para agentes sempre ativos. Ele suporta desenvolvimento de software, fluxos de trabalho de pesquisa e tarefas de automação.

Com mais de 220.000 estrelas no GitHub, o Hermes Agent conta com forte suporte da comunidade, com muitos plugins e integrações. É totalmente open-source sob a licença MIT, enquanto opções gerenciadas premium estão disponíveis pelo Hermes Cloud.

Principais Recursos

As capacidades principais fornecidas pelo Hermes Agent são:

• Memória persistente: Lembra preferências, projetos, ambientes e informações aprendidas entre diferentes sessões.
• Conjunto de ferramentas interno: Vem com ferramentas integradas para busca na web, execução de terminal, arquivos, memória e automação de navegador.
• Sistema de skills: Carrega conhecimento especializado sob demanda, ampliando capacidades enquanto minimiza o uso de contexto.
• Integração MCP: Conecta o Hermes Agent a ferramentas externas, APIs, bancos de dados e serviços por meio de servidores MCP.
• Tarefas agendadas: Automatiza fluxos de trabalho recorrentes usando instruções em linguagem natural ou expressões cron.
• Delegação de subagentes: Cria agentes filhos especializados para lidar com tarefas paralelas com contextos isolados.
• Conversas por voz: Habilita interações de voz em tempo real por meio de CLI e plataformas de mensagens.
• Fluxos de trabalho sensíveis ao contexto: Usa arquivos, referências e contexto de projeto para adaptar respostas a ambientes específicos.

Por que Fornecer ao Hermes Agent Acesso Confiável à Web

Os números impressionantes alcançados pelo Hermes Agent demonstram que ele é um sólido framework autônomo de agente de IA. No entanto, para se tornar verdadeiramente pronto para produção e eficaz, um agente de IA deve ser capaz de:

• Interagir com páginas web como parte de fluxos de trabalho automatizados.
• Recuperar dados de plataformas que não foram incluídas nos dados de treinamento originais do modelo.

O Hermes Agent atende a essas necessidades com ferramentas integradas de busca na web, scraping e automação de navegador. No entanto, essas capacidades nativas podem não ser projetadas para fluxos de trabalho de dados web em nível de produção. Como resultado, podem ter dificuldades com extração web em larga escala ou sites protegidos por mecanismos anti-bot, como limites de taxa e CAPTCHAs.

É aqui que a Bright Data entra!

Ao conectar o Hermes Agent com a Bright Data, o agente obtém acesso a ferramentas prontas para empresas para busca web ao vivo, extração de dados estruturados, descoberta de fontes, automação de navegador e recuperação de conjuntos de dados.

O que destaca a integração com a Bright Data é sua infraestrutura global, incluindo mais de 400 milhões de IPs residenciais. Essa arquitetura fornece a escalabilidade, os recursos de bypass anti-bot e o desempenho necessários para fluxos de trabalho de dados web do mundo real. Ela suporta concorrência ilimitada, oferece 99,99% de uptime e alcança uma taxa de sucesso de 99,95%.

Como a Bright Data Suporta o Hermes

A Bright Data se integra ao Hermes Agent por meio de dois componentes complementares:

• Bright Data Web MCP: Um servidor MCP que expõe mais de 70 ferramentas para busca na web, scraping, extração de dados e automação de navegador.
• Bright Data Agent Skills: Um conjunto de Agent Skills que ajuda o Hermes Agent a entender quando e como usar os produtos da Bright Data de forma eficaz.

Importante: Essas integrações funcionam melhor juntas. Em detalhes, as skills da Bright Data podem guiar o Hermes na seleção e uso das ferramentas Web MCP mais apropriadas. Além disso, elas fornecem melhores práticas gerais para aprimorar o conhecimento sobre o uso dos produtos da Bright Data.

Bright Data Web MCP

Web MCP expõe mais de 70 ferramentas alimentadas pelos produtos baseados em API da Bright Data.

Mesmo no modo Rapid (o nível gratuito com 5.000 solicitações/mês), ele oferece ferramentas úteis para tarefas web comuns:

Ferramenta	Descrição
search_engine + versão em lote (search_engine)	Recupera resultados de mecanismos de busca como Google, Bing e Yandex.
scrape_as_markdown + versão em lote (scrape_batch)	Converte páginas web em Markdown limpo com tratamento de proteção contra bots.
discover	Realiza busca com IA retornando resultados web classificados e relevantes.

Para obter todas as 70+ ferramentas, você precisa [habilitar o modo Pro](https://github.com/brightdata/brightdata-mcp?tab=readme-ov-file#-pricing, modes). Isso desbloqueia ferramentas de extração de dados estruturados para plataformas como Amazon, LinkedIn, Yahoo Finance, YouTube, Zillow, Google Maps e mais de 40 sites adicionais. Além disso, inclui ferramentas para automação de navegador via Browser API da Bright Data.

Bright Data Agent Skills

As skills da Bright Data fornecem ao Hermes Agent conhecimento especializado para usar os produtos e fluxos de trabalho da Bright Data.

As skills disponíveis incluem:

Skill	Descrição
agent-onboarding	Ajuda agentes a configurar integrações da Bright Data e escolher a configuração correta.
search	Busca no Google e retorna resultados de pesquisa estruturados.
scrape	Faz scraping de páginas web em Markdown limpo, ignorando proteção contra bots.
discover-api	Explica como usar a API Discover da Bright Data.
data-feeds	Extrai dados estruturados de mais de 40 sites automaticamente.
brightdata-cli	Orienta o uso da CLI da Bright Data para scraping e extração.
bright-data-mcp	Orienta o uso das ferramentas MCP da Bright Data para tarefas web.
bright-data-best-practices	Fornece orientação para APIs e integrações da Bright Data.
live-research	Cria relatórios de pesquisa usando dados web ao vivo.
competitive-intel	Realiza análise de concorrentes usando dados web ao vivo.
brand-listening	Analisa menções de marca e sentimento do público.
price-comparison	Compara preços em varejistas online.
seo-audit	Realiza auditorias de SEO usando dados web ao vivo.
design-mirror	Replica padrões de UI e sistemas de design.

Primeiros Passos com o Hermes Agent

Hora de abordar os poucos passos necessários para instalar e configurar o Hermes Agent em sua máquina local.

Nota: Se você já tem o Hermes Agent configurado localmente, pode pular para a próxima seção.

Nos próximos dois capítulos, você verá como integrar a Bright Data ao Hermes Agent usando MCP e Agent Skills, respectivamente.

Pré-requisitos

Certifique-se de ter:

• Uma chave de API de um dos provedores de LLM suportados pelo Hermes Agent. Aqui, usaremos uma chave de API da OpenAI.
• Uma conta em um dos muitos canais de comunicação suportados pelo Hermes Agent. Abaixo, vamos conectá-lo ao Telegram. Siga o guia oficial para criar um bot do Telegram e obter seu token de bot.

Passo #1: Instalar o Hermes Agent

Para instalar a versão de linha de comando do Hermes Agent no Linux, macOS ou WSL 2, execute:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

No Windows, execute:

iex (irm https://hermes-agent.nousresearch.com/install.ps1) 

Consulte o guia de início rápido oficial para instruções adicionais de instalação.

Abordagem alternativa: Para instalar tanto os aplicativos de linha de comando quanto os de desktop, baixe o instalador do Hermes Desktop do site oficial e execute-o.

Esta é a saída do instalador CLI do Hermes Agent:

Como você pode ver, o instalador gerencia automaticamente todos os pré-requisitos exigidos pelo Hermes Agent, incluindo uv, Python 3.11, Node.js, ripgrep, ffmpeg e mais.

Ótimo! O Hermes Agent agora está instalado localmente.

Passo #2: Configurar o Hermes

O instalador CLI irá guiá-lo pelo processo de configuração do Hermes Agent. Para mais controle sobre a configuração, selecione a opção “Full setup”:

Nota: Se você já tem o OpenClaw instalado localmente e o integrou com a Bright Data, pode escolher a opção de importar configurações do OpenClaw.

Em seguida, você será solicitado a selecionar um provedor de IA para alimentar o Hermes Agent. Escolha o provedor para o qual você tem uma chave de API. Neste caso, vamos conectar um modelo da OpenAI. Portanto, selecione “OpenAI”:

Escolha a opção “OpenAI API”:

Cole sua chave de API da OpenAI e, em seguida, selecione o modelo padrão (por exemplo, gpt-5.4-mini):

Continue com o processo de configuração. Você pode deixar as opções restantes inalteradas e pular a configuração do canal de comunicação por enquanto, pois você cuidará disso em uma etapa posterior.

Ótimo! O Hermes Agent agora está configurado e pronto para ser lançado.

Passo #3: Lançar o Painel Web

Para acessar o painel web do Hermes Agent, execute o seguinte comando:

hermes dashboard

O painel web estará disponível em:

http://127.0.0.1:9119

Abra a URL acima no seu navegador e você deverá ver:

Fantástico! A partir daqui, você pode controlar e gerenciar visualmente sua instância do Hermes Agent.

Passo #4: Conectar o Telegram

No painel web do Hermes Agent, acesse a página “Channels” e configure seu canal de comunicação preferido. Nesta configuração, usaremos o Telegram.

No card “Telegram”, prossiga selecionando o fluxo de trabalho “CREATE WITH QR” ou “MANUAL SETUP”.

Durante o processo, você será solicitado a inserir seu token de bot do Telegram.

Após concluir a configuração, reinicie o gateway de mensagens do Hermes quando solicitado:

Se você não estiver familiarizado com ele, o gateway de mensagens do Hermes permite que você converse com seu agente de IA em mais de 25 plataformas suportadas.

Uma vez configurado, o status do canal “Telegram” mudará para “Connected”:

Em seguida, abra o Telegram. Use o comando abaixo para iniciar o bot conectado à sua instância local do Hermes Agent (neste exemplo, o bot se chama “My Hermes Agent”):

/start

Você receberá uma mensagem contendo um comando de pareamento para vincular o Telegram à sua instância local do Hermes Agent:

No seu terminal, execute o comando recebido:

hermes pairing approve telegram <PAIRING_CODE>

Maravilhoso! O Telegram agora está totalmente conectado e pareado com sua configuração do Hermes Agent. Você pode começar a conversar com seu agente de IA diretamente no Telegram.

Passo #5: Testar a Integração

Cumprimente o agente de IA pelo Telegram enviando uma mensagem como:

Hey!

O Hermes pedirá que você defina o canal do Telegram atual como seu canal principal, que é onde o agente entregará as respostas. Confirme com a seguinte mensagem:

/sethome 

Após concluir esta etapa, o Hermes Agent responderá à sua mensagem de saudação original com algo parecido com isso:

Missão cumprida! O Hermes Agent agora está instalado, configurado localmente e conectado a um bot do Telegram, permitindo que você converse facilmente com ele.

Como Conectar o Hermes Agent ao Web MCP da Bright Data

Nesta seção, você será guiado pela configuração do Web MCP da Bright Data no Hermes Agent.

Pré-requisitos

Antes de prosseguir com a configuração, certifique-se de ter uma conta na Bright Data com uma chave de API configurada. Siga a documentação para gerar sua chave de API da Bright Data.

Embora não seja estritamente necessário, você também deve ter:

• Um entendimento básico de como o MCP funciona.
• Familiaridade com as ferramentas fornecidas pelo Web MCP da Bright Data.

Passo #1: Testar o Web MCP da Bright Data Localmente

Antes de conectar o Web MCP da Bright Data ao Hermes Agent, verifique se o servidor MCP é executado na sua máquina.

Comece instalando o pacote Web MCP globalmente usando @brightdata/mcp:

npm install -g @brightdata/mcp

No Linux, macOS ou WSL, verifique se o servidor MCP inicia corretamente com:

API_TOKEN="<YOUR_BRIGHT_DATA_API>" npx -y @brightdata/mcp

Ou, no PowerShell, execute:

$Env:API_TOKEN="<YOUR_BRIGHT_DATA_API>"; npx -y @brightdata/mcp

Substitua <YOUR_BRIGHT_DATA_API> pela sua chave de API real da Bright Data. Este comando define a variável de ambiente API_TOKEN necessária e inicia o servidor Web MCP localmente. Para mais informações, consulte a documentação do Web MCP.

Se tudo estiver configurado corretamente, você deverá ver logs de inicialização como estes:

Na primeira execução, o pacote @brightdata/mcp cria automaticamente duas APIs na sua conta da Bright Data:

• mcp_unlocker: Usado para se conectar ao Web Unlocker API e à API SERP da Bright Data.
• mcp_browser: Usado para interagir com o Browser API da Bright Data.

Essas APIs alimentam as 70+ ferramentas expostas pelo servidor Web MCP da Bright Data. Você também pode configurar APIs personalizadas, conforme descrito no repositório oficial.

Para verificar se as APIs padrão foram criadas com sucesso, abra a seção “Web Access > Web Access API” no painel de controle da Bright Data. Você deverá ver ambas as APIs listadas na tabela “My APIs”:

Por padrão, o servidor Web MCP inicia no modo Rapid (nível gratuito), que fornece acesso a um conjunto limitado de ferramentas. Para desbloquear todas as 70+ ferramentas, habilite o modo Pro definindo a variável de ambiente PRO_MODE=true:

API_TOKEN="<YOUR_BRIGHT_DATA_API>" PRO_MODE="true" npx -y @brightdata/mcp

Ou, no Windows PowerShell, execute:

$Env:API_TOKEN="<YOUR_BRIGHT_DATA_API>"; $Env:PRO_MODE="true"; npx -y @brightdata/mcp

Nota: O modo Pro [gera cobranças adicionais](https://github.com/brightdata/brightdata-mcp?tab=readme-ov-file#-pricing, modes).

Ótimo! Você testou o Web MCP da Bright Data localmente. No próximo passo, você o integrará ao Hermes Agent.

Passo #2: Configurar o Web MCP no Hermes

Retorne ao painel web do Hermes Agent e abra a página “MCP”. Clique no botão “ADD SERVER” para configurar uma nova conexão MCP:

Para a integração do Web MCP da Bright Data, preencha o modal “ADD MCP SERVER” da seguinte forma:

• NAME: bright-data-web-mcp
• TRANSPORT: stdio
• COMMAND: npx
• ARGS: @brightdata/mcp
• ENVIRONMENT (KEY=VALUE PER LINE):

API_TOKEN=<YOUR_BRIGHT_DATA_API_KEY>
PRO_MODE=true

Esta configuração instrui o Hermes a se conectar ao servidor MCP da Bright Data via npx -y @brightdata/mcp enquanto define essas duas variáveis de ambiente:

• API_TOKEN (obrigatório): Defina como sua chave de API da Bright Data.
• PRO_MODE (opcional): Defina como true para habilitar o modo Pro. Defina como false ou remova PRO_MODE=true para executar o Web MCP no modo Rapid.

Confirme clicando em “ADD”. O Hermes Agent agora tem todas as informações necessárias para iniciar o servidor Web MCP da Bright Data localmente (usando o mesmo comando explorado na etapa anterior) e se conectar a ele. Legal!

Passo #3: Verificar se a Integração Funciona

Após adicionar o servidor MCP, um card bright-data-web-mcp aparecerá na página MCP:

Se você configurou o Web MCP no modo Pro, verá todas as 70+ ferramentas do Web MCP disponíveis. Caso contrário, o Hermes Agent terá acesso apenas ao conjunto limitado de ferramentas incluídas no nível gratuito (modo Rapid).

Isso confirma que o Hermes Agent pode ver as ferramentas do Web MCP da Bright Data. Mais adiante neste tutorial, você verá a integração do Web MCP da Bright Data + skills em ação.

Como Ampliar o Conhecimento do Hermes Agent com as Bright Data Agent Skills

Aqui, você verá como adicionar as skills da Bright Data ao Hermes Agent via ferramenta skills da Vercel.

Pré-requisitos

Antes de seguir esta seção, verifique se você atende a estes requisitos:

• Você está operando em um SO baseado em UNIX (por exemplo, Linux, macOS ou WSL 2).
• A CLI da Bright Data está instalada e configurada localmente (este é o principal pré-requisito para as skills da Bright Data). Para uma configuração rápida da CLI da Bright Data, consulte a página de documentação Bright Data CLI: Instalação & Configuração. Ou leia o post dedicado do blog.
• Node.js está instalado localmente.

Além disso, é recomendável ter:

• Algum conhecimento do padrão Agent Skills.
• Familiaridade com a ferramenta CLI skills da Vercel.
• Um entendimento básico do que as skills da Bright Data fornecem.

Abordagem alternativa de instalação: Se preferir instalar as Bright Data Agent Skills manualmente em vez de usar a CLI skills, comece clonando o repositório de Skills da Bright Data. Em seguida, copie as skills da Bright Data para o diretório de skills do Hermes Agent ~/.hermes/skills/ (%USERPROFILE%\.hermes\skills\ no Windows):

git clone https://github.com/brightdata/skills
cp -r skills/skills/* ~/.hermes/skills/

Caso contrário, siga as etapas de instalação automatizada abaixo!

Passo #1: Instalar as Bright Data Agent Skills

Para instalar as skills de agente da Bright Data no Hermes Agent por meio da CLI skills, execute:

npx skills add brightdata/skills -a hermes-agent

O comando acima:

1. Instala o skills.
2. Inicia um assistente CLI para baixar as skills da Bright Data do Diretório de Agent Skills e instalá-las no Hermes.

Primeiro, você será solicitado a selecionar quais skills da Bright Data instalar:

Alterne cada skill com a barra de Espaço para selecioná-las todas, depois pressione Enter. O skills perguntará se você deseja instalá-las para o projeto atual ou globalmente.

Escolha a opção “Global”:

Revise a avaliação de segurança e confirme a instalação. Você verá uma mensagem final como a seguinte:

Incrível! As skills da Bright Data foram copiadas para o diretório de skills do Hermes Agent.

Passo #2: Verificar se as Skills Estão Disponíveis

Reinicie o Hermes Agent. Abra o painel web, navegue até a página “SKILLS” e pesquise por “bright data”:

Você deverá ver todas as skills de agente da Bright Data que acabaram de ser instaladas.

As skills são habilitadas por padrão, portanto o Hermes Agent pode usá-las imediatamente sempre que forem relevantes para uma tarefa. Vamos lá!

Hermes Agent + Bright Data: Testando a Integração

Para testar os recursos de acesso web de nível empresarial que a Bright Data traz ao Hermes Agent, você precisa de um caso de uso realista.

Suponha que você seja um criador de conteúdo no YouTube e queira transformar o Hermes Agent em seu assistente pessoal do YouTube. Isso é possível graças às capacidades de scraping e navegação web da Bright Data, juntamente com as ferramentas premium específicas do YouTube expostas pelo Web MCP (alimentadas pelo Scraper do YouTube da Bright Data):

Ferramenta Web MCP Pro	Descrição
web_data_youtube_videos	Recupera metadados estruturados de um vídeo do YouTube a partir de sua URL sem fazer scraping da página.
web_data_youtube_profiles	Recupera informações estruturadas sobre um canal do YouTube a partir de sua URL sem scraping.
web_data_youtube_comments	Recupera comentários estruturados de um vídeo do YouTube, com um limite opcional no número de comentários.

O Web MCP da Bright Data permite que o Hermes Agent navegue pelo YouTube e recupere estatísticas e dados de canais e vídeos.

Abaixo, você usará sua configuração do Hermes aprimorada com Bright Data para recuperar estatísticas de um vídeo do YouTube. Em seguida, o agente analisará os comentários do vídeo para identificar o sentimento do público, destacar feedbacks valiosos e sugerir ideias para vídeos futuros.

Veja como fazer isso!

Passo #1: Fornecer ao Agente o Contexto Inicial

Antes de começar, desative a skill integrada youtube-content:

Ao interagir com o YouTube, você quer que o Hermes Agent utilize as ferramentas do Web MCP da Bright Data. Estas são mais confiáveis, escaláveis e fornecem dados mais ricos.

Em seguida, dê um papel ao seu agente enviando esta mensagem:

From now on, keep in mind that you're my YouTube assistant. I want you to help me grow my channel by providing advice on how to better engage my audience, improve my content, and increase my reach.

O Hermes Agent atualizará sua memória e responderá com uma confirmação semelhante a esta:

Agora, instrua o agente a sempre usar o Web MCP da Bright Data quando o acesso à web for necessário:

When I ask you to retrieve information from the web, search the internet, or interact with web pages, use the Bright Data Web MCP.

Dica profissional: Considere desativar as ferramentas integradas de busca na web e navegação do Hermes Agent. Uma vez configurado o Web MCP, ele fornece uma alternativa mais poderosa e abrangente.

Passo #2: Recuperar as Estatísticas do Vídeo do YouTube

Suponha que você seja o autor deste vídeo do YouTube sobre o Hermes Agent:

Você quer analisar seu desempenho e decidir se faz sentido criar vídeos de acompanhamento. Comece pedindo ao seu agente para recuperar as principais estatísticas do vídeo:

Retrieve the main information and stats from my latest YouTube video about Hermes Agent:
https://www.youtube.com/watch?v=5_N84t1rUU0

O agente começará chamando algumas ferramentas:

Mais especificamente, o Hermes Agent executou estas ações:

1. Usou tool_search para encontrar a ferramenta mais adequada para a tarefa.
2. Identificou a ferramenta Web MCP web_data_youtube_videos (disponível apenas no modo Pro) como a ferramenta apropriada.
3. A chamou com a URL do YouTube fornecida.

Se você abrir o painel web do Hermes, navegar até a página “SESSIONS”, abrir o histórico da sessão e rolar pelas mensagens, encontrará uma mensagem relacionada à chamada da ferramenta web_data_youtube_videos:

A ferramenta retorna dados estruturados do YouTube extraídos diretamente do vídeo e formatados como JSON pronto para LLM.

Após processar esses dados, o Hermes Agent produz uma resposta como a seguinte:

Na resposta do agente, você pode ver claramente métricas-chave como visualizações, data de publicação e outras informações úteis sobre o vídeo.

Passo #3: Analisar os Comentários do Vídeo do YouTube

Como o vídeo alcançou resultados impressionantes, o próximo passo é analisar seus comentários. Continue a conversa com uma mensagem como esta:

Wow, the video has performed really well! Now, scrape its comments and provide insights into the video's engagement level and the most important feedback I received. Give me also potential ideas for future videos based on the comments.

Novamente, o Hermes Agent identificará e usará a ferramenta mais adequada para a tarefa:

O agente chamou a ferramenta Web MCP web_data_youtube_comments para fazer scraping dos últimos 100 comentários do vídeo do YouTube.

Após analisá-los, o Hermes Agent forneceu uma seção detalhada de análise de sentimentos juntamente com 20 ideias potenciais de vídeos inspiradas no feedback do público:

Et voilà! Isso demonstra o poder de uma configuração do Hermes Agent aprimorada com a Bright Data. Tenha em mente que este é apenas um exemplo simples. A integração abre portas para muitos outros casos de uso poderosos envolvendo dados web, automação e agentes de IA.

Conclusão

Neste post do blog, você aprendeu o que é o Hermes Agent e como ele viabiliza fluxos de trabalho autônomos de IA. Em particular, você explorou como estender suas capacidades conectando-o ao Web MCP e às skills oficiais da Bright Data.

Ao se integrar com a Bright Data, o Hermes Agent obtém acesso total, irrestrito e escalável a dados web públicos e ferramentas avançadas de interação web. Para mais detalhes, explore a gama completa de serviços prontos para IA disponíveis no ecossistema da Bright Data.

Crie uma conta gratuita na Bright Data hoje e dê aos seus agentes de IA acesso em tempo real à web!