Como configurar seu primeiro Hermes SEO Agent

O que você vai construir

Este tutorial ajuda você a criar um primeiro Hermes SEO Agent seguro o suficiente para um iniciante usar. Ele não vai publicar páginas, alterar seu site nem tocar em configurações técnicas de SEO. Ele vai criar arquivos estruturados: um resumo do site, regras de aprovação, papéis do agente, um brief de conteúdo e um checklist de QA.

O objetivo não é automatizar só por automatizar. O objetivo é dar ao Hermes contexto e limites suficientes para que ele ajude em trabalho real de SEO sem ficar adivinhando. Ao final, você deve ter um workspace pequeno que apoie pesquisa de palavras-chave, briefs de conteúdo, planos de atualização de páginas, diagnóstico de CTR baixo, sugestões de links internos e mapeamento de prompts GEO.

Comece pequeno. Se o primeiro agente não consegue escrever um brief claro e explicar seus riscos, ele ainda não está pronto para tocar em páginas ativas.

O que você precisa antes de começar

Você não precisa de uma stack de dados complexa para a primeira configuração. Precisa de acessos básicos e algumas decisões.

Use o quickstart oficial do Hermes como referência de setup. A documentação pública é o lugar certo para confirmar etapas de instalação, ferramentas suportadas, opções de modelo e detalhes específicos da plataforma antes de executar qualquer coisa localmente.

Legenda: Comece pelo quickstart oficial do Hermes; depois adicione arquivos de projeto específicos de SEO e regras de aprovação antes de rodar tarefas de crescimento.

Passo 1: crie o workspace do agente de SEO

Crie uma pasta dedicada para este projeto. Não misture com downloads aleatórios, arquivos de clientes ou rascunhos antigos.

Estrutura recomendada:

/hermes-seo-agent
/context
brand.md
website.md
audience.md
competitors.md
content-rules.md
/data
README.md
gsc-export.csv
bing-webmaster-export.csv
ga4-landing-pages.csv
crawl-export.csv
/briefs
/drafts
/qa
content-quality-gate.md
technical-risk-gate.md
/reports
/prompts
system-prompt.md
first-brief-prompt.md
qa-prompt.md
approval-rules.md

Se você está testando em seu próprio site, crie isso em um diretório normal de projeto. Se trabalha com clientes, crie um workspace por cliente. Não deixe Hermes misturar o contexto de um site com os dados de outro.

Adicione um data/README.md curto para que você, no futuro, lembre o que entra ali:

# Pasta de dados

Esta pasta armazena arquivos exportados de SEO e analytics.

Arquivos permitidos:
- Exportações do Google Search Console
- Exportações do Bing Webmaster Tools
- Relatórios de landing pages do GA4
- Exportações de crawl
- Exportações de rank tracking
- Exportações de visibilidade em IA ou tracking de prompts

Regras:
- Não adicione dados privados de clientes.
- Anonimize receita ou dados de leads sensíveis se eles não forem necessários.
- Inclua a data de exportação nos nomes de arquivo quando possível.
- Hermes não deve inventar métricas ausentes.

Passo 2: escreva o arquivo de contexto da marca

Hermes precisa de contexto antes de tomar decisões úteis de SEO. Sem contexto, ele vai produzir conselhos genéricos como "escreva conteúdo de alta qualidade" ou "otimize para intenção de busca". Isso não ajuda muito.

Crie context/brand.md:

# Contexto da marca

Nome da marca:
Site:
Produto ou serviço principal:
Descrição curta:
Clientes-alvo:
Dores dos clientes:
Meta principal de conversão:
Metas secundárias de conversão:
Mercados atendidos:
Idiomas:
Tom da marca:
Tópicos que queremos dominar:
Tópicos que devemos evitar:
Provas que podemos usar:
Afirmações que não podemos fazer:

Exemplo:

# Contexto da marca

Nome da marca: Acme Analytics
Site: https://example.com
Produto ou serviço principal: Software de analytics para pequenas equipes B2B SaaS
Descrição curta: Ajuda founders a monitorar cadastros de produto, ativação e pipeline gerado por conteúdo em um único dashboard.
Clientes-alvo: Founders de B2B SaaS, líderes de crescimento e profissionais de content marketing em equipes de 5 a 50 pessoas.
Dores dos clientes: Eles publicam conteúdo, mas não conseguem conectar tráfego orgânico a cadastros e pipeline.
Meta principal de conversão: Cadastro para trial gratuito
Metas secundárias de conversão: Pedido de demo, assinatura da newsletter
Mercados atendidos: Estados Unidos, Reino Unido, Canadá, Austrália
Idiomas: Inglês
Tom da marca: Claro, prático, amigável para founders, sem linguagem corporativa
Tópicos que queremos dominar: SEO analytics, atribuição de conteúdo, relatórios de crescimento product-led
Tópicos que devemos evitar: BI corporativo, atribuição de mídia paga, previsão financeira
Provas que podemos usar: Screenshots do produto, exemplos de workflows anonimizados, documentação pública de ajuda
Afirmações que não podemos fazer: Crescimento de receita garantido, melhoria garantida de ranking

Mantenha esse arquivo factual. Não deixe Hermes inventar posicionamento. Se uma linha for desconhecida, escreva TODO.

Passo 3: escreva o arquivo de contexto do site

Crie context/website.md:

# Contexto do site

Homepage:
Principais páginas de produto:
Blog ou hub de recursos principal:
Páginas importantes de conversão:
Páginas SEO existentes:
Páginas fracas conhecidas:
Problemas técnicos conhecidos:
CMS:
Workflow de publicação:
Quem aprova conteúdo:
Quem aprova mudanças técnicas:

Exemplo:

# Contexto do site

Homepage: https://example.com/
Principais páginas de produto:
- https://example.com/product
- https://example.com/pricing
- https://example.com/integrations

Blog ou hub de recursos principal:
- https://example.com/blog

Páginas importantes de conversão:
- https://example.com/demo
- https://example.com/signup

Páginas SEO existentes:
- /blog/seo-dashboard-template
- /blog/content-attribution-guide
- /blog/ga4-for-saas-founders

Páginas fracas conhecidas:
- /blog/old-content-roi-guide, exemplos desatualizados
- /integrations/google-search-console, texto raso

Problemas técnicos conhecidos:
- Alguns posts antigos do blog estão sem meta descriptions
- Vários redirects da migração de 2024 ainda precisam de revisão

CMS: Webflow
Workflow de publicação: Rascunho em Markdown, edição no Google Docs, publicação no Webflow
Quem aprova conteúdo: Líder de marketing
Quem aprova mudanças técnicas: Desenvolvedor

Esse arquivo ajuda Hermes a separar trabalho de conteúdo de trabalho técnico. Isso importa. Uma reescrita de title e uma mudança de canonical não devem passar pelo mesmo caminho de aprovação.

Passo 4: defina regras de aprovação antes de atribuir tarefas

Crie approval-rules.md na pasta raiz:

# Regras de aprovação

Hermes pode fazer isto sem aprovação:
- Ler arquivos de contexto do projeto.
- Analisar dados SEO exportados.
- Criar briefs de conteúdo.
- Rascunhar relatórios internos.
- Sugerir testes de title e meta.
- Sugerir oportunidades de links internos.
- Sinalizar riscos técnicos de SEO.

Hermes precisa de aprovação de conteúdo antes de:
- Escrever um artigo público completo.
- Reescrever uma página ativa.
- Alterar title tags ou meta descriptions.
- Adicionar afirmações, estatísticas ou comparações.
- Adicionar links internos em páginas públicas.

Hermes precisa de aprovação técnica antes de:
- Alterar robots.txt.
- Alterar arquivos de sitemap.
- Adicionar ou remover noindex.
- Alterar canonicals.
- Adicionar redirects.
- Editar dados estruturados.
- Enviar URLs para indexação.

Hermes nunca deve:
- Publicar diretamente no CMS.
- Inventar dados.
- Inventar citações.
- Prometer rankings garantidos ou citações garantidas em IA.
- Criar páginas em massa apenas para mirar palavras-chave.
- Usar dados privados de clientes em conteúdo público.

Agora adicione a regra de saída:

# Formato obrigatório de recomendação

Toda recomendação deve incluir:
- URL ou nome da página
- Evidência
- Ação sugerida
- Impacto em SEO
- Impacto em GEO
- Nível de risco: baixo, médio, alto
- Aprovação necessária: sim/não
- Sugestão de responsável

Um agente de SEO para iniciantes nunca deve ser pouco claro sobre risco. Se Hermes não consegue explicar por que uma recomendação é segura, ela não deve avançar.

Passo 5: defina primeiro um único papel de agente

Não comece com cinco agentes. Comece com um papel: o operador SEO supervisionado.

Crie prompts/system-prompt.md:

Você é um operador supervisionado de SEO/GEO para este site.

Seu trabalho é ajudar com SEO, GEO, AEO, visibilidade em busca com IA, planejamento de conteúdo, revisão técnica de SEO e diagnóstico de desempenho.

Você trabalha a partir dos arquivos do projeto. Deve ler os arquivos de contexto antes de fazer recomendações.

Regras operacionais:
- Não publique nem edite páginas ativas.
- Não invente métricas, fatos, citações ou resultados de clientes.
- Se os dados estiverem ausentes, escreva "ausente".
- Separe impacto em SEO de impacto em GEO.
- Marque mudanças técnicas como alto risco, a menos que um desenvolvedor as aprove.
- Use as regras de aprovação em approval-rules.md.
- Prefira uma próxima ação pequena e baseada em evidências a uma grande estratégia vaga.

Formato padrão de saída:
- Resumo
- Evidências revisadas
- Ações recomendadas
- Riscos
- Aprovação necessária
- Próximo arquivo a criar

Esse papel é estreito de propósito. Depois, você pode dividi-lo em Researcher, Writer, Editor, Technical QA e Publisher. Na primeira semana, um operador supervisionado é mais fácil de depurar.

Passo 6: adicione o primeiro prompt de brief de conteúdo

Crie prompts/first-brief-prompt.md:

Crie um brief de conteúdo SEO/GEO seguro para iniciantes para este tópico:
[INSIRA O TÓPICO]

Antes de escrever, leia:
- context/brand.md
- context/website.md
- context/audience.md se existir
- approval-rules.md

Não escreva o artigo completo.
Não invente dados.
Se dados de SEO estiverem ausentes, marque como ausente.

Retorne:
1. Título de trabalho
2. Leitor-alvo
3. Intenção de busca
4. Intenção de prompt GEO
5. Palavra-chave principal
6. Perguntas relacionadas
7. Entidades que precisam ser explicadas claramente
8. Estrutura recomendada da página
9. Evidências e fontes necessárias
10. Oportunidades de links internos
11. Title tag sugerida
12. Meta description sugerida
13. Riscos e requisitos de aprovação
14. Próximo passo após aprovação

Agora rode isso com um tópico seguro. Escolha algo de baixo risco, como um artigo educacional. Evite precificação, temas legais, médicos, financeiros ou afirmações de alto risco.

Exemplo de tópico:

Como equipes B2B SaaS podem conectar dados do Google Search Console com relatórios de landing pages do GA4

Uma boa saída deve ser específica. Uma saída fraca dirá coisas como "otimize para SEO" sem mostrar leitor, tipo de página, evidência ou risco.

Passo 7: revise o primeiro brief antes de rascunhar

Crie qa/brief-quality-gate.md:

# Quality gate de brief

Um brief de conteúdo só está pronto se:

- [ ] O leitor-alvo é específico.
- [ ] A intenção de busca está clara.
- [ ] A intenção de prompt GEO está clara.
- [ ] A palavra-chave principal é relevante para o negócio.
- [ ] As perguntas relacionadas são perguntas reais de leitores.
- [ ] A estrutura da página corresponde à intenção.
- [ ] As evidências necessárias estão listadas.
- [ ] Os links internos são relevantes, não forçados.
- [ ] Afirmações que precisam de verificação estão marcadas.
- [ ] Os requisitos de aprovação estão claros.

Depois peça ao Hermes para revisar o próprio brief:

Revise o brief de conteúdo contra qa/brief-quality-gate.md.

Retorne:
1. Aprovado/reprovado para cada item do checklist.
2. O que está vago demais.
3. O que pode ser arriscado.
4. Que informação está ausente.
5. Um brief revisado apenas se a primeira versão falhar.

Não pule isso. Iniciantes geralmente querem ir direto do prompt para o artigo. O brief é onde você captura suposições ruins enquanto ainda é barato corrigi-las.

Passo 8: adicione dados somente depois que o workflow funcionar

Quando Hermes conseguir criar e revisar um brief útil, adicione exportações.

Comece com estes arquivos:

/data/gsc-export-YYYY-MM-DD.csv
/data/bing-webmaster-export-YYYY-MM-DD.csv
/data/ga4-landing-pages-YYYY-MM-DD.csv
/data/crawl-export-YYYY-MM-DD.csv

Colunas mínimas:

Depois use este prompt:

Leia os arquivos em /data e crie um primeiro relatório de oportunidades de SEO.

Retorne:
1. Páginas com CTR baixo a partir de dados de busca.
2. Páginas com impressões, mas cliques fracos.
3. Páginas com tráfego orgânico, mas engajamento ou conversões fracas.
4. Páginas com problemas de crawl ou indexabilidade.
5. Páginas que talvez precisem de blocos de resposta mais claros para GEO.
6. As 5 principais ações recomendadas para esta semana.

Para cada ação, inclua evidência, risco e aprovação necessária.
Não invente dados.

É aqui que o agente começa a ficar útil. Ele pode parar de dar conselhos genéricos e começar a mostrar qual página merece atenção primeiro.

Passo 9: configure as três primeiras saídas recorrentes

No primeiro mês, peça ao Hermes apenas três arquivos recorrentes.

/reports/weekly-action-queue.md
/briefs/[topic-or-page].md
/qa/[page-or-draft]-qa.md

Use este ritmo operacional:

Isso não exige automação completa. Você pode rodar manualmente no começo. Manual é aceitável enquanto você aprende. A automação deve vir depois que o workflow estiver estável.

Passo 10: saiba quando seu agente está pronto para mais poder

Seu primeiro Hermes SEO Agent está pronto para tarefas mais avançadas somente quando passa nestas checagens:

Se ele falhar em qualquer uma dessas, não adicione acesso de publicação. Corrija o workflow primeiro.

Pacote inicial para copiar e colar

Se você quer apenas a configuração mínima, copie estes quatro arquivos.

context/brand.md

# Contexto da marca

Nome da marca:
Site:
Produto ou serviço:
Cliente-alvo:
Meta principal de conversão:
Mercados:
Idiomas:
Tópicos a dominar:
Tópicos a evitar:
Afirmações permitidas:
Afirmações proibidas:
Tom:

approval-rules.md

# Regras de aprovação

Hermes pode criar briefs, relatórios, recomendações e checklists de QA.
Hermes não pode publicar, editar páginas ativas, alterar configurações técnicas de SEO, inventar dados ou inventar citações.

Aprovação humana é obrigatória para:
- Atualizações de páginas ativas
- Mudanças de title/meta
- Adições de links internos
- Mudanças em dados estruturados
- Mudanças em robots, sitemap, canonical, noindex ou redirects
- Publicação no CMS
- Afirmações baseadas em fontes externas ou métricas

prompts/system-prompt.md

Você é um operador supervisionado de SEO/GEO.
Leia os arquivos de contexto antes de fazer recomendações.
Use approval-rules.md.
Não publique, edite páginas ativas nem invente dados.
Separe impacto em SEO de impacto em GEO.
Toda recomendação deve incluir evidência, risco e aprovação necessária.

prompts/first-brief-prompt.md

Crie um brief de conteúdo SEO/GEO para: [TÓPICO]

Retorne leitor-alvo, intenção de busca, intenção de prompt GEO, palavra-chave principal, perguntas relacionadas, entidades, estrutura da página, evidências necessárias, links internos, title tag, meta description, riscos e requisitos de aprovação.
Ainda não escreva o artigo.

A visão da Auspia

O primeiro Hermes SEO Agent deve parecer mais um operador júnior cuidadoso do que uma máquina mágica de conteúdo. Ele deve pedir contexto, marcar dados ausentes, produzir arquivos organizados e avisar quando aprovação é necessária.

Isso é suficiente para a primeira semana. Quando o setup funcionar, você pode conectar GSC, Bing Webmaster, GA4, dados de crawl e tracking de visibilidade em IA. Então Hermes pode passar de briefs de conteúdo para supervisão de dados e filas semanais de ações SEO/GEO.

Se a primeira configuração parecer controlada, tudo bem. Sistemas controlados são mais fáceis de confiar, melhorar e automatizar depois.

FAQ

Preciso de integrações por API para configurar um Hermes SEO Agent?

Não. Para a primeira configuração, use arquivos Markdown e exportações CSV. Integrações por API são úteis depois, mas não são obrigatórias para criar briefs, relatórios de QA, regras de aprovação e relatórios simples de oportunidades.

Qual deve ser a primeira tarefa de SEO do Hermes?

Comece com um brief de conteúdo ou um pequeno relatório de oportunidades. Não comece com publicação, mudanças técnicas de SEO ou uma reescrita completa do site.

Um único Hermes Agent pode cuidar de SEO e GEO juntos?

Sim, se as instruções separarem os dois. Peça ao Hermes para rotular impacto em SEO e impacto em GEO separadamente. SEO geralmente foca em consultas, páginas, rastreabilidade, snippets, links e desempenho. GEO foca em prompts, entidades, respostas claras, evidências e visibilidade em busca com IA.

Quando devo adicionar mais agentes ou um workflow swarm?

Adicione mais agentes somente depois que o operador supervisionado único produzir briefs e relatórios de QA confiáveis. Se o workflow base estiver bagunçado, adicionar papéis de Researcher, Writer, Editor, QA e Publisher só vai tornar a bagunça mais difícil de depurar.

O que nunca deve ser automatizado no setup iniciante?

Não automatize publicação, redirects, mudanças de noindex, alterações de canonical, edições de robots.txt, mudanças em dados estruturados ou envio de URLs. Essas ações precisam de revisão humana porque podem afetar indexação, tráfego e conversões.

Como sei que a configuração está funcionando?

A configuração está funcionando quando Hermes consegue ler seu contexto, produzir um brief específico, explicar dados ausentes, sinalizar riscos e criar uma próxima ação que uma pessoa possa aprovar ou rejeitar sem pedir uma reescrita completa.

Continue a série Hermes SEO/GEO

• Comece aqui: Guia do operador Hermes SEO/GEO .
• Guia anterior: Como usar Hermes Agent como operador de SEO/GEO .
• Próximo guia: Como conectar Hermes ao GSC, Bing Webmaster e GA4 .
• Relacionados: Como criar um workflow Hermes SEO/GEO Swarm , Como usar Hermes para uma auditoria técnica de SEO/GEO .

Autora: Clara Bennett, profissional de estratégia de conteúdo há 10 anos na Auspia. Clara escreve sobre sistemas editoriais, mapas de tópicos, operações de conteúdo repetíveis e workflows de produção SEO/GEO.