Orkas Orkas
Início Blog Google Search Console MCP
Produto

Google Search Console MCP: três formas de configurar e uma primeira auditoria

O Google não oferece um servidor MCP para o Search Console, então você escolhe entre um servidor comunitário, um hospedado ou um app com conector integrado. Veja o que cada opção exige, o que a API deixa de fora e uma primeira auditoria que você mesmo pode conferir.

Um servidor MCP do Google Search Console dá a um agente de IA, como Claude, Claude Code, Codex ou Cursor, acesso à API do Search Console. O agente consegue puxar seus cliques, impressões, CTR (taxa de cliques) e posição média, verificar se uma página está indexada e listar seus sitemaps. Você pergunta com suas próprias palavras, por exemplo “quais páginas aparecem na primeira página de resultados mas não recebem cliques?”, e o agente faz as consultas e analisa as linhas. Este guia compara as três formas de configurar um servidor desses, explica o que a API deixa de fora e mostra uma primeira auditoria que você mesmo pode conferir no Search Console.

Resposta curta: até 9 de novembro de 2026, o Google não tem um servidor MCP oficial para o Search Console. O Google publica um para o Google Analytics, e nem o diretório do Claude nem o do ChatGPT têm um conector do Search Console feito pelo Google, pela Anthropic ou pela OpenAI. Suas opções são um servidor comunitário gratuito que você mesmo roda e que exige um projeto no Google Cloud; um servidor hospedado em que você faz login com o Google; ou um app com conector integrado, como o Orkas, em que basta clicar em Conectar. Os três leem a mesma API, e ela não lista todas as consultas: o Google deixa de fora as consultas anonimizadas, que representaram 46,77% do tráfego em um estudo da Ahrefs com 887.534 propriedades do Search Console.

O que um MCP do Search Console faz e o que não faz

Todo servidor MCP do Search Console, comunitário ou comercial, chama a mesma API gratuita do Search Console. O que ele consegue fazer depende dessa API, resumida abaixo com base na referência da API e nos limites de uso do Google.

O que você pedeAPILimites
Cliques, impressões, CTR e posição por consulta, página, país, dispositivo, data ou aspecto da pesquisaSearch Analytics16 meses de histórico, com cerca de 2–3 dias de atraso; até 25.000 linhas por solicitação e 50.000 linhas por dia por tipo de pesquisa
Se uma URL está indexada, o último rastreamento e a canônica escolhida pelo GoogleURL InspectionUma URL por chamada; 2.000 chamadas por dia por propriedade
Seus sitemaps e os erros delesSitemapsLer exige acesso somente leitura; enviar ou excluir exige acesso total
As propriedades que você pode verSitesAdicionar ou remover uma propriedade exige acesso total

Algumas coisas do Search Console não têm API, então nenhum servidor MCP consegue acessá-las:

  • Dados da Visão Geral Criada por IA e do Modo IA. O Google liberou o relatório de performance de IA generativa para todos os sites em 31 de agosto de 2026, mas a referência da API não traz nenhum tipo de pesquisa nem aspecto da pesquisa para ele.
  • Opções mais novas dos relatórios. O tipo de pesquisa multimodal e o filtro de consultas de marca também não aparecem na referência da API.
  • Testar uma página publicada. A Inspeção de URL mostra a versão que está no índice do Google. A documentação da API diz: “não é possível testar a indexabilidade de uma URL publicada”.
  • O botão “Request indexing” (Solicitar indexação). Ele só existe no Search Console. A Indexing API do Google, que é separada e que alguns servidores chamam, oficialmente serve só para páginas de vagas de emprego e de transmissões ao vivo.

Três formas de conectar o Search Console ao Claude, Claude Code ou Codex

OpçãoConfiguraçãoPor onde passam seus dadosCusto
Servidor comunitário que você roda, como o mcp-gscProjeto no Google Cloud, API, credenciais e uma entrada na configuraçãoDo seu computador para o GoogleGrátis
Servidor hospedado, como o mcpsearchconsole.comFazer login com o Google e colar a URL do servidor no seu app de IAPelos servidores do provedorPlano gratuito, depois assinatura
Conector integrado no OrkasClicar em Conectar e fazer login com o GoogleDo seu computador para o GoogleConector gratuito
  • Servidores comunitários são gratuitos e os mais completos. O mais popular, AminForou/mcp-gsc, tinha 2.151 estrelas no GitHub em 9 de novembro de 2026. O código tem 21 ferramentas, entre elas comparação de períodos, inspeção em lote de até 10 URLs e, se você permitir, envio de sitemaps. O preço é a configuração: você precisa criar suas próprias credenciais do Google. Um comentário no r/TechSEO chamou o Google Cloud de “o único atrito”.
  • Servidores hospedados são o caminho mais rápido para usar no claude.ai ou no ChatGPT pela web. São servidores remotos, então você os adiciona por URL. A central de ajuda do Claude diz que conectores personalizados funcionam em todos os planos, mas “usuários do plano gratuito estão limitados a um conector personalizado”. O mcpsearchconsole.com anuncia um plano gratuito com 40 extrações de dados por mês em três propriedades e, depois disso, € 4,99 por mês sem IVA. Seus dados do Search Console passam pelo provedor, então leia antes os termos de privacidade dele.
  • Um conector integrado dispensa a configuração do Google Cloud. No Orkas, você faz login com o Google e o conector roda no seu computador. Ele é somente leitura e tem quatro ferramentas, menos que os servidores comunitários.

Rodar um servidor comunitário por conta própria

Estes passos seguem o README do mcp-gsc na versão 0.4.2 (6 de novembro de 2026). Não criamos um projeto no Google Cloud para este guia, então confira o README antes de começar.

  1. Crie as credenciais do Google. No console do Google Cloud, crie um projeto, ative a API do Search Console e crie um ID do cliente OAuth do tipo Desktop app. Baixe o arquivo JSON dele. Para automação, crie uma conta de serviço no lugar e adicione o e-mail dela no Search Console, em Usuários e permissões, dentro de Configurações, como usuário pleno.
  2. Instale o uv. O caminho recomendado pelo README roda o servidor com uvx, que cuida do Python para você. Sem ele, você precisa do Python 3.11 ou mais recente.
  3. Adicione o servidor ao seu agente. No Claude Code:
    claude mcp add --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json --transport stdio gsc -- uvx mcp-search-console
    No Codex:
    codex mcp add gsc --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json -- uvx mcp-search-console
    Testamos os dois comandos no Claude Code 2.1.311 e no Codex CLI 0.163.0. Para o Claude Desktop ou o Cursor, o README traz uma configuração JSON com o caminho completo do uvx, porque apps abertos pelo Dock ou pelo menu Iniciar podem não encontrá-lo de outra forma.
  4. Faça login uma vez. No primeiro uso, abre uma janela do navegador para você entrar com o Google. Desde a versão 0.4.2, o servidor pede apenas acesso somente leitura, a menos que você defina GSC_ALLOW_DESTRUCTIVE=true.

Um detalhe que os guias da comunidade não mencionam: se a tela de permissão OAuth estiver configurada como External e continuar em Testing, a documentação de OAuth do Google diz que o token de atualização expira em 7 dias. Você teria que fazer login de novo toda semana. Para evitar isso, publique o app em produção ou use uma conta de serviço. Um app publicado pode mostrar o aviso de “app não verificado”, que o Google deixa ignorar em apps de uso pessoal com menos de 100 usuários.

Conectar o Search Console no Orkas

O Orkas é um app de desktop para macOS e Windows em que vários agentes de IA trabalham num mesmo chat. O conector do Google Search Console já vem integrado, então você não precisa de um projeto no Google Cloud.

  1. Instale o Orkas e faça login. Baixe o app para macOS ou Windows. Contas novas ganham 500 créditos grátis para os modelos integrados do Orkas, então você não precisa de uma chave de API para começar.
  2. Abra Conectores. Clique em Conectores na barra lateral e procure o Google Search Console. O filtro Dados ou a caixa de busca levam você até ele.
  3. Clique em Conectar e faça login com o Google. Clique em Conectar, use a conta do Google que tem acesso à sua propriedade e permita o acesso somente leitura. O card passa para Conectado.
  4. Peça o que precisar. Num chat, digite @ e escolha o conector do Google Search Console, ou simplesmente descreva a tarefa. O agente lista suas propriedades primeiro e depois consulta a que você indicar.
  • Ele é somente leitura. O Orkas pede ao Google apenas o escopo webmasters.readonly. As quatro ferramentas listam suas propriedades, consultam dados de performance, listam sitemaps e inspecionam uma URL. Como elas só leem, o Orkas as executa sem pedir que você aprove cada chamada. Elas não enviam sitemaps nem solicitam indexação, e uma consulta retorna no máximo 25.000 linhas.
  • As consultas vão direto para o Google. O conector roda no seu computador e chama a API do Search Console diretamente. Só o login no Google e a renovação do token passam pelo servidor do Orkas, que guarda as credenciais do Google do app.
  • O SeoGeoAgent e seus agentes de programação podem usá-lo. O SeoGeoAgent, agente de SEO integrado do Orkas, usa seus cliques, impressões e posições reais nas auditorias assim que o Search Console está conectado. Se você instalou o Claude Code, o Codex, o OpenCode, o Hermes ou o OpenClaw e o conectou no Orkas, ele acessa o conector pela ponte de ferramentas do Orkas, sem precisar de uma configuração de MCP própria.
  • Precisa de acesso de escrita? Use Adicionar servidor MCP na página Conectores para adicionar um servidor comunitário como comando local. O Orkas também tem um conector do Bing Webmaster Tools.

Uma primeira auditoria que você pode conferir

Um bom primeiro pedido envolve números que você consiga comparar com o Search Console em um minuto e obriga o agente a dizer o que os dados não cobrem. Troque a propriedade e as duas URLs pelas suas:

Use o conector do Google Search Console para sc-domain:example.com. Considerando os últimos 28 dias de dados completos: 1) total de cliques e impressões por data, e que parcela deles as linhas de consultas cobrem; 2) páginas entre as posições 5 e 15 com pelo menos 100 impressões e CTR abaixo de 2%, ordenadas por impressões; 3) o status de indexação de https://example.com/new-page/ e https://example.com/old-page/. Coloque o período em todas as tabelas e não estime nada que os dados não mostrem.

Rodamos esse pedido com o Claude Code no Orkas em 9 de novembro de 2026, e as quatro ferramentas do conector funcionaram. Não publicamos os números do Search Console do nosso próprio site, então os resultados abaixo são um exemplo sintético: números inventados de uma loja fictícia em example.com, que mostram como é uma resposta cuidadosa e como conferir cada parte.

  • Totais por data (dados sintéticos): 3.480 cliques e 151.200 impressões. São esses os números em que você pode confiar para o site inteiro. Para conferir os seus, abra o relatório de Performance, escolha as mesmas datas personalizadas e o mesmo tipo de pesquisa e compare os totais. Eles devem ficar bem próximos. Uma diferença grande geralmente significa que o agente somou linhas de consultas ou de páginas no lugar deles.
  • Linhas de consultas (dados sintéticos): 642 linhas cobrindo 1.670 cliques, 48% do total. O restante vem de consultas que o Google anonimiza, que não têm linha nem no relatório nem na API. Uma parcela assim é normal: a Ahrefs constatou que as consultas anonimizadas representaram 46,77% do tráfego em abril de 2025, e mais em muitos sites. Um agente que soma as linhas de consultas e chama isso de seu tráfego pode mostrar só metade do valor real.
  • Páginas com CTR baixo (dados sintéticos): 9 páginas entre as posições 5 e 15 com pelo menos 100 impressões e CTR abaixo de 2%. A que teve mais impressões, /blog/linen-care/, somou 2.140, com posição média de 6,8 e 21 cliques, um CTR de 1,0%. Esses são os primeiros títulos e descrições a revisar. Se o seu site publica cada idioma em endereços terminados em ?lang=, cada versão ganha a própria linha de página, então peça os dados agrupados.
  • Inspeção de URL (dados sintéticos): a página antiga está indexada, a nova ainda não. https://example.com/old-page/, publicada em setembro, estava como “Submitted and indexed”, com último rastreamento em 3 de outubro. https://example.com/new-page/, publicada dois dias antes da verificação, estava como “Discovered - currently not indexed”. Para conferir, cole a mesma URL na barra de inspeção, no topo do Search Console.

Cinco erros comuns

  • Tratar as linhas de consultas como tráfego total. O guia do Google sobre dados de performance explica que consultas anonimizadas não têm linha: “se você somar os cliques de todas as linhas, não vai chegar ao mesmo número de cliques dos totais do gráfico”. Para os totais, peça dados por data sem filtro de consulta.
  • Comparar totais por página com totais do site. Agrupando por página, cada URL que aparece num resultado é contada separadamente. Agrupando por propriedade, um resultado conta uma vez só para o site inteiro. Por isso, as linhas de páginas podem somar mais impressões que o total do site.
  • Esquecer o atraso. Os dados “normalmente ficam disponíveis após 2-3 dias”. A API retorna dados finalizados, a menos que você peça dados recentes, então “os últimos 7 dias” terminam alguns dias antes de hoje.
  • Usar o nome errado da propriedade. Uma propriedade de domínio é escrita como sc-domain:example.com. Uma propriedade de prefixo de URL é o endereço completo com a barra final, como https://example.com/. Deixe o agente listar suas propriedades primeiro e copie o nome que ele retornar.
  • Pedir demais de uma vez. Cada solicitação retorna no máximo 25.000 linhas, e um detalhamento por consulta e página de 16 meses chega a esse limite rápido. Peça resumos, um filtro ou um período menor, e deixe o agente processar as linhas em vez de colar tudo no chat.

Qual opção escolher?

Sua situaçãoEscolha
Você usa o claude.ai ou o ChatGPT no navegadorUm servidor hospedado, adicionado por URL
Você quer todas as ferramentas, incluindo o envio de sitemaps, e não se importa com o Google CloudUm servidor comunitário como o mcp-gsc
Você quer que o Claude Code, o Codex e um agente de SEO leiam o Search Console sem Google CloudO conector integrado do Orkas
Seu site é grande demais para 25.000 linhas por solicitaçãoA exportação em massa de dados do Search Console para o BigQuery, fora do MCP

Perguntas frequentes

O Google tem um servidor MCP oficial do Search Console?

Não, até 9 de novembro de 2026. O Search Console não está na lista de servidores MCP oficiais do Google nem na lista de MCP do Google Cloud. O Google publica um servidor MCP para o Google Analytics, que não inclui dados do Search Console.

Um MCP do Search Console é gratuito?

A API do Search Console é gratuita, assim como os servidores comunitários, como o mcp-gsc, e o conector do Orkas. Servidores hospedados costumam ter um plano gratuito com limite mensal e um plano pago. O agente de IA que você conectar continua tendo o próprio custo, como um plano do Claude ou créditos do Orkas.

Um servidor MCP pode enviar sitemaps ou solicitar indexação?

Pode enviar ou excluir sitemaps se tiver acesso total ao Search Console, o que alguns servidores comunitários oferecem. A API do Search Console não tem a função Request indexing, então nenhum servidor consegue fazer isso para páginas comuns. O conector do Orkas é somente leitura e não faz nenhuma das duas coisas.

Por que os números do MCP não batem com o Search Console?

Geralmente porque o agente somou linhas de consultas, que deixam de fora as consultas anonimizadas, ou misturou totais por página com totais por propriedade. Peça totais por data sem filtro de consulta, com as mesmas datas e o mesmo tipo de pesquisa do relatório. Assim, os totais devem ficar bem próximos.

Funciona com o Claude Code e o Codex?

Sim. Adicione um servidor comunitário com claude mcp add ou codex mcp add, ou adicione um servidor hospedado por URL. No Orkas, o Claude Code e o Codex usam o conector integrado do Search Console pela ponte de ferramentas do Orkas, sem configurar nada em nenhuma das duas ferramentas.

O que é Agentic SEO? mostra o panorama completo: um agente faz o trabalho de SEO com dados reais e atualizados, e uma pessoa aprova o que vai ao ar.

Claude SEO skill →

Search Console no chat do seu agente Conecte o Search Console uma vez e deixe o Claude Code, o Codex ou o SeoGeoAgent consultarem os dados. O Orkas é gratuito para macOS e Windows. Contas novas ganham 500 créditos para o modelo integrado do Orkas.
Baixar o Orkas — grátis