Orkas Orkas
Início Blog Google Search Console MCP
Produto

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

A Google não disponibiliza um servidor MCP para o Search Console, por isso tem de escolher entre um servidor comunitário, um alojado ou uma aplicação com um conector integrado. Veja o que cada opção exige, o que a API deixa de fora e uma primeira auditoria que pode verificar por si.

Um servidor MCP do Google Search Console dá a um agente de IA, como o Claude, o Claude Code, o Codex ou o Cursor, acesso à API do Search Console. O agente consegue obter os seus cliques, impressões, CTR (taxa de cliques) e posição média, verificar se uma página está indexada e listar os seus sitemaps. Faz a pergunta por palavras suas, por exemplo «que páginas aparecem na primeira página de resultados mas não recebem cliques?», e o agente executa as consultas e analisa as linhas. Este guia compara as três formas de configurar um servidor destes, explica o que a API deixa de fora e acompanha uma primeira auditoria que pode confirmar no Search Console.

Em resumo: à data de 9 de novembro de 2026, a Google não tem um servidor MCP oficial para o Search Console. A 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 pela Google, pela Anthropic ou pela OpenAI. As opções são um servidor comunitário gratuito, executado por si, que exige um projeto no Google Cloud; um servidor alojado onde inicia sessão com a Google; ou uma aplicação com um conector integrado, como o Orkas, onde basta clicar em Ligar. As três leem a mesma API, e esta não mostra todas as consultas: a Google deixa de fora as consultas anonimizadas, que representaram 46,77% do tráfego num estudo da Ahrefs sobre 887.534 propriedades do Search Console.

O que um MCP do Search Console consegue e não consegue fazer

Todos os servidores MCP do Search Console, comunitários ou comerciais, chamam a mesma API gratuita do Search Console. O que conseguem fazer depende dessa API, que resumimos abaixo a partir da referência da API e dos limites de utilização da Google.

O que pedeAPILimites
Cliques, impressões, CTR e posição por consulta, página, país, dispositivo, data ou aspeto da pesquisaSearch Analytics16 meses de histórico, com cerca de 2–3 dias de atraso; até 25.000 linhas por pedido e 50.000 linhas por dia por tipo de pesquisa
Se um URL está indexado, o último rastreio e o URL canónico escolhido pela GoogleURL InspectionUm URL por chamada; 2.000 chamadas por dia por propriedade
Os seus sitemaps e respetivos errosSitemapsLer exige acesso só de leitura; submeter ou eliminar exige acesso total
As propriedades a que tem acessoSitesAdicionar ou remover uma propriedade exige acesso total

Há coisas no Search Console que não têm API, pelo que nenhum servidor MCP as consegue obter:

  • Dados da Vista geral de IA e do Modo IA. A Google disponibilizou o relatório de desempenho de IA generativa a todos os sites a 31 de agosto de 2026, mas a referência da API não inclui nenhum tipo de pesquisa nem aspeto da pesquisa para esse relatório.
  • Opções mais recentes dos relatórios. O tipo de pesquisa multimodal e o filtro de consultas de marca também não constam da referência da API.
  • Testar uma página publicada. A inspeção de URL mostra a versão que está no índice da Google. A documentação da API diz: «não é possível testar a indexabilidade de um URL publicado».
  • O botão «Request indexing». Só existe no Search Console. A Indexing API da Google, que é independente e que alguns servidores chamam, destina-se oficialmente apenas a páginas de ofertas de emprego e de transmissões em direto.

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

OpçãoConfiguraçãoPor onde passam os seus dadosCusto
Servidor comunitário executado por si, como o mcp-gscProjeto no Google Cloud, API, credenciais e uma entrada na configuraçãoDo seu computador para a GoogleGratuito
Servidor alojado, como o mcpsearchconsole.comIniciar sessão com a Google e colar o URL do servidor na sua aplicação de IAPelos servidores do fornecedorPlano gratuito e depois subscrição
Conector integrado no OrkasClicar em Ligar e iniciar sessão com a GoogleDo seu computador para a GoogleConector gratuito
  • Os servidores comunitários são gratuitos e os mais completos. O mais popular, AminForou/mcp-gsc, tinha 2.151 estrelas no GitHub a 9 de novembro de 2026. O código inclui 21 ferramentas, entre as quais comparações entre períodos, inspeção em lote de até 10 URLs e, se o permitir, a submissão de sitemaps. O preço a pagar é a configuração: tem de criar as suas próprias credenciais da Google. Um comentador do r/TechSEO chamou ao Google Cloud «o único atrito».
  • Os servidores alojados são a forma mais rápida de chegar ao claude.ai ou ao ChatGPT na Web. São servidores remotos, por isso adicionam-se por URL. O centro de ajuda do Claude diz que os conectores personalizados funcionam em todos os planos, mas «os utilizadores 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, a partir daí, 4,99 € por mês sem IVA. Os seus dados do Search Console passam pelo fornecedor, por isso leia primeiro as condições de privacidade dele.
  • Um conector integrado dispensa a configuração do Google Cloud. No Orkas, inicia sessão com a Google e o conector é executado no seu computador. É só de leitura e tem quatro ferramentas, menos do que os servidores comunitários.

Executar 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 criámos um projeto no Google Cloud para este guia, por isso consulte o README antes de começar.

  1. Crie as credenciais da Google. Na consola do Google Cloud, crie um projeto, ative a API do Search Console e crie um ID de cliente OAuth do tipo Desktop app. Transfira o ficheiro JSON correspondente. Para automatizar, crie antes uma conta de serviço e adicione o endereço de email dela no Search Console, em Utilizadores e autorizações, nas Definições, com acesso total.
  2. Instale o uv. A via recomendada pelo README executa o servidor com uvx, que trata do Python por si. Sem ele, precisa do Python 3.11 ou posterior.
  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
    Verificámos os dois comandos com o Claude Code 2.1.311 e o Codex CLI 0.163.0. Para o Claude Desktop ou o Cursor, o README apresenta uma configuração JSON com o caminho completo para o uvx, porque as aplicações abertas a partir da Dock ou do menu Iniciar podem não o encontrar de outra forma.
  4. Inicie sessão uma vez. Na primeira utilização, abre-se uma janela do navegador para iniciar sessão na Google. Desde a versão 0.4.2, o servidor pede apenas acesso só de leitura, exceto se definir GSC_ALLOW_DESTRUCTIVE=true.

Há um pormenor que os guias da comunidade não referem: se o ecrã de consentimento OAuth estiver definido como External e ficar em Testing, a documentação de OAuth da Google diz que o token de atualização expira ao fim de 7 dias. Teria de voltar a iniciar sessão todas as semanas. Para o evitar, publique a aplicação em produção ou utilize uma conta de serviço. Uma aplicação publicada pode mostrar o aviso de «aplicação não validada», que a Google permite ignorar em aplicações de uso pessoal com menos de 100 utilizadores.

Ligar o Search Console no Orkas

O Orkas é uma aplicação para computador, para macOS e Windows, em que vários agentes de IA trabalham numa mesma conversa. O conector do Google Search Console vem integrado, por isso não precisa de um projeto no Google Cloud.

  1. Instale o Orkas e inicie sessão. Descarregue-o para macOS ou Windows. As contas novas recebem 500 créditos gratuitos para os modelos integrados do Orkas, por isso 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. Chega lá pelo filtro Dados ou pela caixa de pesquisa.
  3. Clique em Ligar e inicie sessão com a Google. Clique em Ligar, utilize a conta Google que tem acesso à sua propriedade e autorize o acesso só de leitura. O cartão passa para Ligado.
  4. Peça o que precisa. Numa conversa, escreva @ e escolha o conector do Google Search Console, ou descreva simplesmente a tarefa. O agente começa por listar as suas propriedades e depois consulta a que indicar.
  • É só de leitura. O Orkas pede à Google apenas o âmbito webmasters.readonly. As quatro ferramentas listam as suas propriedades, consultam dados de desempenho, listam sitemaps e inspecionam um URL. Como só leem, o Orkas executa-as sem lhe pedir que aprove cada chamada. Não podem submeter sitemaps nem pedir a indexação, e cada consulta devolve no máximo 25.000 linhas.
  • As consultas vão diretamente para a Google. O conector é executado no seu computador e chama diretamente a API do Search Console. Só o início de sessão na Google e a renovação do token passam pelo servidor do Orkas, que guarda as credenciais Google da aplicação.
  • O SeoGeoAgent e os seus agentes de programação podem utilizá-lo. O SeoGeoAgent, o agente de SEO integrado no Orkas, usa os seus cliques, impressões e posições reais nas auditorias assim que o Search Console estiver ligado. Se instalou o Claude Code, o Codex, o OpenCode, o Hermes ou o OpenClaw e o ligou no Orkas, ele chega ao conector através da ponte de ferramentas do Orkas, sem precisar de configurar o MCP por conta 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 pode verificar

Um bom primeiro pedido incide sobre números que consiga comparar com o Search Console num minuto e obriga o agente a dizer o que os dados não cobrem. Substitua a propriedade e os dois URLs pelos seus:

Usa o conector do Google Search Console para sc-domain:example.com. Para os últimos 28 dias de dados completos: 1) total de cliques e impressões por data, e que parte deles é coberta pelas linhas de consultas; 2) páginas entre as posições 5 e 15 com pelo menos 100 impressões e CTR inferior a 2%, ordenadas por impressões; 3) o estado de indexação de https://example.com/new-page/ e https://example.com/old-page/. Indica o intervalo de datas em todas as tabelas e não estimes nada que os dados não mostrem.

Executámos este pedido com o Claude Code no Orkas a 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, por isso 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 verificar cada parte.

  • Totais por data (dados sintéticos): 3.480 cliques e 151.200 impressões. São estes os números em que pode confiar para o site inteiro. Para verificar os seus, abra o relatório de Desempenho, escolha as mesmas datas personalizadas e o mesmo tipo de pesquisa e compare os totais. Devem ficar muito próximos. Uma diferença grande costuma significar que o agente somou, em vez disso, linhas de consultas ou de páginas.
  • Linhas de consultas (dados sintéticos): 642 linhas que cobrem 1.670 cliques, 48% do total. O resto vem de consultas que a Google torna anónimas, que não têm linha nem no relatório nem na API. Uma proporção destas é normal: a Ahrefs concluiu 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 as apresenta como o seu tráfego pode ficar-se por 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 inferior a 2%. A que teve mais impressões, /blog/linen-care/, somou 2.140, com uma posição média de 6,8 e 21 cliques, um CTR de 1,0%. São os primeiros títulos e descrições a rever. Se o seu site disponibiliza cada idioma em endereços terminados em ?lang=, cada versão tem a sua própria linha de página, por isso peça-as agrupadas.
  • 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 o último rastreio a 3 de outubro. https://example.com/new-page/, publicada dois dias antes da verificação, estava como «Discovered - currently not indexed». Para verificar, cole o mesmo URL na caixa de inspeção, no topo do Search Console.

Cinco erros frequentes

  • Tratar as linhas de consultas como tráfego total. O guia da Google sobre os dados de desempenho explica que as consultas anonimizadas não têm linha: «se somar os cliques de todas as linhas, não vai obter o mesmo número de cliques que os totais do gráfico». Para os totais, peça os 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 é contado em separado. Agrupando por propriedade, um resultado conta uma única vez para o site inteiro. Por isso, as linhas de páginas podem somar mais impressões do que o total do site.
  • Esquecer o atraso. Os dados «costumam estar disponíveis ao fim de 2-3 dias». A API devolve dados finais, exceto se lhe pedir dados recentes, por isso «os últimos 7 dias» terminam alguns dias antes de hoje.
  • Usar o nome errado da propriedade. Uma propriedade de domínio escreve-se sc-domain:example.com. Uma propriedade com prefixo de URL é o endereço completo com a barra final, como https://example.com/. Deixe o agente listar primeiro as suas propriedades e copie o nome que ele devolver.
  • Pedir demasiado de uma só vez. Cada pedido devolve no máximo 25.000 linhas, e uma divisão por consulta e página ao longo de 16 meses esgota esse limite depressa. Peça resumos, um filtro ou um intervalo de datas mais curto, e deixe o agente processar as linhas em vez de as colar todas na conversa.

Que opção deve escolher?

A sua situaçãoEscolha
Usa o claude.ai ou o ChatGPT no navegadorUm servidor alojado, adicionado por URL
Quer todas as ferramentas, incluindo a submissão de sitemaps, e não se importa com o Google CloudUm servidor comunitário como o mcp-gsc
Quer que o Claude Code, o Codex e um agente de SEO leiam o Search Console sem Google CloudO conector integrado do Orkas
O seu site é demasiado grande para 25.000 linhas por pedidoA exportação de dados em massa do Search Console para o BigQuery, fora do MCP

Perguntas frequentes

A Google tem um servidor MCP oficial do Search Console?

Não, à data de 9 de novembro de 2026. O Search Console não consta da lista de servidores MCP oficiais da Google nem da lista de MCP do Google Cloud. A 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, tal como os servidores comunitários, por exemplo o mcp-gsc, e o conector do Orkas. Os servidores alojados têm normalmente um plano gratuito com um limite mensal e um plano pago. O agente de IA que ligar continua a ter o seu próprio custo, como um plano do Claude ou créditos do Orkas.

Um servidor MCP pode submeter sitemaps ou pedir a indexação?

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

Porque é que os números do MCP não batem certo com o Search Console?

Normalmente 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 muito 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 alojado por URL. No Orkas, o Claude Code e o Codex usam o conector integrado do Search Console através da ponte de ferramentas do Orkas, sem configurar nada em nenhuma das duas ferramentas.

O que é o Agentic SEO? dá uma visão mais ampla: um agente executa o trabalho de SEO com dados reais e atualizados, e uma pessoa aprova o que é publicado.

Claude SEO skill →

O Search Console na conversa do seu agente Ligue o Search Console uma vez e deixe o Claude Code, o Codex ou o SeoGeoAgent consultá-lo. O Orkas é gratuito para macOS e Windows. As contas novas recebem 500 créditos para o modelo integrado do Orkas.
Descarregar Orkas — grátis