Google Search Console MCP para seu assistente.
O mcp-gsc conecta o Google Search Console ao Claude, ChatGPT, Cursor ou outro cliente MCP. Analise consultas e páginas, inspecione URLs, gerencie sitemaps e use OAuth do Google.
- Modo recomendado
- Read-only
- Autenticação
- Google OAuth
- Opções de execução
- npm / Worker
- Licença
- MIT
npm · Google Search Console MCP
Instale o GSC MCP localmente com npm
O npm inicia um servidor Streamable HTTP no seu computador. É preciso configurar o Google OAuth e as credenciais antes; não é uma conexão de um clique.
1. Prepare o acesso ao Google
Node.js ^22.18.0 / >=24.11.0+npm- Use uma conta Google com acesso à propriedade do Search Console que deseja analisar.
- Crie um cliente OAuth no Google Cloud, ative as APIs necessárias e cadastre o URI exato de redirecionamento local.
- Defina essas três variáveis de ambiente conforme o guia desta versão. TOKEN_ENCRYPTION_KEY precisa ser base64 válido de exatamente 32 bytes aleatórios.
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY
Cadastre este URI exato no Google Cloud. Host, porta e caminho devem coincidir; localhost e 127.0.0.1 não são equivalentes.
http://127.0.0.1:8080/google/callback localhost ≠ 127.0.0.1
2. Inicie o servidor local
Depois de configurar as credenciais no terminal, execute o pacote npm. Para análises, use o ajuste somente leitura adequado ao seu shell.
O modo padrão é readwrite. Para análise, escolha readonly antes de autorizar o Google; as ferramentas de escrita não serão registradas.
Terminal Bash / zsh
export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gscPowerShell
$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gscEndpoint local · Streamable HTTP
http://127.0.0.1:8080/mcp 3. Conecte seu cliente MCP
Mantenha o processo rodando e conecte um cliente no mesmo computador ao endpoint Streamable HTTP local, não stdio.
Claude Code
claude mcp add --transport http gsc http://127.0.0.1:8080/mcpConectar Codex CLI / IDE
codex mcp add gsc --url http://127.0.0.1:8080/mcpCursor
No Cursor, adicione um servidor MCP Streamable HTTP chamado gsc com esta URL (Cursor local).
http://127.0.0.1:8080/mcp ChatGPT / Claude.ai
ChatGPT e Claude na nuvem não acessam o 127.0.0.1 do seu computador. Use seu próprio Worker HTTPS ou um túnel MCP seguro disponível, conforme as permissões da conta.
Precisa de acesso remoto?Precisa de acesso remoto?
A hospedagem própria no Cloudflare Workers continua disponível, com configuração do Cloudflare e Google OAuth. O exemplo abaixo usa Bash; siga o SETUP.md para todos os passos.
Sobre o produto
O que é o mcp-gsc?
O mcp-gsc é um servidor Model Context Protocol auto-hospedável que conecta o seu cliente de IA diretamente à API oficial do Google Search Console.
Execute o pacote npm localmente via HTTP de loopback ou implante seu próprio Worker Cloudflare para um endpoint HTTPS remoto. Ambos usam Google OAuth.
O inicializador local salva dados de sessão criptografados em ~/.mcp-gsc/state por padrão; o Worker usa o armazenamento da sua conta Cloudflare. Não é um conector hospedado pela DigestSEO.
Importe o relatório Web: multimodal para analisar impressões e cliques por página. Não reconhecemos nem comprimimos imagens. Analisador de Google Lens e pesquisa multimodal.
Compare a descoberta no Google das suas contas autorizadas, não curtidas, seguidores ou visualizações nos aplicativos. Compare o desempenho das suas redes sociais no Google.
Ferramentas
Capacidades do servidor
Ferramentas focadas cobrem estatísticas, inspeção de URL, sitemaps, indexação, diagnósticos de SEO e o resumo semanal.
A lista inclui ferramentas opcionais de escrita. GSC_ACCESS_MODE=readonly expõe apenas ferramentas sem alterações; a Indexing API do Google é restrita a tipos de conteúdo elegíveis.
get_capabilitiesLista as capacidades disponíveis e o status da autenticação.
list_sitesLista as propriedades do Search Console acessíveis à conta conectada.
query_search_analyticsConsulta cliques, impressões, CTR e posições em um intervalo de datas personalizado.
inspect_urlObtém o relatório de inspeção de URL ao vivo e os detalhes de indexação.
list_sitemapsLista os sitemaps enviados com status de rastreamento e avisos.
add_siteAdiciona uma propriedade do Search Console à conta conectada.
delete_siteRemove uma propriedade do Search Console da conta.
submit_sitemapEnvia um sitemap para uma propriedade do Search Console.
delete_sitemapRemove um sitemap enviado de uma propriedade.
get_sitemapObtém o status detalhado de um sitemap enviado.
identify_quick_winsEncontra consultas com muitas impressões posicionadas entre as posições 8 e 20.
detect_cannibalizationEncontra consultas pelas quais várias páginas competem.
detect_content_decayIdentifica as páginas com maior queda de cliques de pesquisa.
request_indexingSolicita a indexação por meio da API de indexação do Google. Atualmente, essa API é restrita a páginas com dados estruturados JobPosting ou páginas de transmissão ao vivo com BroadcastEvent dentro de VideoObject. Não está disponível para o envio geral de páginas da web.
list_indexed_pagesLista as páginas que receberam impressões no Search Console.
compare_performanceCompara cliques, impressões, CTR e posições entre dois períodos.
weekly_digestGera um relatório de SEO semanal em linguagem simples.
Implantação
Precisa de acesso remoto?
A hospedagem própria no Cloudflare Workers continua disponível, com configuração do Cloudflare e Google OAuth. O exemplo abaixo usa Bash; siga o SETUP.md para todos os passos.
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
npx wrangler deployDê uma estrela no repositório e leve o Search Console para o Claude.
Código aberto e hospedagem própria. Siga o guia do Google OAuth ou implante seu Worker.