Google Search Console MCP Server

• 💰 Integração com Google AdSense: Relatórios de ganhos, pagamentos e alertas de conta via setup --engine=adsense. Ativar o AdSense exige que você aprove um escopo OAuth separado do adsense.readonly; sua configuração existente de GSC, Bing e GA4 permanece inalterada até você optar por participar.
• 🔐 Autenticação AdSense somente OAuth: A API de Gerenciamento do AdSense suporta apenas OAuth de usuário — a configuração agora valida o acesso em tempo real e rejeita configurações de conta de serviço não suportadas com orientações acionáveis. Usuários com várias contas recebem seleção explícita de conta de editor com paginação completa (>100 contas).
• 📊 Atualizações do adsense_report: startDate/endDate personalizados agora substituem os dateRange predefinidos, além de um novo parâmetro orderBy (-ESTIMATED_EARNINGS) para relatórios de receita ordenados.
• 🧪 Suíte de testes MCP de ponta a ponta: O binário do servidor compilado agora é testado via stdio e SSE exatamente como um host MCP o acionaria — handshake, esquemas de ferramentas, envelopes de erro e comportamento de recursos multi-conta (11 testes e2e integrados ao CI).

• 💰 Integração com Google AdSense: Relatórios de ganhos, pagamentos e alertas de conta via setup --engine=adsense. Ativar o AdSense exige que você aprove um escopo OAuth separado do adsense.readonly; sua configuração existente de GSC, Bing e GA4 permanece inalterada até você optar por participar.
• 🔐 Autenticação AdSense somente OAuth: A API de Gerenciamento do AdSense suporta apenas OAuth de usuário — a configuração agora valida o acesso em tempo real e rejeita configurações de conta de serviço não suportadas com orientações acionáveis. Usuários com várias contas recebem seleção explícita de conta de editor com paginação completa (>100 contas).
• 📊 Atualizações do adsense_report: startDate/endDate personalizados agora substituem os dateRange predefinidos, além de um novo parâmetro orderBy (-ESTIMATED_EARNINGS) para relatórios de receita ordenados.
• 🧪 Suíte de testes MCP de ponta a ponta: O binário do servidor compilado agora é testado via stdio e SSE exatamente como um host MCP o acionaria — handshake, esquemas de ferramentas, envelopes de erro e comportamento de recursos multi-conta (11 testes e2e integrados ao CI).

Por que isso existe

Os dados do site vivem em quatro silos diferentes. Responder a uma pergunta — "minha receita de anúncios caiu por causa de uma queda no tráfego ou de um RPM menor?" — geralmente significa entrar em quatro painéis, exportar quatro CSVs e fazer VLOOKUPs manualmente.

O Search Console MCP coloca GSC, Bing, GA4 e AdSense atrás de um conjunto de ferramentas que seu agente de IA pode chamar diretamente, e faz a análise (canibalização, detecção de anomalias, atribuição de receita) antes que os dados cheguem à sua janela de contexto.

⚡ Início Rápido

npx search-console-mcp setup

Isso abre seu navegador, autoriza sua conta do Google e armazena suas credenciais com segurança (veja Segurança). Depois, adicione-o à configuração do seu cliente MCP (Claude Desktop, Cursor, Antigravity, etc.):

{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": ["search-console-mcp"]
    }
  }
}

Reinicie seu cliente — e experimente um dos prompts abaixo.

💬 Experimente

Cole estes diretamente no seu agente:

"Meu tráfego caiu esta semana em comparação com a anterior. Descubra exatamente quando começou e quais páginas são responsáveis."

"Encontre palavras-chave para example.com nas posições 8–15 com 1.000+ impressões — minhas melhores vitórias rápidas."

"Verifique canibalização de palavras-chave — duas das minhas páginas estão competindo pela mesma consulta?"

"Execute seo_audit nas minhas principais páginas: quais têm alta visibilidade de busca, mas CTR ruim?"

🔌 Conecte suas contas

Gerencie tudo pela CLI:

npx search-console-mcp accounts list
npx search-console-mcp accounts add-site --account=you@company.com --site=example.com
npx search-console-mcp accounts remove --account=you@company.com

Quando seu agente consulta um site, o servidor resolve automaticamente qual conta o possui — sem alternância manual. Documentação multi-contas →

# 1. On your laptop (after setup --engine=adsense):
npx search-console-mcp adsense-export

# 2. On the server (prints a ready-to-run command on step 1):
npx search-console-mcp adsense-import --token='...' --publisher-id='accounts/pub-...'

🖥️ Execute ferramentas pela CLI

O Search Console MCP também expõe ferramentas MCP registradas como comandos CLI diretos. Use o subcomando run para listar ferramentas, inspecionar argumentos específicos de cada ferramenta e imprimir resultados como JSON, CSV ou tabela ASCII:

# List registered tools
npx search-console-mcp run --help

# Show options for one tool
npx search-console-mcp run analytics_query --help

# Run an SEO audit with JSON output
npx search-console-mcp run seo_audit --siteUrl=https://example.com --type=quick_wins

# Print array results as CSV or a table
npx search-console-mcp run analytics_query --siteUrl=https://example.com --startDate=2026-06-01 --endDate=2026-06-30 --dimensions=date,query --format=csv
npx search-console-mcp run sites_list --engine=all --format=table

🛠 Ferramentas (Arquitetura de Domínio Fluente)

O Search Console MCP v2.0 apresenta 7 Ferramentas de Domínio Fluente que lidam com todas as operações de SEO, Analytics, Inspeção e Indexação de forma limpa:

Ferramentas do Google AdSense

Nota: accountId refere-se ao ID de perfil configurado (ex.: adsense_2, conforme mostrado por accounts_manage), não a um nome de recurso de editor como accounts/pub-123.

🔒 Segurança

• Chaveiro do SO primeiro — tokens armazenados no Chaveiro do macOS, no Gerenciador de Credenciais do Windows ou no Secret Service do Linux
• Fallback AES-256-GCM — criptografado com uma chave derivada do ID de hardware da sua máquina; um arquivo roubado é inútil em outro dispositivo
• Armazenamento mínimo — apenas refresh_token e expiry_date são persistidos, em mode 600
• Atualização silenciosa — tokens são renovados automaticamente em segundo plano

Licença

MIT · Guia de contribuição · Guia de Compatibilidade Retroativa