Google Search Console, Bing e GA4 no Hermes Agent

O Hermes Agent se conecta a servidores MCP remotos em HTTP e cuida do OAuth 2.1 sozinho: registro dinâmico do cliente, PKCE e callback em uma porta local de loopback, que o GSC Magic aceita.

Última atualização: 2026-10-30

Em resumo

Adicione uma entrada gsc-magic com url https://mcp.gscmagic.com/mcp e auth: oauth a ~/.hermes/config.yaml, reinicie o Hermes, permita o acesso na página do GSC Magic que abrir, e o Hermes pode consultar seus dados de Search Console, Bing e GA4.

Configuração em 4 passos

  1. Crie uma conta no GSC Magic, conecte o Google e importe seus sites.
  2. Adicione o trecho a ~/.hermes/config.yaml (mescle em um bloco mcp_servers existente).
  3. Reinicie o Hermes. Na primeira conexão ele imprime um link de login e abre o navegador; permita o acesso na página do GSC Magic.
  4. Peça ao Hermes para listar suas propriedades do Search Console.
~/.hermes/config.yaml
mcp_servers:
  gsc-magic:
    url: "https://mcp.gscmagic.com/mcp"
    auth: oauth

Bom saber

  • O login usa OAuth: o cliente abre uma página do GSC Magic onde você entra e aprova uma única vez. Sem chave de API nem token para colar.
  • No Free, seu agente só pode ler. No Pro e no Agency, as ferramentas de escrita ficam disponíveis, e o proprietário pode desativar o modo de escrita em Configurações com um clique.

O que perguntar depois de conectar

  • “Liste minhas propriedades do Search Console e a que teve mais cliques nos últimos 28 dias.”
  • “Quais consultas estão nas posições 4–10 com mais impressões? Sugira mudanças de título.”
  • “Compare os cliques deste mês com os do mês passado por página e diga o que mudou.”
  • “Quais URLs do meu sitemap não estão indexadas e o que diz a inspeção?”
  • “Quantas sessões vieram do ChatGPT, do Perplexity e do Claude no mês passado, e para quais páginas?”

Mais em 25 prompts de SEO para agentes de IA; a lista completa de ferramentas está na página de ferramentas.

Solução de problemas

O Hermes roda em um servidor sem interface e o callback nunca chega.

Abra o link impresso no seu computador, aprove, copie a URL completa em que o navegador termina (ela mostra um erro de conexão, o que é esperado) e cole no prompt do Hermes. O Hermes Desktop repassa o callback automaticamente.

Prefiro não usar OAuth.

Crie um token de acesso no painel e substitua auth: oauth por headers: { Authorization: "Bearer gsm_…" } na entrada gsc-magic, depois reinicie o Hermes.

O Hermes pede login de novo.

Os tokens ficam em cache em ~/.hermes/mcp-tokens/gsc-magic.json. Se a renovação falhar, rode hermes mcp login gsc-magic.

Perguntas sobre Hermes Agent

O Hermes precisa de um app OAuth próprio para o GSC Magic?

Não. O GSC Magic aceita registro dinâmico de cliente, então o Hermes se registra sozinho.

Outros clientes

Claude · ChatGPT · Claude Code · Cursor · Windsurf · VS Code · Qualquer cliente MCP · Gemini CLI · Zed · Cline · Continue · n8n · LibreChat · goose · Warp · Raycast · OpenClaw · Grok