Serpstat MCP Server

Análise de SEO usando a API do Serpstat.

Documentação

Serpstat MCP Server

Servidor MCP (Model Context Protocol) para integração com a API Serpstat, implementando métodos de API para análise de SEO.

Esta é a versão alfa v0.0.2.

Requisitos

Java: 17+
Maven: 3.6+
Token da API Serpstat

Para obter o token da API:

Se você não tinha uma assinatura do plano: acesse https://serpstat.com e compre uma assinatura ou ative o acesso de teste para planos Team ou superiores com acesso à API habilitado.
Se você já tem uma assinatura: acesse Seu Perfil Serpstat e copie-o.

Instalação e depuração

Instale o JRE 17+ se necessário
```
sudo apt-get install openjdk-17-jre
```
Install Maven if needed
```
sudo apt-get install maven
```

Clone ou crie o projeto:

mkdir serpstat-mcp-server
cd serpstat-mcp-server

Compile o jar do servidor MCP
```
mvn clean package
```

Crie o script de execução para a ferramenta de teste

 cp inspect.sh.example inspect.sh
 chmod +x inspect.sh
 # edit file and set token
 vi inspect.sh
 ./inspect.sh

Verifique o console e abra a URL fornecida no navegador

user@pc:~/repo/serpstat-mcp-server-java$ ./inspect.sh
Starting MCP inspector...
⚙️ Proxy server listening on port 6277
🔍 MCP Inspector is up and running at http://127.0.0.1:6274 🚀

Integração no Claude Desktop para Linux

Clique no ícone de menu (três linhas, "hambúrguer") no canto superior direito do Claude Desktop para abrir Configurações.
No menu, selecione Geral → Configurações do Claude → Configurar (isso abre as configurações do seu perfil).
Nas configurações do perfil, vá para a aba Desenvolvedor e clique em Editar configuração para adicionar ou atualizar a configuração do seu servidor MCP.
Adicione a configuração com o caminho para o arquivo JAR e o token. Salve-a.

{
   "mcpServers": {
      "serpstat": {
         "command": "java",
         "args": ["-jar", "/path/to/jar/location/serpstat-mcp-server-java-0.0.2.jar"],
         "env": {
            "SERPSTAT_API_TOKEN": "PLACE_API_TOKEN_HERE",
            "LANG": "en_US.UTF-8",
            "LC_ALL": "en_US.UTF-8"
         }
      }
   }
}

Integração no Claude Desktop para Windows

Siga os passos do Guia de Instalação do Serpstat MCP Server para Windows

TL;DR a configuração para o Claude Desktop é um pouco diferente

{
   "mcpServers": {
      "serpstat": {
         "command": "java",
         "args": [
            "-Dfile.encoding=UTF-8",
            "-Dconsole.encoding=UTF-8",
            "-jar",
            "c:/serpstat_mcp/serpstat-mcp-server-java-0.0.2.jar"
         ],
         "env": {
            "SERPSTAT_API_TOKEN": "PLACE_YOUR_TOKEN_HERE",
            "JAVA_TOOL_OPTIONS": "-Dfile.encoding=UTF-8"
         }
      }
   }
}

Faça o Primeiro Relatório!

Experimente o prompt Would you mind to make me a comprehensive SEO report for the netpeak.bg with Serpstat?

Screen shot of SEO Report generated by Claude with connected Serpstat MCP Server

#1 Exemplo de Artefato de Relatório SEO para o domínio netpeak.bg

Você pode experimentar prompts no seu idioma!

Przygotujmy nową markę do wejścia na rynek warszawski za pomocą Serpstat. Będziemy sprzedawać pierogi i wypieki. Nazwa "Gorące Sztuki". 
* Przemyśl strategię wejścia na rynek.
* Zbierz semantykę dla niszy.
* Przeanalizuj konkurentów. 
* Zbierz pominiętą przez nich semantykę. 
* Stwórz rdzeń semantyczny i sklastruj

Screen shot of SEO Strategy Report generated by Claude with connected Serpstat MCP Server in Polish

#2 Exemplo de Estratégia SEO para uma nova marca

Ferramentas Incluídas (v.0.0.2)

`get_domains_info`

Obtenha informações abrangentes do domínio usando a API Serpstat. Retorna visibilidade, contagem de palavras-chave, tráfego estimado, dinâmica e dados de PPC para vários domínios.

`domain_regions_count`

Analise a presença de palavras-chave do domínio em todos os bancos de dados regionais do Google. Mostra a contagem de palavras-chave por país, comparação de desempenho regional e insights internacionais de SEO. Comece toda análise complexa de domínio com esta ferramenta.

`domain_keywords`

Obtenha as palavras-chave para as quais o domínio ranqueia nos resultados de busca do Google. Inclui posição, tráfego, análise de dificuldade com insights abrangentes de SEO e métricas de desempenho.

`get_domain_competitors`

Obtenha os 20 principais concorrentes do domínio nos resultados de busca, com métricas de SEO, tráfego, visibilidade e pontuação de relevância.

`get_backlinks_summary`

Obtenha um resumo abrangente de backlinks usando a API Serpstat. Retorna domínios de referência, contagem de backlinks, tipos de links, métricas de qualidade e mudanças recentes para domínio ou subdomínio.

`api_stats`

Obtenha estatísticas atuais de uso da API e limites de crédito. Mostra créditos restantes, porcentagem de uso e fornece recomendações para uso ideal.

`projects_list`

Obtenha uma lista de projetos do usuário com detalhes como ID do projeto, nome, domínio, data de criação e função do usuário. Útil para gerenciamento de projetos e obtenção de IDs de projeto para outras chamadas de API. Não consome créditos da API.

`get_keywords` 🆕

Pesquise palavras-chave relacionadas e obtenha volume de busca, CPC e dados de concorrência. Mostra palavras-chave orgânicas associadas à palavra-chave semente que os domínios ranqueiam nos 100 melhores resultados do Google. Inclui volume, custo por clique, dificuldade e análise de recursos de SERP. Custa 1 crédito de API por palavra-chave retornada.

`keyword_competitors` 🆕

Analise domínios que competem por uma palavra-chave específica nos resultados de busca do Google. Retorna os 20 principais concorrentes com métricas abrangentes de SEO, incluindo pontuações de visibilidade, estimativas de tráfego, análise de relevância e dinâmica de mercado. Fornece avaliação inteligente do nível de concorrência (BAIXO/MÉDIO/ALTO/MUITO_ALTO), identifica padrões de concorrência publicitária, analisa tendências de mercado com base na dinâmica dos concorrentes e categoriza concorrentes por níveis de desempenho. Suporta filtragem avançada por listas de domínios, faixas de tráfego, limites de visibilidade e pontuações de relevância. Cada concorrente custa 1 crédito de API com cobrança mínima de 1 crédito por solicitação (mesmo para resultados vazios). Essencial para análise competitiva, avaliação de dificuldade de palavras-chave e identificação de oportunidades de mercado.

`get_related_keywords` 🆕

Encontre palavras-chave semanticamente relacionadas para expandir a estratégia de conteúdo. Retorna palavras-chave com volume de busca, custo por clique, força de conexão, pontuações de dificuldade e análise semântica abrangente. Mostra todas as consultas de busca semanticamente relacionadas à palavra-chave pesquisada, com análises detalhadas sobre a força do relacionamento (peso), distribuição de intenção de busca, presença de recursos de SERP e relevância geográfica. Inclui filtragem avançada por faixas de volume, níveis de dificuldade, força de conexão, padrões de palavras-chave, intenções e recursos de SERP. Fornece recomendações inteligentes de estratégia de conteúdo com base em agrupamento semântico: expansão semântica para palavras-chave fortemente conectadas, vitórias rápidas para oportunidades de baixa dificuldade, segmentação local para termos geográficos e estratégias de cauda longa para mercados de nicho. Cada palavra-chave custa 1 crédito de API com cobrança mínima de um crédito por solicitação (mesmo para resultados vazios). Essencial para análise de lacunas de conteúdo, planejamento de SEO semântico e mapeamento abrangente do universo de palavras-chave.

Registro de Logs

Os logs são gravados em:

Arquivo logs/serpstat-mcp-server.log (todos os níveis)

Os arquivos de log são rotacionados automaticamente por dia e tamanho.

Tratamento de Erros

O servidor lida com os seguintes tipos de erros:

Token de API ausente ou inválido.
Parâmetros de solicitação inválidos.
Erros de rede e HTTP.
Erros da API Serpstat.
Erros internos do servidor.

Integração

Defina a variável de ambiente com o token da API:

Execute o seguinte comando no terminal (substitua your_serpstat_api_token_here pelo seu token):

export SERPSTAT_API_TOKEN=your_serpstat_api_token_here

Segurança

O token da API é passado por uma variável de ambiente.
O token não é totalmente registrado em logs.
Todas as solicitações HTTP usam HTTPS.
Timeouts são configurados para evitar travamentos.

Suporte

A maneira mais eficaz de receber suporte da Serpstat é usar o recurso de chat ao vivo diretamente na plataforma.

Alternativamente, você pode enviar um e-mail para support@serpstat.com

Licença

Licença MIT

Esta coisa está sob a licença MIT, o que significa que você pode copiar, usar, modificar e até vender qualquer parte deste código sem complicações.
Quer pegar um pedaço para o seu projeto? Pode ir em frente.
Quer reescrever metade e lançar um produto comercial? Fique à vontade.
A única coisa que você precisa fazer é não excluir os direitos autorais e a própria licença dos arquivos que você pegar, e lembrar da equipe Serpstat com uma palavra gentil quando receber esse pagamento.

Com amor, Equipe de P&D da Serpstat

Serpstat MCP Server

Documentação