MCP do Search Console

MCP do Google Search Console sem Google Cloud

Conecte o Google Search Console ao Claude, ChatGPT, Cursor ou Codex sem projeto no Google Cloud nem cliente OAuth. Somente leitura, e sem gastar créditos.

€ 10 por mês com € 10 em créditos de uso incluídos. As leituras do Search Console não usam nenhum deles.

O servidor MCP do zaDojo dá ao seu agente de IA acesso somente leitura aos seus dados do Google Search Console: cliques, impressões, taxa de cliques (CTR) e posição média por consulta, página, país, dispositivo e data. Ele também encontra as páginas que os usuários ignoram, as consultas divididas entre suas páginas e seus maiores ganhos e quedas de cliques, mostra as últimas 48 horas hora a hora e lê seus sitemaps e resultados de inspeção de URL. Você conecta o Search Console dentro do zaDojo com um login normal do Google, então nunca precisa criar um projeto no Google Cloud, ativar uma API ou baixar um arquivo de credenciais. Ler dados do Search Console não consome créditos, e os mesmos números também aparecem como um painel do Search Console no app do zaDojo.

Conecte em três passos

  1. Crie uma conta no zaDojo e um projeto para o seu site. O teste dá € 0,10 em créditos e não pede cartão.
  2. No projeto, escolha Connect Google Search Console. Entre com a conta Google que tem acesso à propriedade, aprove o acesso somente leitura e escolha a propriedade.
  3. Adicione a URL do servidor abaixo ao seu cliente de IA e aprove o login do zaDojo na primeira conexão.
https://app.zadojo.com/mcp

Claude Code

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp

Codex CLI

codex mcp add zadojo --url https://app.zadojo.com/mcp

Cursor: adicione isto ao mcp.json em Settings > Tools & Integrations > MCP Tools.

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}

Claude Desktop: abra Customize > Connectors, escolha Add custom connector e cole a URL.

O ChatGPT precisa de uma conexão personalizada; o guia do ChatGPT lista os passos e os planos compatíveis. Qualquer outro cliente que aceite servidores MCP remotos usa a mesma URL, e o guia de configuração do MCP cobre cada cliente e os erros mais comuns.

O que seu agente pode ler

Desempenho na busca

A ferramenta get_search_console_performance retorna cliques, impressões, CTR e posição média da propriedade conectada. Seu agente pode detalhar os números por consulta, página, país, dispositivo ou data, combinar até cinco filtros e voltar até 16 meses. Resultados da web são o padrão, e dados de imagem, vídeo, notícias, Google Notícias e Discover também estão disponíveis.

Para o trabalho de "quase lá" (consultas em que você já aparece na segunda página), o agente pode pedir linhas entre as posições 5 e 20 com um número mínimo de impressões, e o zaDojo aplica esse filtro do lado dele.

Páginas a corrigir e cliques que mudaram

A ferramenta get_search_console_insights roda as mesmas análises da página do Search Console no app do zaDojo, então seu agente começa com uma lista curta de ações em vez de milhares de linhas brutas. Ela aceita o mesmo período e os mesmos filtros da ferramenta de desempenho, mais uma de quatro visões:

  • low_ctr: páginas na primeira página que recebem menos da metade dos cliques que seu site costuma ter na mesma posição, ordenadas pelos cliques perdidos. Cada página vem com a consulta que mais a exibe, que é aquela para a qual reescrever o título e a descrição.
  • cannibalization: consultas em que duas ou mais das suas páginas ficam cada uma com pelo menos 10% das impressões e nenhuma delas está no top 3.
  • page_changes e query_changes: as páginas ou consultas que mais ganharam e perderam cliques em relação ao período anterior de mesma duração.

As últimas 48 horas

A ferramenta get_search_console_hourly retorna cliques e impressões da busca na web para cada uma das últimas 48 horas, com totais das últimas 24 horas e das 24 horas anteriores. Os dados diários chegam com cerca de três dias de atraso, então esta é a ferramenta para "como está indo hoje?" ou para uma checagem rápida depois de um lançamento.

Sitemaps

A ferramenta get_search_console_sitemaps lista os sitemaps enviados para a propriedade: a URL de cada sitemap, quantas URLs ele envia, as contagens de erros e avisos, se o Google ainda está processando e quando foi enviado e baixado pela última vez.

Inspeção de URL

A ferramenta inspect_urls lê o que o Google tem armazenado sobre até 10 URLs por chamada: se cada página está indexada e, se não, o motivo que o Google informa, quando o Googlebot a rastreou pela última vez, a canônica escolhida pelo Google comparada com a que você declarou e os veredictos de dispositivos móveis e de resultados avançados.

Google Analytics, se você conectar

Conecte uma propriedade GA4 do mesmo jeito e o agente também pode ler seu tráfego: visitantes, origens, páginas de entrada, países, cidades, dispositivos e eventos principais, além de quem está no site agora. A ferramenta get_search_opportunities junta as duas fontes: páginas nas posições 4 a 20 no Search Console, cruzadas com os resultados delas no GA4 e pontuadas por demanda, valor para o negócio e quão alcançável está a primeira página. Leituras do Google Analytics também não consomem créditos; o guia do MCP do Google Analytics lista todos os relatórios.

Perguntas que vale fazer

Pergunte em palavras simples e o agente escolhe a ferramenta, geralmente a que aparece ao lado de cada pergunta.

Sua perguntaFerramenta
Quais consultas estão entre as posições 5 e 20 com pelo menos 100 impressões nos últimos 3 meses?get_search_console_performance
Quais páginas são ignoradas no Google, e o que os títulos delas deveriam dizer?get_search_console_insights, visão low_ctr
Quais consultas estão divididas entre duas ou mais das minhas páginas?get_search_console_insights, visão cannibalization
O que perdeu cliques este mês?get_search_console_insights, visão page_changes
Como está indo hoje?get_search_console_hourly
Meus sitemaps são lidos sem erros?get_search_console_sitemaps
A /pricing está indexada? Se não, qual motivo o Google informa?inspect_urls
Quais países e dispositivos trazem a maior parte dos meus cliques, e como isso mudou este ano?get_search_console_performance

Por que não há configuração no Google Cloud

Qualquer app que lê a API do Search Console precisa de um cliente OAuth registrado no Google. Servidores MCP do Search Console auto-hospedados pedem que você configure um por conta própria:

  1. Criar um projeto no console do Google Cloud.
  2. Ativar a API do Search Console.
  3. Configurar a tela de consentimento OAuth.
  4. Criar um ID de cliente OAuth.
  5. Baixar o arquivo JSON de credenciais.
  6. Instalar o servidor na sua máquina e mantê-lo rodando e atualizado.

O zaDojo tem o próprio cliente OAuth do Google, então você só vê a tela de consentimento padrão do Google. A conexão fica salva no seu projeto do zaDojo, o que significa que seu time e qualquer agente conectado a esse projeto usam a mesma propriedade sem ficar passando arquivos de credenciais.

Somente leitura por design

O zaDojo pede ao Google o escopo webmasters.readonly. Seu agente pode ler dados de desempenho, insights, status de sitemaps e resultados de inspeção. Ele não pode enviar sitemaps, remover URLs, adicionar usuários nem mudar qualquer configuração do Search Console. Você pode desconectar a qualquer momento no zaDojo, ou remover o acesso do zaDojo nas configurações da sua conta Google.

Quanto custa

Leituras do Search Console não consomem créditos, não importa quantas perguntas você faça. Elas vêm com o plano do zaDojo: € 10 por mês, incluindo € 10 em créditos de uso para as ferramentas que custam dinheiro, como pesquisa de palavras-chave (cerca de € 0,07 por pesquisa) ou rastreamento de posições. A mesma conexão MCP atende os dois tipos de ferramenta. A primeira cobrança paga tem garantia de reembolso de 30 dias, e você pode cancelar pelo portal de cobrança a qualquer momento.

Comparação com outras formas de conectar

zaDojoServidor MCP auto-hospedadoServiço de conectores de dados
Projeto no Google Cloud
Não é necessário
Você cria e configura um
Normalmente não é necessário
Configuração
Login com Google e uma URL
Passos no console do Cloud e um servidor local
Conta no fornecedor e configuração do conector
Onde roda
Hospedado pelo zaDojo
Sua própria máquina ou servidor
A nuvem do fornecedor
Acesso ao Google
webmasters.readonly
Os escopos que você conceder
Varia conforme o fornecedor
Custo para ler seus dados
Sem créditos; o plano custa € 10 por mês
Sem taxa, mas custa seu tempo e sua cota de API
Normalmente uma assinatura
Outros dados de SEO
Palavras-chave, SERPs, backlinks, posições, auditorias, visibilidade em IA
Só Search Console
Principalmente relatórios

Um servidor auto-hospedado é uma escolha razoável se você quer tudo na sua própria máquina e não se importa com a configuração no console do Cloud. O zaDojo serve para quem quer os dados no agente hoje, junto com ferramentas de palavras-chave, posições e backlinks.

Limites que vale conhecer

  • Os dados do Search Console chegam com atraso, então os últimos três dias, mais ou menos, podem estar faltando ou incompletos.
  • As datas seguem o horário do Pacífico, como no próprio Search Console.
  • O Google retorna as linhas ordenadas por cliques. Os filtros de posição e impressões são aplicados às 1.000 primeiras linhas do período.
  • Os insights cobrem só a busca na web e trabalham com as 5.000 primeiras linhas por cliques do período. As mudanças de cliques comparam uma janela com a anterior, e as duas precisam caber nos 16 meses de dados do Google, então use uma janela de seis meses ou menos.
  • Os dados por hora cobrem a busca na web das últimas 48 horas, com horários em UTC e não no horário do Pacífico. O Google ainda está acrescentando as horas mais recentes, então elas aparecem baixas no início.
  • A inspeção de URL lê o último status conhecido do Google para uma página. Ela não roda um teste ao vivo.
  • O Google omite consultas muito raras por privacidade, então os totais por consulta podem ser menores que os totais por página.
  • A conta Google que você conecta precisa ter acesso à propriedade no Search Console.

Perguntas frequentes

Preciso de um projeto no Google Cloud?

Não. Você entra com o Google dentro do zaDojo e aprova o acesso somente leitura. O zaDojo cuida da conexão com a API.

É somente leitura?

Sim. O zaDojo pede o escopo webmasters.readonly, então seu agente pode ler e inspecionar, mas não pode mudar nada no Search Console.

Ler o Search Console consome créditos?

Não. Leituras do Search Console e do Google Analytics não consomem créditos. As ferramentas de pesquisa pagas no mesmo servidor usam os € 10 em créditos incluídos no plano.

Quais clientes de IA podem usar?

Claude Code, Claude Desktop, Cursor, Codex CLI, Codex no app desktop do ChatGPT, ChatGPT com uma conexão personalizada e outros clientes que aceitam servidores MCP remotos.

Isso usa a API do Search Console?

Sim. O zaDojo chama os métodos Search Analytics, Sitemaps e URL Inspection da API do Search Console por você e retorna os resultados como ferramentas MCP, então seu agente recebe os dados da API sem você escrever código nem gerenciar credenciais.

Pergunte ao seu agente sobre seus próprios dados de busca

Sem projeto no Google Cloud, com acesso somente leitura e sem gastar créditos para ler seus dados do Search Console. Funciona com Claude, ChatGPT, Cursor e Codex.

Fique por dentro

Novidades do produto, novos recursos e, de vez em quando, os bastidores.