Repolode
AminForou

AminForou/mcp-gsc

Um servidor Model Context Protocol que conecta dados do Google Search Console a assistentes de IA como Claude, Cursor e Codex para análise de SEO em linguagem natural.

Estrelas
1,984
Forks
276
Issues abertas
15
Último commit
mês passado

O que é?

mcp-gsc é um servidor Model Context Protocol (MCP) que conecta o Google Search Console a assistentes de IA. Depois de configurá-lo em um cliente como Claude Desktop, Cursor, Codex CLI ou Gemini CLI, você pode fazer perguntas em linguagem natural sobre o desempenho de busca do seu site, como quais consultas geram tráfego ou quais páginas perderam cliques.

O servidor disponibiliza cerca de 20 ferramentas para gerenciamento de propriedades, análise de busca com filtros por país, dispositivo, consulta e página, comparação entre períodos, inspeção de URLs para verificar o status de indexação, verificação em lote de até 10 URLs e listagem e envio de sitemaps. A autenticação pode ser feita com um cliente OAuth para desktop que usa sua própria conta Google ou com uma service account para automação e uso em equipe. Operações destrutivas, como excluir sites ou sitemaps, ficam desativadas, a menos que sejam habilitadas explicitamente.

Por padrão, o servidor é executado localmente via stdio, mas também pode ser implantado via SSE com Docker para uso remoto.

Recursos principais

  • 01Consultar análises de busca por país, dispositivo, consulta e página, com filtros e ordenação.
  • 02Comparar o desempenho entre dois períodos.
  • 03Inspecionar o status de indexação de URLs, incluindo problemas com resultados avançados, individualmente ou em lote.
  • 04Listar, inspecionar e enviar sitemaps.
  • 05Oferece suporte a OAuth para contas pessoais e a service accounts para automação.
  • 06As ferramentas destrutivas ficam desativadas por padrão.

Casos de uso

  • Pedir a um assistente de IA um resumo semanal do desempenho de SEO de um site.
  • Encontrar consultas em que várias páginas competem entre si e decidir quais manter.
  • Auditar problemas de indexação em um conjunto de páginas importantes.
  • Identificar consultas com muitas impressões e CTR baixo para melhorar os títulos.

Início rápido

  1. 1

    Instale o uv (execute o instalador).

    Instale seguindo as instruções oficiais do README
  2. 2

    Crie as credenciais da Google API (cliente OAuth ou conta de serviço) e salve o arquivo JSON.

  3. 3

    Adicione a configuração do servidor uvx ao seu cliente de IA (por exemplo, Claude Desktop), indicando o caminho do arquivo de credenciais.

  4. 4

    Reinicie o cliente e peça para listar suas propriedades do GSC.

Antes de usar

  • Para funcionar, é necessário configurar as credenciais do Google Cloud e ativar a API Search Console.
  • O README promove uma versão hospedada paga com número limitado de vagas.

Tópicos

Perguntas frequentes

O que é mcp-gsc?
Um servidor Model Context Protocol que conecta dados do Google Search Console a assistentes de IA como Claude, Cursor e Codex para análise de SEO em linguagem natural. mcp-gsc é um servidor Model Context Protocol (MCP) que conecta o Google Search Console a assistentes de IA. Depois de configurá-lo em um cliente como Claude Desktop, Cursor, Codex CLI ou Gemini CLI, você pode fazer perguntas em linguagem natural sobre o desempenho de busca do seu site, como quais consultas geram tráfego ou quais páginas perderam cliques.
mcp-gsc é gratuito? Qual é a licença?
mcp-gsc é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-gsc ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de mcp-gsc foi em 15 de set. de 2026.
Para que posso usar mcp-gsc?
Pedir a um assistente de IA um resumo semanal do desempenho de SEO de um site. Encontrar consultas em que várias páginas competem entre si e decidir quais manter. Auditar problemas de indexação em um conjunto de páginas importantes. Identificar consultas com muitas impressões e CTR baixo para melhorar os títulos.
Como instalar mcp-gsc?
Instale o uv (execute o instalador). Crie as credenciais da Google API (cliente OAuth ou conta de serviço) e salve o arquivo JSON. Adicione a configuração do servidor uvx ao seu cliente de IA (por exemplo, Claude Desktop), indicando o caminho do arquivo de credenciais. Reinicie o cliente e peça para listar suas propriedades do GSC.
Onde consigo mcp-gsc?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/AminForou/mcp-gsc

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados