Google Search Console

Servidor MCP do Google Search Console

Um servidor Model Context Protocol (MCP) que fornece acesso ao Google Search Console.

Recursos

• Recuperação de dados de análise de pesquisa com suporte a dimensões
• Análise rica de dados com períodos de relatório personalizáveis

Pré-requisitos

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

Instalação

Instalação via Smithery

Para instalar o Google Search Console para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install mcp-server-gsc --client claude

Instalação Manual

npm install mcp-server-gsc

Configuração de Autenticação

Para obter as credenciais da API do Google Search Console:

1. Visite o Google Cloud Console
2. Crie um novo projeto ou selecione um existente
3. Ative a API:

• Vá para "APIs & Services" > "Library"
• Pesquise e ative a "Search Console API"

4. 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

5. 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 de desempenho de pesquisa do Google Search Console com parâmetros personalizáveis:

Parâmetros Obrigatórios:

• siteUrl: URL do site (formato: http://www.example.com/ ou sc-domain:example.com)
• startDate: Data de início (AAAA-MM-DD)
• endDate: Data de término (AAAA-MM-DD)

Parâmetros Opcionais:

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

Exemplo:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,country",
  "type": "web",
  "rowLimit": 500
}

Licença

MIT

Contribuição

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