Serpstat MCP Server

Análisis SEO utilizando la API de Serpstat.

Documentación

Servidor MCP de Serpstat

Servidor MCP (Model Context Protocol) para integración con la API de Serpstat, que implementa métodos de API para análisis SEO.

Esta es la versión alfa v0.0.2.

Requisitos

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

Para obtener el token de API:

Si no tienes una suscripción al plan: ve a https://serpstat.com y compra una suscripción o activa el acceso de prueba para los planes Team o superiores con acceso a la API habilitado.
Si ya tienes una suscripción: ve a Tu perfil de Serpstat y cópialo.

Instalación y depuración

Instala JRE 17+ si es necesario
```
sudo apt-get install openjdk-17-jre
```
Install Maven if needed
```
sudo apt-get install maven
```

Clona o crea el proyecto:

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

Compila el jar del servidor MCP
```
mvn clean package
```

Crea un script de ejecución para la herramienta de prueba

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

Revisa la consola y abre la URL dada en el 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 🚀

Integración en Claude Desktop para Linux

Haz clic en el ícono de menú (tres líneas, "hamburguesa") en la esquina superior derecha de Claude Desktop para abrir Configuración.
En el menú, selecciona General → Configuración de Claude → Configurar (esto abre la configuración de tu perfil).
En la configuración del perfil, ve a la pestaña Desarrollador y haz clic en Editar configuración para agregar o actualizar la configuración de tu servidor MCP.
Agrega la configuración con la ruta a tu archivo JAR y el token. Guárdala.

{
   "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"
         }
      }
   }
}

Integración en Claude Desktop para Windows

Sigue los pasos de la Guía de instalación del servidor MCP de Serpstat para Windows

La configuración resumida para Claude Desktop es un poco 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"
         }
      }
   }
}

¡Haz el primer informe!

Prueba el 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 Ejemplo de artefacto de informe SEO para el dominio netpeak.bg

¡Puedes probar prompts en tu 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 Ejemplo de estrategia SEO para una nueva marca

Herramientas incluidas (v.0.0.2)

`get_domains_info`

Obtén información completa del dominio usando la API de Serpstat. Devuelve visibilidad, cantidad de palabras clave, tráfico estimado, dinámicas y datos de PPC para múltiples dominios.

`domain_regions_count`

Analiza la presencia de palabras clave del dominio en todas las bases de datos regionales de Google. Muestra la cantidad de palabras clave por país, la comparación de rendimiento regional y perspectivas SEO internacionales. Comienza todo análisis complejo de dominio con esta herramienta.

`domain_keywords`

Obtén las palabras clave por las que el dominio se posiciona en los resultados de búsqueda de Google. Incluye posición, tráfico, análisis de dificultad con perspectivas SEO completas y métricas de rendimiento.

`get_domain_competitors`

Obtén los 20 principales competidores del dominio en los resultados de búsqueda con métricas SEO, tráfico, visibilidad y puntuación de relevancia.

`get_backlinks_summary`

Obtén un resumen completo de backlinks usando la API de Serpstat. Devuelve dominios de referencia, cantidad de backlinks, tipos de enlaces, métricas de calidad y cambios recientes para el dominio o subdominio.

`api_stats`

Obtén estadísticas actuales de uso de la API y límites de créditos. Muestra créditos restantes, porcentaje de uso y proporciona recomendaciones para un uso óptimo.

`projects_list`

Obtén una lista de proyectos de usuario con detalles como ID del proyecto, nombre, dominio, fecha de creación y rol del usuario. Útil para la gestión de proyectos y para obtener IDs de proyectos para otras llamadas a la API. No consume créditos de la API.,

`get_keywords` 🆕

Investiga palabras clave relacionadas y obtén volumen de búsqueda, CPC y datos de competencia. Muestra palabras clave orgánicas asociadas con la palabra clave semilla por las que los dominios se posicionan en los primeros 100 resultados de Google. Incluye volumen, costo por clic, dificultad y análisis de características de SERP. Cuesta 1 crédito de API por palabra clave devuelta.

`keyword_competitors` 🆕

Analiza los dominios que compiten por una palabra clave específica en los resultados de búsqueda de Google. Devuelve los 20 principales competidores con métricas SEO completas, incluyendo puntuaciones de visibilidad, estimaciones de tráfico, análisis de relevancia y dinámicas de mercado. Proporciona una evaluación inteligente del nivel de competencia (BAJA/MEDIA/ALTA/MUY_ALTA), identifica patrones de competencia publicitaria, analiza tendencias del mercado basadas en la dinámica de los competidores y categoriza a los competidores por niveles de rendimiento. Admite filtrado avanzado por listas de dominios, rangos de tráfico, umbrales de visibilidad y puntuaciones de relevancia. Cada competidor cuesta 1 crédito de API con un cargo mínimo de 1 crédito por solicitud (incluso para resultados vacíos). Esencial para el análisis competitivo, la evaluación de la dificultad de palabras clave y la identificación de oportunidades de mercado.

`get_related_keywords` 🆕

Encuentra palabras clave semánticamente relacionadas para expandir la estrategia de contenido. Devuelve palabras clave con volumen de búsqueda, costo por clic, fuerza de conexión, puntuaciones de dificultad y análisis semántico completo. Muestra todas las consultas de búsqueda que están semánticamente relacionadas con la palabra clave buscada, con análisis detallado de la fuerza de relación (peso), distribución de la intención de búsqueda, presencia de características de SERP y relevancia geográfica. Incluye filtrado avanzado por rangos de volumen, niveles de dificultad, fuerza de conexión, patrones de palabras clave, intenciones y características de SERP. Proporciona recomendaciones inteligentes de estrategia de contenido basadas en agrupación semántica: expansión semántica para palabras clave fuertemente conectadas, victorias rápidas para oportunidades de baja dificultad, segmentación local para términos con enfoque geográfico y estrategias de cola larga para mercados de nicho. Cada palabra clave cuesta 1 crédito de API con un cargo mínimo de un crédito por solicitud (incluso para resultados vacíos). Esencial para el análisis de brechas de contenido, planificación SEO semántica y mapeo integral del universo de palabras clave.

Registro de logs

Los logs se escriben en:

Archivo logs/serpstat-mcp-server.log (todos los niveles)

Los archivos de log se rotan automáticamente por día y tamaño.

Manejo de errores

El servidor maneja los siguientes tipos de errores:

Token de API faltante o inválido.
Parámetros de solicitud inválidos.
Errores de red y HTTP.
Errores de la API de Serpstat.
Errores internos del servidor.

Integración

Establece la variable de entorno con el token de API:

Ejecuta el siguiente comando en la terminal (reemplaza your_serpstat_api_token_here con tu token):

export SERPSTAT_API_TOKEN=your_serpstat_api_token_here

Seguridad

El token de API se pasa a través de una variable de entorno.
El token no se registra completamente.
Todas las solicitudes HTTP usan HTTPS.
Se configuran tiempos de espera para evitar bloqueos.

Soporte

La forma más efectiva de recibir soporte de Serpstat es usar su función de chat en vivo directamente dentro de la plataforma.

Alternativamente, puedes enviarles un correo a support@serpstat.com

Licencia

Licencia MIT

Esto está bajo la licencia MIT, lo que significa que puedes copiar, usar, modificar e incluso vender cualquier parte de este código sin ningún problema.
¿Quieres tomar una parte para tu proyecto? Adelante.
¿Quieres reescribir la mitad y lanzar un producto comercial? Siéntete libre.
Lo único que necesitas hacer es no eliminar los derechos de autor y la licencia de los archivos que tomes, y recuerda al equipo de Serpstat con una palabra amable cuando recibas ese cheque.

Con cariño, el equipo de I+D de Serpstat