Hermes Agent + Bright Data: Construindo o Assistente de IA Web-Aware 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 Bright Data 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 possibilita por meio de um exemplo prático do mundo real.

Vamos começar!

O que é o Hermes Agent?

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

O Hermes pode ser executado localmente em sua máquina ou continuamente em um servidor ou VPS, tornando-o 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 tem forte suporte da comunidade, com muitos plugins e integrações. É totalmente open-source sob a licença MIT, enquanto opções premium gerenciadas estão disponíveis através do Hermes Cloud.

Principais Recursos

As principais capacidades fornecidas pelo Hermes Agent são:

• Memória persistente: Lembra preferências, projetos, ambientes e informações aprendidas em 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: Permite 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 do 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 da 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 aborda 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 escala 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 à Bright Data, o agente obtém acesso a ferramentas prontas para empresas para busca na 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, recursos de bypass anti-bot e o desempenho necessários para fluxos de trabalho de dados web do mundo real. 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 Bright Data 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 ajudam 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 detalhe, as skills da Bright Data podem orientar o Hermes na seleção e uso das ferramentas Bright Data MCP mais apropriadas. Além disso, fornecem melhores práticas gerais para aprimorar o conhecimento sobre o uso dos produtos da Bright Data.

Bright Data Bright Data MCP

Bright Data 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 comuns na web:

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 da web em Markdown limpo com tratamento de proteção contra bots.
discover	Realiza busca com IA retornando resultados web relevantes e classificados.

Para obter todas as 70+ ferramentas, você precisa [ativar 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 API de Navegador 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 os agentes a configurar integrações da Bright Data e escolher a configuração correta.
search	Pesquisa no Google e retorna resultados de busca estruturados.
scrape	Faz scraping de páginas da web em Markdown limpo enquanto ignora a proteção contra bots.
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 na web.
bright-data-best-practices	Fornece orientações para APIs e integrações da Bright Data.
live-research	Cria relatórios de pesquisa usando dados da web ao vivo.
competitive-intel	Realiza análise de concorrentes usando dados da web ao vivo.
brand-listening	Analisa menções de marca e sentimento do público.
price-comparison	Compara preços entre varejistas online.
seo-audit	Realiza auditorias de SEO usando dados da 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.

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 de instalação adicionais.

Abordagem alternativa: Para instalar tanto a versão de linha de comando quanto a aplicação desktop, baixe o instalador do Hermes Desktop no site oficial e execute-o.

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

Como você pode ver, o instalador lida automaticamente com 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 ter 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 vez disso.

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 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 sem alterações 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 iniciado.

Passo #3: Iniciar 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 em 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 cartão “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 assim:

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 Bright Data MCP da Bright Data

Nesta seção, você será guiado pela configuração do Bright Data 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 Bright Data MCP da Bright Data.

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

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

Comece instalando o pacote Bright Data 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 Bright Data MCP localmente. Para mais informações, consulte a documentação do Bright Data 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 em sua conta da Bright Data:

• mcp_unlocker: Usado para se conectar à API Web Unlocker e à API SERP da Bright Data.
• mcp_browser: Usado para interagir com a API de Navegador da Bright Data.

Essas APIs alimentam as 70+ ferramentas expostas pelo servidor Bright Data 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 Bright Data MCP inicia no modo Rapid (nível gratuito), que fornece acesso a um conjunto limitado de ferramentas. Para desbloquear todas as 70+ ferramentas, ative 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 Bright Data MCP da Bright Data localmente. Na próxima etapa, você o integrará ao Hermes Agent.

Passo #2: Configurar o Bright Data 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 Bright Data 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 estas 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 ativar o modo Pro. Defina como false ou remova PRO_MODE=true para executar o Bright Data MCP no modo Rapid.

Confirme clicando em “ADD”. O Hermes Agent agora tem todas as informações necessárias para iniciar o servidor Bright Data 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 cartão bright-data-web-mcp aparecerá na página MCP:

Se você configurou o Bright Data MCP no modo Pro, verá todas as 70+ ferramentas do Bright Data 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 Bright Data MCP da Bright Data. Mais adiante neste tutorial, você verá a integração do Bright Data MCP da Bright Data + skills em ação.

Como Expandir 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 a seção, verifique se você atende a estes requisitos:

• Você está operando em um sistema operacional 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 e Configuração. Caso contrário, leia o post dedicado no blog.
• Node.js está instalado localmente.

Além disso, é recomendado ter:

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

Abordagem de instalação alternativa: 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 de 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 selecionar todas e, em seguida, 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 Bright Data MCP (alimentadas pelo Scraper do YouTube da Bright Data):

Ferramenta Pro do Bright Data MCP	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 Bright Data MCP da Bright Data permite que o Hermes Agent navegue no YouTube e recupere estatísticas e dados de canais e vídeos.

Abaixo, você usará sua configuração do Hermes aprimorada com a 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 Bright Data 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 similar a esta:

Agora, instrua o agente a sempre depender do Bright Data 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 Bright Data MCP.

Dica profissional: Considere desativar as ferramentas integradas de busca na web e navegação do Hermes Agent. Uma vez que o Bright Data MCP esteja configurado, 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 realizou estas ações:

1. Usou tool_search para encontrar a ferramenta mais adequada para a tarefa.
2. Identificou a ferramenta Bright Data 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. Você 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:

A partir da resposta do agente, você pode ver claramente métricas-chave como visualizações, data de publicação e outras informações úteis do 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 Bright Data 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 sentimento junto 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 as 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 permite fluxos de trabalho autônomos de IA. Em particular, você explorou como estender suas capacidades conectando-o ao Bright Data MCP e às skills oficiais da Bright Data.

Ao integrar com a Bright Data, o Hermes Agent obtém acesso total, irrestrito e escalável a dados públicos da web 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 na Bright Data gratuitamente hoje e dê aos seus agentes de IA acesso em tempo real à web!