Google Search Console

Servidor MCP do Google Search Console

Um servidor Model Context Protocol (MCP) que dá aos agentes de IA acesso direto aos seus dados do Google Search Console.

• Análise de pesquisa — consulte cliques, impressões, CTR e posição média por página, consulta, país, dispositivo ou intervalo de datas
• Comparar períodos — tendências semana a semana, mês a mês
• Encontrar oportunidades — consultas com alta impressão e baixo clique, palavras-chave de ranking que você não conhecia
• Acompanhar páginas específicas — veja quais URLs estão ganhando ou perdendo tração
• Cobertura de indexação — verifique quais páginas estão indexadas, excluídas ou com erros
• Status de sitemaps — verifique se os sitemaps estão sendo lidos e quantas URLs estão indexadas

Acesso somente leitura — este servidor não pode enviar URLs, modificar configurações ou fazer qualquer alteração nas suas propriedades do Search Console.

[!IMPORTANT] Este servidor usa autenticação de conta de serviço. A conta de serviço deve ser adicionada como usuário em cada propriedade do Search Console que você deseja acessar.

Ferramentas

list_sites

Lista todos os sites (propriedades) aos quais você tem acesso no Google Search Console.

Nenhum parâmetro necessário.

search_analytics

Consulte dados de análise de pesquisa — cliques, impressões, CTR e posição.

Parâmetro	Tipo	Obrigatório	Descrição
siteUrl	string	Sim	URL do site como aparece no Search Console (por exemplo, https://example.com/ ou sc-domain:example.com)
startDate	string	Sim	Data inicial no formato YYYY-MM-DD
endDate	string	Sim	Data final no formato YYYY-MM-DD
dimensions	string	Não	Separados por vírgula: query, page, country, device, searchAppearance, date
rowLimit	number	Não	Máximo de linhas a retornar (padrão 100, máximo 25000)
searchType	string	Não	web, image, video, news, discover ou googleNews (padrão web)
queryFilter	string	Não	Filtrar por consulta. Prefixe com regex: para correspondência regex
pageFilter	string	Não	Filtrar por URL da página. Prefixe com regex: para correspondência regex
countryFilter	string	Não	Código de país ISO 3166-1 alfa-3 (por exemplo, USA, GBR)
deviceFilter	string	Não	DESKTOP, MOBILE ou TABLET

inspect_url

Verifique o status de indexação, informações de rastreamento e usabilidade móvel de uma URL.

Parâmetro	Tipo	Obrigatório	Descrição
siteUrl	string	Sim	URL do site como aparece no Search Console
inspectionUrl	string	Sim	A URL completa a inspecionar (deve pertencer ao site)

list_sitemaps

Lista todos os sitemaps enviados e seu status para um site.

Parâmetro	Tipo	Obrigatório	Descrição
siteUrl	string	Sim	URL do site como aparece no Search Console

Instalação

Configuração rápida via agente

Já tem sua chave da conta de serviço? Cole este prompt no Claude Code ou no Claude Desktop e ele configurará tudo para você:

Clone e construa o servidor MCP do Google Search Console a partir de https://github.com/sarahpark/google-search-console-mcp, e adicione-o à minha configuração MCP global. Minha chave da conta de serviço está em /path/to/service-account-key.json. Após a configuração, chame list_sites para verificar se funciona.

Substitua o caminho da chave pelo local real do arquivo.

Compilar a partir do código-fonte

git clone https://github.com/sarahpark/google-search-console-mcp.git
cd google-search-console-mcp
npm install
npm run build

Configuração

Configuração do Google Cloud: chave da conta de serviço

1. Vá para o Google Cloud Console e crie um novo projeto (ou selecione um existente)
2. Abra a página da API Search Console e clique em Ativar
3. Na barra lateral, vá para APIs e Serviços → Credenciais
4. Clique em Criar Credenciais → Conta de serviço
5. Dê um nome (por exemplo, "search-console-mcp"), depois clique em Criar e Continuar
6. Você pode pular as etapas opcionais de função/acesso — clique em Concluído
7. Na página de Credenciais, clique na conta de serviço que você acabou de criar
8. Vá para a guia Chaves → Adicionar Chave → Criar nova chave → selecione JSON → clique em Criar
9. Um arquivo de chave .json será baixado — salve-o em um local seguro (por exemplo, ~/.config/gcloud/service-account-key.json)

[!CAUTION] Trate este arquivo de chave como uma chave secreta. Não o salve dentro do repositório do seu projeto nem o envie para o git. Armazene-o fora do diretório do projeto e faça referência a ele pelo caminho absoluto na sua configuração MCP.

Acesso ao Google Search Console

1. Copie o endereço de e-mail da conta de serviço (parece com name@project-id.iam.gserviceaccount.com — você pode encontrá-lo na página de detalhes da conta de serviço)
2. Vá para o Google Search Console
3. Selecione sua propriedade e vá para Configurações → Usuários e permissões
4. Clique em Adicionar usuário, cole o e-mail da conta de serviço, defina a permissão como Restrita e clique em Adicionar

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "gsc": {
      "command": "node",
      "args": ["/absolute/path/to/google-search-console-mcp/build/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

Claude Code (VS Code)

Adicione ao objeto "mcpServers" em ~/.claude.json:

{
  "mcpServers": {
    "gsc": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/google-search-console-mcp/build/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

Uso

Depois de configurado, pergunte ao Claude naturalmente:

• "Liste minhas propriedades do Search Console"
• "Mostre-me as 20 principais consultas do meu site nos últimos 28 dias"
• "Verifique o status de indexação de https://example.com/blog/my-post"
• "Compare o desempenho mobile vs desktop neste mês"
• "Quais sitemaps estão enviados para o meu site?"

Licença

MIT