mcp-google-search-console

Google Search Console MCP

Inglês | Русский

A1 Google Search Console MCP conecta um aplicativo de IA ao Google Search Console. Investigue o desempenho de pesquisa, verifique se uma URL está indexada, inspecione sitemaps e envie ou remova deliberadamente um sitemap quando necessário.

Ele funciona com as propriedades que sua conta do Google pode acessar. O detalhe importante é que ele usa o valor exato da propriedade do Search Console — uma propriedade de domínio e uma propriedade de prefixo de URL são objetos diferentes.

• 18 ferramentas. Sete ferramentas leem propriedades, dados de pesquisa, sitemaps e status de indexação; duas adicionam uma propriedade ou enviam um sitemap; três podem remover dados ou chamar um método arbitrário da API.
• Conecta-se a partir da conversa. Diga "conectar Google Search Console": o servidor orienta você pelo cliente OAuth, captura o redirecionamento do Google em 127.0.0.1 com PKCE e mantém os tokens ele mesmo — sem arquivos de configuração, sem reinicialização.
• IDs exatos de propriedade. https://example.com/, https://www.example.com/ e sc-domain:example.com são distintos. list_sites mostra o valor a ser usado.
• Dados de pesquisa com contexto. Consulte cliques, impressões, CTR e posição por data, página, consulta, país, dispositivo ou aparência de pesquisa.
• Indexação, não publicação. A inspeção de URL explica o status atual do Google; ela não força uma página a entrar no índice.

Comece com uma pergunta somente leitura:

Mostre as 20 principais consultas de pesquisa para minha propriedade nos últimos 28 dias, com cliques e CTR.

Conectar o servidor · Explorar casos de uso · Abrir documentação técnica

Veja funcionando em um minuto

Você: https://example.com/pricing está indexada? Se não, por quê?

Assistente: Inspeciona a URL e mostra o veredito de indexação, cobertura, informações de rastreamento e URLs canônicas. Nada muda.

Você: Verifique meus sitemaps enviados e prepare um reenvio para aquele com erros.

Assistente: Mostra o sitemap, seus avisos e erros, e então pede confirmação antes de enviá-lo novamente.

Você: Confirmo.

Assistente: Reenvia o sitemap selecionado. Ele não altera o conteúdo da página nem garante a indexação.

Conteúdo

• Início rápido
• O que você pode pedir para ele fazer
• Como funcionam as propriedades do Search Console
• O que pode mudar
• Obtendo acesso
• Configuração
• Dados, limites e trabalho em segundo plano
• Documentação técnica
• Suporte

Início rápido

Você precisa do Node.js 20+ e de uma conta do Google. As credenciais não são necessárias no momento da instalação — o servidor se conecta a partir da conversa.

1. Adicione o servidor ao seu aplicativo de IA.
2. Diga "conectar Google Search Console": o assistente orienta você na criação do cliente OAuth e aprovação do acesso sem editar arquivos de configuração.
3. Comece com a pergunta somente leitura acima.

codex mcp add google-search-console \
  -- npx -y mcp-google-search-console@latest
codex mcp list

claude mcp add \
  --transport stdio --scope user google-search-console \
  -- npx -y mcp-google-search-console@latest
claude mcp list

{"mcpServers":{"google-search-console":{"command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

{"mcpServers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

{"servers":{"google-search-console":{"type":"stdio","command":"npx","args":["-y","mcp-google-search-console@latest"]}}}

O que você pode pedir para ele fazer

Encontrar oportunidades de pesquisa

• Quais consultas e páginas trouxeram mais cliques neste mês?
• Quais páginas perderam cliques em comparação com o período anterior?
• Mostre consultas contendo mcp onde a posição média está abaixo de 10.

Verificar status de indexação e sitemaps

• Esta URL está indexada? Mostre cobertura, informações de rastreamento e canônicas.
• Quais sitemaps enviados têm erros ou avisos?
• Reenvie este sitemap após mostrar seu status atual.

Gerenciar propriedades com cuidado

• Liste as propriedades do Search Console que posso acessar.
• Adicione este valor exato de propriedade; verificarei a propriedade separadamente.
• Remova esta propriedade da minha conta após confirmação.

Como funcionam as propriedades do Search Console

Uma propriedade de prefixo de URL deve incluir seu protocolo e barra final, por exemplo https://example.com/. Uma propriedade de domínio é escrita como sc-domain:example.com. Uma correspondência aproximada causa 403 ou 404, então use o valor exato retornado por list_sites.

add_site apenas registra uma propriedade. A verificação permanece na interface do Search Console ou na API de Verificação de Site. Os dados de pesquisa usam o Horário do Pacífico; end_date é inclusivo e os dados analíticos finais normalmente atrasam de dois a três dias. data_state: "all" pode incluir linhas mais recentes e ainda em mudança.

O que pode mudar

O cliente de IA controla os prompts de confirmação. O servidor marca leituras, escritas e chamadas destrutivas para que o cliente possa distinguir uma inspeção de uma mudança real.

Obtendo acesso

O Google Search Console exige OAuth 2.0; uma chave de API não é suficiente. Há duas formas de entrar, e a primeira não precisa de arquivos de configuração.

Conectar pelo chat (recomendado)

Diga "conectar Google Search Console" e o assistente executa o fluxo com você:

1. setup_instructions imprime a lista de verificação: crie ou selecione um projeto do Google Cloud, ative a API do Google Search Console, configure a tela de consentimento e crie um cliente OAuth de Aplicativo de desktop.
2. Baixe o JSON desse cliente ("Baixar JSON") e dê ao assistente o caminho — set_client o armazena com acesso apenas do proprietário. O segredo nunca passa pela conversa.
3. start_login retorna um link de consentimento do Google. Abra-o nesta máquina e aprove; o código volta para um ouvinte de uso único em 127.0.0.1 (PKCE), nunca pelo chat.
4. finish_login troca o código e salva os tokens em ~/.config/mcp-google-search-console/credentials.json (modo 0600) e os verifica com uma chamada real à API do Google Search Console — então uma API que ainda está desativada é detectada ali mesmo.

Os tokens são relidos a cada chamada, então a conexão funciona imediatamente — sem reiniciar o aplicativo de IA. auth_status mostra o que está conectado, logout revoga e exclui.

Variáveis de ambiente (CI, instalações não assistidas)

1. Crie ou selecione um projeto do Google Cloud e ative a API do Google Search Console.
2. Configure a tela de consentimento OAuth e crie um cliente OAuth de Aplicativo de desktop.
3. Use o Playground OAuth 2.0 com Usar suas próprias credenciais OAuth para autorizar a conta do Google que pode acessar as propriedades e obter um token de atualização.
4. Use https://www.googleapis.com/auth/webmasters para incluir sitemaps e mudanças de propriedade. Use https://www.googleapis.com/auth/webmasters.readonly somente se você precisar intencionalmente de acesso somente leitura.

Tokens de atualização em modo de teste podem expirar após sete dias. Publique o aplicativo OAuth, ou use um aplicativo interno do Workspace, para acesso de longa duração. Trate o segredo do cliente e o token de atualização como senhas.

Configuração

Toda variável é opcional — sem nenhuma delas, o servidor se conecta pelo chat.

* Forneça o trio OAuth ou um token de acesso.

Dados, limites e trabalho em segundo plano

• Privacidade. O servidor local chama o Google e envia telemetria anônima com um ID de instalação, versões e nomes de ferramentas — nunca tokens OAuth, dados de propriedade, argumentos de ferramentas ou prompts. Defina ASKADS_TELEMETRY=0 para optar por não participar.
• Limites da API. A inspeção de URL permite 2.000 inspeções por propriedade por dia e 600 por minuto. As análises retornam no máximo 25.000 linhas por solicitação; consultas anônimas de cauda longa nunca são retornadas. Use paginação e não inspecione sites inteiros URL por URL.
• Sem monitoramento em segundo plano. O servidor funciona apenas quando chamado. Se seu aplicativo de IA suportar tarefas agendadas, ele pode verificar periodicamente um sitemap ou uma URL importante.

Documentação técnica

• Catálogo de capacidades MCP — páginas orientadas a tarefas para cada ferramenta.
• Todas as ferramentas e entradas
• Documentação de desenvolvimento
• Documentação de publicação
• API do Google Search Console

Suporte

Encontrou um bug ou precisa de um cenário? Crie um problema ou escreva no Telegram.

Você chegou ao fim!