Como conectar o Google Search Console ao Claude Code com MCP

Por que conectar o Search Console a um assistente de programação?

O Claude Code é útil quando o trabalho de SEO envolve o próprio site. No mesmo ambiente de desenvolvimento, você inspeciona templates, corrige redirecionamentos, muda títulos de páginas, testa um build e revisa um sitemap. Só que o código-fonte não diz qual página perdeu 300 cliques do Google na semana passada.

Sem acesso ao Search Console, um assistente consegue olhar uma página e dar sugestões razoáveis. Mas não consegue distinguir um problema de alta prioridade de algo que ninguém pesquisa. Quando o tempo é curto, essa diferença pesa.

Uma conexão MCP acrescenta a fonte de evidências que faltava. Você pode pedir ao Claude Code que identifique no Search Console as URLs afetadas, compare-as com os templates locais das páginas e prepare alterações de código com base numa investigação de verdade.

Este guia trata do fluxo no terminal do Claude Code, e não do conector comum do site do Claude. Se você trabalha principalmente no navegador, use o nosso guia de configuração do Search Console no Claude.

O que você precisa antes de rodar um comando

Você precisa do Claude Code instalado e funcionando em um terminal, de uma conta do Google com acesso à propriedade do Search Console desejada e de um servidor MCP capaz de obter os dados dessa propriedade. O servidor pode ser próprio ou remoto.

Os passos abaixo usam o endpoint hospedado do GSC Magic. Segundo a documentação do GSC Magic, ele aceita o transporte Streamable HTTP e oferece login via OAuth ou um token de acesso. Sua conta precisa estar provisionada e o serviço, acessível; informar uma URL válida não significa que a autenticação deu certo.

Comece conferindo que o próprio Claude Code funciona. Abra-o em um projeto qualquer e veja se consegue digitar prompts. Não é preciso clonar todo o site de produção só para testar uma conexão somente leitura com o Search Console.

Antes de conectar, decida se o trabalho é para um site ou vários. É fácil escolher a propriedade errada do Search Console quando uma conta do Google tem acesso a sites de clientes, domínios de homologação e propriedades antigas de prefixo de URL.

Passo 1: adicionar o endpoint MCP remoto

Abra o terminal e execute o comando a seguir:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Veja o que significa cada parte. claude mcp add registra um servidor no Claude Code. O transporte http indica um serviço MCP remoto, e não um executável local. --scope user deixa o conector disponível na sua configuração em nível de usuário. O nome curto gsc-magic é só o identificador que aparecerá na sua lista de ferramentas.

A URL é o endpoint remoto documentado do GSC Magic. Ela não é a URL da sua propriedade do Search Console, o sitemap do seu site nem um endpoint de API do Google.

Por que usar o escopo de usuário? Se você faz SEO em vários projetos locais, uma conexão em nível de usuário é prática. Para um repositório compartilhado ou um ambiente sensível de cliente, revise as regras de escopo de configuração do Claude Code e a política da sua equipe antes de adicionar integrações externas.

O comando MCP geral e as orientações sobre transporte estão na documentação do Claude Code da Anthropic. Consulte-a se alguma opção da CLI mudar em uma versão mais nova.

Passo 2: autenticar no Claude Code

Inicie o Claude Code e digite:

/mcp

Selecione o servidor gsc-magic. Se o cliente oferecer a ação Authenticate, siga-a e conclua o login no navegador. Use a conta do Google que tem as permissões corretas na propriedade do Search Console.

Não envie sua senha do Google, o código de autorização OAuth ou um token de acesso como mensagem comum do chat. A autenticação é uma etapa separada, tratada pelo cliente e pelo servidor. Se o navegador abrir, mas a autorização nunca terminar, volte ao menu MCP e confira o status da conexão antes de tentar de novo.

Alguns ambientes não conseguem concluir o OAuth pelo navegador. Nesses casos, o GSC Magic documenta tokens de acesso pessoais em Connect → Access tokens, no painel. Uma conexão com token usa um cabeçalho, por exemplo:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Isto é um modelo, não uma credencial que funciona. Substitua o marcador em um fluxo de configuração local seguro e não faça commit dele no Git. Se você só precisa de relatórios de desempenho e de indexação, crie um token somente leitura. A documentação da plataforma explica expiração, revogação e permissões dos tokens.

Passo 3: comprovar que a conexão funciona

Não comece com “audite o site inteiro e corrija tudo”. Peça uma resposta que você consiga verificar.

Liste as propriedades do Google Search Console que esta conexão consegue acessar. Inclua os identificadores exatos das propriedades e os níveis de permissão, se disponíveis. Não analise nenhuma propriedade até eu escolher.

Isso confere várias coisas de uma vez: o cliente consegue descobrir as ferramentas do servidor, o servidor consegue se autenticar no Google e a sua conta do Google enxerga pelo menos uma propriedade.

Selecione o identificador exato da propriedade de que precisa. Uma propriedade no formato sc-domain:example.com pode incluir subdomínios. Uma propriedade de prefixo de URL, como https://www.example.com/, cobre um conjunto mais restrito de URLs. Uma divergência despercebida pode fazer uma comparação de tráfego parecer errada mesmo com a ferramenta funcionando perfeitamente.

Se a lista vier vazia, verifique primeiro a sua conta do Google e as permissões da propriedade. Não presuma que o servidor está quebrado.

Passo 4: rodar uma primeira comparação de SEO útil

Uma boa primeira tarefa é estreita, mensurável e fácil de repetir:

Para a propriedade do Search Console selecionada, compare os últimos 28 dias de relatório completos com os 28 dias anteriores. Mostre os intervalos de datas exatos, o total de cliques, impressões e CTR e, depois, liste as dez páginas com as maiores perdas absolutas de cliques. Use dados do Search Console, não estimativas. Rotule as possíveis explicações como hipóteses.

Você pode conferir esse relatório na interface de Desempenho do Search Console. Se os totais divergirem, verifique as opções de agregação, os fusos horários, os tipos de pesquisa e se os dados já são definitivos. O Google conta cliques e impressões segundo as próprias definições de relatório, não segundo as regras de sessão do GA4.

Em seguida, peça ao Claude Code que aprofunde uma página:

Para a URL com a maior perda, compare as dez principais consultas entre os períodos. Agrupe as mudanças relevantes por dispositivo e país. Diga quais observações justificam investigar o template da página e quais não justificam.

É aqui que um assistente de programação ganha utilidade. Se a página perdeu visibilidade no celular, você pode revisar a navegação mobile, o layout responsivo e a renderização. Se perdeu impressões em um grupo restrito de consultas, pode examinar o conteúdo da página e os links internos. Mas não deixe o modelo tratar correlação como prova.

Passo 5: ligar os dados ao código do seu site

Suponha que o Search Console aponte uma URL de produto importante com CTR em queda. Peça ao Claude Code que encontre a rota ou o template responsável pelo título HTML, pela descrição e pelos títulos de seção da página.

Uma sequência sensata é esta:

1. Localize a página ou o template no projeto.
2. Inspecione o título atual, a URL canônica, a estrutura de títulos e o conteúdo principal.
3. Leia as consultas que geraram impressões para a página.
4. Sugira uma melhoria pontual que combine com o conteúdo real da página.
5. Mostre um diff antes de fazer alterações.
6. Rode o build e os testes de sempre.
7. Registre a data do deploy para poder comparar depois.

Nem toda página com CTR baixo precisa de um título novo. A página pode ranquear para consultas informacionais amplas, com pouca intenção de clique, ou a posição média pode ter mudado. Use o guia de análise de CTR baixo antes de reescrever metadados com base em um único número.

Nunca mande o Claude Code excluir ou redirecionar páginas só porque duas URLs compartilham uma consulta. Isso pode causar mais estrago do que o problema original.

Como montar um fluxo semanal repetível

Você pode guardar o prompt de análise nas suas anotações ou no runbook interno do projeto. O Claude Code não precisa lembrar da conversa anterior se o prompt especificar os parâmetros do relatório.

Peça sempre as mesmas janelas completas de 7 ou de 28 dias e inclua a propriedade selecionada. Faça o assistente devolver uma tabela com URL, cliques em cada período, variação absoluta, variação relativa e a consulta que mais contribuiu para a mudança. Mantenha a primeira versão somente leitura.

Depois do relatório, peça um plano de ação limitado a três itens. Um bom item de ação tem um sinal observado, uma verificação proposta, um responsável e uma forma de medir o resultado.

Por exemplo: “A página de documentação perdeu 120 cliques, principalmente em consultas de configuração no desktop. Verifique se a página ainda responde à versão atual das instruções de integração; atualize apenas se o conteúdo estiver desatualizado.” Isso é muito mais acionável do que “Melhorar a qualidade do conteúdo”.

Se você agendar scripts ou agentes, controle as chamadas repetidas e respeite as cotas da API do Search Console. Um relatório semanal não deveria precisar de centenas de requisições duplicadas.

Solução de problemas comuns

Se o assistente informar um erro de ferramenta, leia o erro de verdade antes de tentar outro prompt. Reescrever uma consulta não resolve um token revogado nem um site a que a sua conta não tem acesso.

A referência da API Search Analytics do Google documenta limites de datas, dimensões, restrições e agregação. Entender esses limites evita um número surpreendente de diagnósticos de SEO equivocados.

Permissões e segurança quando código e dados de busca se encontram

Conectar dados do Search Console a um assistente de programação é poderoso porque o assistente também pode ter acesso ao sistema de arquivos. É justamente por isso que você deve separar investigação de implementação.

Trate as ferramentas de relatório como somente leitura sempre que possível. Peça diffs de código propostos e revise-os antes de o assistente gravar ou publicar qualquer coisa. Use o seu fluxo normal de Git e as verificações de sempre. Se você trabalha com propriedades de clientes, evite misturar dados de clientes diferentes no mesmo relatório.

O GSC Magic documenta tokens somente leitura e controles separados para o modo de escrita. As ferramentas dele para o Google Search Console incluem leitura de desempenho e do status de URLs indexadas, enquanto ações administrativas, como enviar um sitemap, exigem uma permissão mais forte. Essa separação importa mais do que a quantidade de ferramentas que o conector lista.

Lembre-se de que a API de Inspeção de URL do Google não solicita indexação. Os resultados de versão indexada dela são diferentes de um teste ao vivo da URL. A Google Indexing API, que é outra, tem tipos de conteúdo suportados restritos e não deve ser usada como atalho para páginas comuns.

Perguntas frequentes

O Claude Code acessa o Google Search Console diretamente, sem MCP?

Não por padrão. Seria preciso outro caminho autorizado, como um script de API próprio ou uma exportação importada. O MCP é uma forma padronizada de expor essas chamadas como ferramentas que o Claude Code pode usar.

Esta é a mesma configuração do Claude na web?

Não. O Claude Code usa uma configuração de MCP gerenciada pela CLI. O app web do Claude tem a própria interface de conectores. A fonte de dados pode ser a mesma, mas os passos de conexão são diferentes.

O Claude Code corrige problemas técnicos de SEO automaticamente?

Ele pode ajudar a editar arquivos aos quais tem permissão de acesso, mas as evidências do Search Console não provam que toda mudança sugerida está certa. Revise os diffs, teste os builds e exija aprovação humana para publicar.

O agente vai saber das minhas conversões do Google?

Só se você autorizar uma fonte de analytics adequada. O Search Console informa cliques e impressões de busca; o GA4 é necessário para sessões e eventos principais.

Que tarefa devo tentar primeiro?

Comece comparando dois períodos completos de 28 dias e as dez páginas com as maiores perdas de cliques. Você consegue confirmar esses números antes de envolver qualquer alteração de código.

A conclusão prática

O Claude Code rende mais como uma ponte entre o comportamento de busca medido e o site que você realmente pode melhorar. Use o conector para identificar um problema, o código para investigá-lo e o seu processo de revisão habitual para fazer as mudanças com segurança.

Se quiser saber exatamente quais ferramentas, tipos de token e opções de conexão estão documentados hoje, mantenha a documentação do GSC Magic aberta enquanto configura o seu cliente. Para ideias de análises seguintes, use os nossos 25 prompts para agentes de SEO.