Google Search Console MCP

Search Console é o único conjunto de dados de marketing que é gratuito, de primeira parte e verdadeiro: o que o Google realmente exibiu para o seu site e o que as pessoas realmente clicaram. Ele também está preso atrás de uma interface que responde a uma pergunta por vez. Um servidor MCP muda isso. Você pergunta "quais páginas perderam cliques após a última atualização e quais consultas elas perderam", e o agente executa a comparação.

Nós mesmos executamos um servidor Search Console MCP para o nosso próprio site e para clientes. Este guia cobre o que existe, como configurar um e o que fazer com ele depois de conectado. A configuração para cada cliente está em Claude Code, Cursor e Claude Desktop.

Quais servidores existem

O Google não publicou um servidor oficial do Search Console. Vários servidores da comunidade encapsulam a API; os bons expõem quatro ou cinco ferramentas que mapeiam a pequena superfície da API:

• list_sites: as propriedades que a credencial pode ver.
• search_analytics: cliques, impressões, CTR e posição, filtrados e agrupados por consulta, página, país, dispositivo e data.
• compare_periods: a mesma consulta para dois intervalos de datas, com deltas.
• inspect_url: status de indexação, canônico, último rastreamento, usabilidade móvel para uma URL.
• list_sitemaps: sitemaps enviados e seu status.

Se um servidor oferecer muito mais do que isso, pergunte para quê. A API não faz muito mais, e um servidor pequeno é mais fácil de revisar.

Como a API é somente leitura, este é o servidor de marketing de menor risco que você pode adicionar. O agente não pode alterar nada no Search Console.

Configurando com uma conta de serviço

A rota da conta de serviço é a que recomendamos para equipes, porque separa o acesso do agente de qualquer login pessoal do Google.

1. Crie uma conta de serviço no Google Cloud (IAM, Contas de serviço). Nenhuma função é necessária no próprio projeto.
2. Ative a API Search Console para esse projeto do Google Cloud.
3. Crie uma chave JSON para a conta de serviço e armazene-a em algum lugar que o servidor possa ler, fora do repositório.
4. Adicione o e-mail da conta de serviço como usuário em cada propriedade do Search Console, com permissão Total ou Restrita. Restrita é suficiente para análises; a inspeção de URL precisa de permissão Total em algumas configurações.
5. Aponte o servidor para a chave, normalmente por meio de uma variável de ambiente, e adicione-o ao seu cliente.

Para Claude Code, isso se parece com:

claude mcp add --transport stdio gsc \
  -e GSC_SERVICE_ACCOUNT_FILE=/path/to/service-account.json \
  -- gsc-mcp

As propriedades são endereçadas da mesma forma que a API as endereça: sc-domain:example.com para propriedades de domínio, https://example.com/ para propriedades de prefixo de URL. Um bom servidor expõe list_sites para que o agente possa descobri-las em vez de adivinhar.

O que perguntar depois de conectado

O valor está em perguntas que levariam uma tarde de exportações na interface:

• "Quais consultas geram mais cliques para nossa página de preços e qual é nossa posição média para cada uma?"
• "Compare os últimos 28 dias com os 28 anteriores. Quais páginas perderam mais cliques e quais consultas nessas páginas caíram?"
• "Para quais consultas recebemos impressões na página dois (posições 11 a 20) com mais de 500 impressões? Essas são as vitórias rápidas."
• "/guides/mcp está indexado e qual é o canônico do Google para ele?"
• "Liste todas as consultas contendo 'mcp' e agrupe por página de destino."

Informe o agente sobre a defasagem dos dados e diga que o Search Console amostra e anonimiza consultas de cauda longa, portanto os totais por consulta não corresponderão aos totais por página.

Combinando com outros servidores

O Search Console sozinho responde "o que o Google mostrou e o que foi clicado". Combinado com o Google Analytics, responde "e o que esses visitantes fizeram", e com o Ahrefs, responde "e pelo que poderíamos ranquear que ainda não ranqueamos". Essa combinação de três servidores é o núcleo de um agente de SEO e a razão pela qual skills existem: uma skill de "revisão mensal de SEO" que executa as mesmas junções todas as vezes.

Executando para uma equipe

A credencial no passo 3 é um arquivo de chave que concede acesso de leitura a todos os seus dados de pesquisa. Em um laptop, é uma máquina perdida de distância de um vazamento, e não é atribuível a uma pessoa. Em uma configuração de equipe, a chave pertence a um gateway que a mantém centralmente, expõe o servidor a usuários aprovados e registra quem perguntou o quê.

É assim que executamos o nosso: o servidor do Search Console fica atrás do Walma AI Hub dentro do nosso próprio locatário Azure, junto com Google Ads, Ahrefs e o restante, e cada chamada do agente está em um único log. Se você quiser o mesmo para sua equipe de marketing, agende uma demonstração.

Perguntas frequentes

Existe um servidor MCP oficial do Google Search Console?+

Não. O Google publica servidores MCP oficiais para Google Ads e Google Analytics, mas não para o Search Console até o momento desta escrita. Os servidores da comunidade encapsulam a API do Search Console e são diretos porque a API é pequena e somente leitura.

O que um agente de IA pode fazer com o Search Console por meio do MCP?+

Tudo o que a API Search Analytics permite: cliques, impressões, CTR e posição por consulta, página, país, dispositivo e data; comparações de períodos; inspeção de URL para status de indexação; e a lista de sitemaps. Ele não pode alterar nada, o que o torna o servidor de marketing mais seguro para começar.

Como um servidor MCP do Search Console autentica?+

Ou via OAuth como usuário, ou com uma conta de serviço do Google Cloud que você adiciona à propriedade do Search Console como usuário. A rota da conta de serviço é melhor para equipes: sem login pessoal, uma chave que você pode rotacionar e acesso somente leitura que você pode revogar.

Os dados do Search Console via MCP têm defasagem?+

Sim, a mesma da interface: os dados de análise de pesquisa normalmente ficam dois a três dias atrasados. O agente deve ser informado disso para não relatar ontem como um colapso de tráfego.