Servidor MCP Google Search Console

Google Search Console MCP Server

Um servidor Model Context Protocol (MCP) que fornece acesso abrangente aos dados do Google Search Console com recursos avançados de análise.

Recursos

Análise de pesquisa aprimorada: Recupere até 25.000 linhas de dados de desempenho
Filtragem avançada: Suporte para padrões regex e múltiplos operadores de filtro
Detecção de vitórias rápidas: Identifique automaticamente oportunidades de otimização
Dimensões ricas: Análise por consulta, página, país, dispositivo e aparência na pesquisa
Intervalos de datas flexíveis: Períodos de relatório personalizáveis com acesso a dados históricos

Patrocinado por

macuse.app é um aplicativo macOS nativo que dá superpoderes à sua IA, integrando assistentes de IA com aplicativos macOS como Calendário, Mail e Notas, além de controle universal de interface para qualquer aplicativo. Suporta Claude Desktop, Cursor e Raycast com configuração em um clique. Prioriza a privacidade e roda localmente.

Pré-requisitos

Node.js 18 ou posterior
Projeto Google Cloud com a API Search Console habilitada
Credenciais de conta de serviço com acesso ao Search Console

Instalação

npm install mcp-server-gsc

Configuração de Autenticação

Para obter as credenciais da API do Google Search Console:

Visite o Google Cloud Console
Crie um novo projeto ou selecione um existente
Habilite a API:

Vá para "APIs & Services" > "Library"
Pesquise e habilite "Search Console API"

Crie as credenciais:

Navegue até "APIs & Services" > "Credentials"
Clique em "Create Credentials" > "Service Account"
Preencha os detalhes da conta de serviço
Crie uma nova chave no formato JSON
O arquivo de credenciais (.json) será baixado automaticamente

Conceda acesso:

Abra o Search Console
Adicione o e-mail da conta de serviço (formato: name@project.iam.gserviceaccount.com) como administrador da propriedade

Uso

Configuração do Claude Desktop

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

Ferramentas Disponíveis

search_analytics

Obtenha dados abrangentes de desempenho de pesquisa do Google Search Console com recursos avançados de análise.

Parâmetros obrigatórios:

siteUrl: URL do site (formato: http://www.example.com/ ou sc-domain:example.com)
startDate: Data inicial (AAAA-MM-DD)
endDate: Data final (AAAA-MM-DD)

Parâmetros opcionais:

dimensions: Lista separada por vírgulas (query, page, country, device, searchAppearance, date)
type: Tipo de pesquisa (web, image, video, news, discover, googleNews)
aggregationType: Método de agregação (auto, byNewsShowcasePanel, byProperty, byPage)
rowLimit: Número máximo de linhas a retornar (padrão: 1000, máximo: 25000)
dataState: Atualização dos dados (all ou final, padrão: final)

Parâmetros de filtro:

pageFilter: Filtrar por URL da página (suporta regex com prefixo regex:)
queryFilter: Filtrar por consulta de pesquisa (suporta regex com prefixo regex:)
countryFilter: Filtrar por código ISO 3166-1 alpha-3 do país (ex.: USA, CHN)
deviceFilter: Filtrar por tipo de dispositivo (DESKTOP, MOBILE, TABLET)
searchAppearanceFilter: Filtrar por recurso de pesquisa (ex.: AMP_BLUE_LINK, AMP_TOP_STORIES)
filterOperator: Operador para filtros (equals, contains, notEquals, notContains, includingRegex, excludingRegex)

Detecção de vitórias rápidas:

detectQuickWins: Ativar detecção automática de oportunidades de otimização (padrão: false)
quickWinsConfig: Configuração para detecção de vitórias rápidas:
- positionRange: Faixa de posição a considerar (padrão: [4, 20])
- minImpressions: Limite mínimo de impressões (padrão: 100)
- minCtr: Percentual mínimo de CTR (padrão: 1)

Exemplo - Consulta básica:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,page",
  "rowLimit": 5000
}

Exemplo - Filtragem avançada com regex:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "page,query",
  "queryFilter": "regex:(AI|machine learning|ML)",
  "filterOperator": "includingRegex",
  "deviceFilter": "MOBILE",
  "rowLimit": 10000
}

Exemplo - Detecção de vitórias rápidas:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,page",
  "detectQuickWins": true,
  "quickWinsConfig": {
    "positionRange": [4, 15],
    "minImpressions": 500,
    "minCtr": 2
  }
}

Licença

MIT

Contribuição

Contribuições são bem-vindas! Leia nossas diretrizes de contribuição antes de enviar pull requests.

Google Search Console

Documentação