O que é Google Search Console MCP (mcp-gsc)?
O mcp-gsc, de Amin Foroutan, permite que um cliente MCP consulte o Google Search Console: listar propriedades, obter cliques, impressões, CTR e posição por consulta, página, país ou dispositivo, comparar dois períodos, inspecionar até 10 URLs de uma vez para ver status de indexação, último rastreamento e resultados avançados, e ler sitemaps com seus erros e avisos. Ele roda na sua máquina via stdio e faz login com seu próprio cliente OAuth do Google ou com uma conta de serviço.
O Google não publica um servidor MCP próprio para o Search Console, então este é o ponto de referência da categoria: cerca de 2.200 estrelas no GitHub, 283 forks e cerca de 53.000 downloads do pacote mcp-search-console no PyPI no último mês. É Python com licença MIT e chegou à versão 0.4.2 em 6 de novembro de 2026. Ele não chama a Indexing API do Google, então não consegue pedir ao Google que rastreie ou indexe uma página.
Como instalar Google Search Console MCP (mcp-gsc)
uvx mcp-search-consoleGoogle Search Console MCP (mcp-gsc) vale a pena?
O que torna o mcp-gsc útil é transformar as perguntas que um SEO já faz na interface do Search Console em chamadas de ferramentas que um modelo pode encadear. Quais consultas perderam cliques entre dois períodos de 28 dias, quais páginas estão na segunda página com muitas impressões, se dez URLs importantes estão mesmo indexadas e quando o Google as rastreou pela última vez. A análise avançada pagina resultados além do limite de 25.000 linhas por solicitação da API, e uma inspeção em lote verifica até 10 URLs por chamada.
O modelo de permissões agora é o certo. A versão 0.4.2 pede apenas o escopo webmasters.readonly do Google, a menos que GSC_ALLOW_DESTRUCTIVE=true esteja definido; nesse caso pede acesso total de escrita e libera adicionar e excluir propriedades e excluir sitemaps. A ferramenta submit_sitemap continua no conjunto padrão, mas com um token somente leitura o Google não tem por que aceitá-la. Antes dessa versão, o servidor pedia mais acesso do que suas ferramentas padrão precisavam, e uma falha na renovação do token podia apagar o token salvo; o changelog registra a correção dos dois problemas.
O porém: a configuração é a parte mais difícil, e a culpa é do Google. Você cria um projeto no Google Cloud, ativa a API do Search Console, configura uma tela de consentimento OAuth e baixa um arquivo de segredos do cliente, ou cria uma conta de serviço e a adiciona a cada propriedade com acesso total. Não é à toa que o README tem o próprio vídeo passo a passo. É preciso Python 3.11, e no Claude Desktop um Python mais antigo falha em silêncio, sem ferramentas e sem log. As cotas do Google também pesam em sites grandes: a inspeção de URL é limitada a 2.000 chamadas por dia e 600 por minuto por propriedade, então um modelo não consegue auditar um site de 50.000 páginas de uma vez.
Ele faz menos do que alguns rivais mais novos. O servidor de código aberto não tem Indexing API, Bing Webmaster Tools nem GA4; o autor direciona esses recursos para uma versão hospedada paga, e o README exibe banners dela. Servidores como o google-search-console-mcp, de FlorianBruniaux, acrescentam envios de indexação e Bing, ao custo de uma superfície de ataque maior.
Nossa opinião: o modo somente leitura por padrão é o recurso mais importante em uma ferramenta que guarda credenciais dos seus dados de pesquisa, e esta agora acerta nisso. A maioria das equipes de SEO precisa de análise, não de escrita, e é exatamente essa a troca que ela faz.
Onde ele se destaca
Um SEO interno de um e-commerce com 2.000 páginas
Descobrir por que os cliques orgânicos caíram no mês passado
Peça uma comparação dos últimos 28 dias com os 28 anteriores por página e consulta, depois inspecione as dez páginas que mais perderam em busca de problemas de indexação e canonical. Uma manhã de planilhas vira alguns prompts; a API em si é gratuita.
Um consultor de SEO autônomo com oito propriedades de clientes
Produzir todo mês um relatório de oportunidades próximas do topo para cada cliente
Uma conta de serviço adicionada a cada propriedade permite que o agente puxe consultas nas posições 8 a 20 com muitas impressões e redija recomendações. Mantenha o escopo padrão somente leitura para que um prompt errado não consiga excluir o sitemap de um cliente.
Um desenvolvedor que acabou de migrar um blog para um novo framework
Verificar se as páginas principais estão indexadas e se os sitemaps são lidos corretamente
Rode uma inspeção em lote nas URLs mais importantes e leia a contagem de erros dos sitemaps. A cota de inspeção é de 2.000 chamadas por dia por propriedade, suficiente para verificações pontuais de um site pequeno.
Antes de decidir
- Configuração
- Crie um projeto no Google Cloud, ative a API do Search Console e um cliente OAuth de desktop ou uma conta de serviço adicionada a cada propriedade; depois aponte o cliente para uvx mcp-search-console com GSC_OAUTH_CLIENT_SECRETS_FILE ou GSC_CREDENTIALS_PATH. A primeira execução com OAuth abre o navegador para login. Conte com 20 a 40 minutos na primeira vez.
- Integrações
- Cerca de 20 ferramentas para propriedades, análise de pesquisa, comparação de períodos, inspeção de URL e sitemaps, além de manifestos de plugin para Claude Code e Cursor e um Dockerfile. Stdio por padrão; existe um modo SSE para uso remoto.
- Dados e privacidade
- Os dados do Search Console vão do Google para a sua máquina e dali para o seu provedor de modelo. O token OAuth fica salvo como token.json na sua pasta de configuração de usuário. O modo SSE desliga a proteção contra DNS rebinding do SDK do MCP quando ligado a um host remoto, então mantenha-o atrás da sua própria autenticação.
- Custo em escala
- Gratuito; a API do Search Console não é cobrada. Em escala, o limite é a cota, não o dinheiro: 2.000 inspeções de URL por dia por propriedade e 1.200 consultas de análise por minuto por site.
- Limites
- A análise de pesquisa retorna no máximo 25.000 linhas por solicitação (o servidor pagina além disso). Sem Indexing API, então sem pedidos de rastreamento. Oito issues e pull requests abertos. Contas de serviço precisam de acesso total em cada propriedade para inspecionar.
O que é bom
- Escopo do Google somente leitura por padrão desde a 0.4.2
- Comparação de períodos e paginação além de 25.000 linhas
- Inspeção em lote de até 10 URLs
- OAuth ou conta de serviço; roda localmente via stdio
O que não é
- Projeto no Google Cloud e configuração OAuth antes da primeira consulta
- Sem Indexing API, Bing ou GA4 no servidor gratuito
- Exige Python 3.11+; versões mais antigas falham em silêncio no Claude Desktop
- O README promove a versão hospedada paga do autor
Ideal para
SEOs e donos de sites que querem que um assistente analise os dados de desempenho e indexação do próprio Search Console sem dar a ele acesso de escrita.
Alternativas ao Google Search Console MCP (mcp-gsc)
Google Search Console MCP (mcp-gsc): perguntas frequentes
- Google Search Console MCP (mcp-gsc) vale a pena?
- Para um SEO que quer fazer perguntas aos próprios dados do Search Console, esta é a escolha sensata por padrão, e desde a 0.4.2 ele não consegue mais mudar nada a menos que você autorize. Damos nota 4.2 de 5.
- Quanto custa Google Search Console MCP (mcp-gsc)?
- Gratuito e de código aberto (MIT). A API do Search Console não custa nada; o autor também vende uma versão hospedada separada com GA4 e ferramentas de palavras-chave, com preços no próprio site.
- Quais são as desvantagens de Google Search Console MCP (mcp-gsc)?
- Projeto no Google Cloud e configuração OAuth antes da primeira consulta; sem Indexing API, Bing ou GA4 no servidor gratuito; exige Python 3.11+; versões mais antigas falham em silêncio no Claude Desktop; o README promove a versão hospedada paga do autor.
- Para quem Google Search Console MCP (mcp-gsc) é indicado?
- SEOs e donos de sites que querem que um assistente analise os dados de desempenho e indexação do próprio Search Console sem dar a ele acesso de escrita.
- Quanto custa Google Search Console MCP (mcp-gsc) para uma equipe ou em produção?
- Gratuito; a API do Search Console não é cobrada. Em escala, o limite é a cota, não o dinheiro: 2.000 inspeções de URL por dia por propriedade e 1.200 consultas de análise por minuto por site.
- Google Search Console MCP (mcp-gsc) é seguro para dados da empresa?
- Os dados do Search Console vão do Google para a sua máquina e dali para o seu provedor de modelo. O token OAuth fica salvo como token.json na sua pasta de configuração de usuário. O modo SSE desliga a proteção contra DNS rebinding do SDK do MCP quando ligado a um host remoto, então mantenha-o atrás da sua própria autenticação.
- Quais são as melhores alternativas ao Google Search Console MCP (mcp-gsc)?
- As alternativas mais próximas que analisamos são Firecrawl MCP e Google Workspace MCP servers.
Respostas verificadas em 13 de nov. de 2026.
Você faz o Google Search Console MCP (mcp-gsc)? Mostre esta nota no seu site
