Herramientas SEO MCP Server

Un servidor MCP (Protocolo de Contexto de Modelo) stdio completo para APIs de SEO. Este servidor permite que los LLM (Grandes Modelos de Lenguaje) interactúen con las funciones de la API de DataForSEO y otras herramientas de SEO.

Descripción general

El servidor MCP de herramientas de SEO permite una integración perfecta entre LLM como Claude y varias API de SEO, lo que hace posible realizar análisis de SEO, investigación de palabras clave, análisis de backlinks y muchas otras tareas relacionadas con SEO directamente a través de interacciones en lenguaje natural.

Esta implementación expone todos los puntos finales principales de la API de DataForSEO como herramientas MCP, a las que los LLM pueden acceder para recuperar datos SEO específicos. El servidor utiliza stdio como capa de transporte, lo que facilita la integración con diversas plataformas LLM.

Características

Cobertura completa de los puntos finales de la API de DataForSEO
Integración opcional con Local Falcon y otras herramientas de SEO de terceros
Transporte Stdio para una fácil integración
Manejo de autenticación
Informe detallado de errores
Definiciones de herramientas de tipo seguro con esquemas Zod
Arquitectura extensible para agregar nuevas integraciones de API

Categorías de API implementadas

API de DataForSEO

API SERP : datos de resultados de motores de búsqueda de Google, Bing, Yahoo y más
API de datos de palabras clave : investigación de palabras clave, sugerencias y datos de volumen de búsqueda
API de DataForSEO Labs : análisis SEO avanzado, comparaciones de dominios y análisis de palabras clave
API de backlinks : perfiles de backlinks, dominios de referencia y análisis de texto de anclaje
API OnPage : auditoría de sitios web, análisis de contenido y comprobaciones técnicas de SEO
API de análisis de dominio : detección de pila tecnológica y análisis de datos de dominio
API de análisis de contenido : evaluación de la calidad del contenido y análisis semántico
API de generación de contenido : herramientas de generación de contenido impulsadas por IA
API de comerciantes : datos de comercio electrónico de Amazon y Google Shopping
API de datos de aplicaciones : datos de aplicaciones móviles de Google Play y App Store
API de datos empresariales : datos de fichas empresariales de Google My Business, Trustpilot y más

API local de Falcon (opcional)

Calcular puntos de cuadrícula : generar coordenadas de cuadrícula para el análisis de clasificación local
Buscar ubicaciones de GMB : encuentre ubicaciones de Google My Business por consulta
Obtener clasificación en coordenadas : verifique la clasificación de su empresa en coordenadas específicas
Búsqueda de palabras clave en Coordinate : prueba términos de búsqueda en ubicaciones específicas
Ejecutar búsqueda en cuadrícula : realice un análisis completo de clasificación local basado en cuadrícula

Instalación

# Clone the repository
git clone https://github.com/Skobyn/dataforseo-mcp-server.git

# Change to the project directory
cd dataforseo-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Uso

Para utilizar este servidor MCP, necesita credenciales de API para los servicios que desea utilizar.

Ejecución del servidor con DataForSEO

# Set environment variables for DataForSEO authentication
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"

# Run the server
npm start

Ejecución del servidor con DataForSEO y Local Falcon

# Set environment variables for all API authentications
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"
export LOCALFALCON_API_KEY="your_localfalcon_api_key"
# Optional: Set custom Local Falcon API URL if needed
# export LOCALFALCON_API_URL="https://custom-localfalcon-url.com/api"

# Run the server
npm start

Uso con Claude u otros LLM

Este servidor implementa el Protocolo de Contexto de Modelo (MCP), que permite a los LLM interactuar con sistemas externos de forma estandarizada. Para usarlo con Claude, deberá integrarlo con su plataforma LLM según su implementación específica de MCP.

Consulte el directorio de ejemplos para ver ejemplos de uso.

Desarrollo

# Run in development mode with hot reloading
npm run dev

Ejemplos

Consulte el directorio examples para obtener un código de muestra que muestra cómo utilizar el servidor MCP de herramientas SEO.

El ejemplo básico demuestra:

Iniciando el servidor
Conectándose desde un cliente
Realizar llamadas a diferentes puntos finales de API
Manejo de los resultados

Herramientas disponibles

El servidor expone cientos de herramientas en todas las categorías de API integradas. A continuación, se muestran algunos ejemplos de las herramientas más utilizadas:

Herramientas de la API SERP de DataForSEO

serp_google_organic_live - Obtener resultados de búsqueda orgánicos de Google
serp_google_organic_task_post - Crear una tarea de búsqueda orgánica de Google
serp_google_maps_live - Obtener resultados de búsqueda de Google Maps

Herramientas de datos de palabras clave de DataForSEO

keywords_google_ads_search_volume - Obtener el volumen de búsqueda de palabras clave
keywords_google_ads_keywords_for_site - Obtenga sugerencias de palabras clave para un dominio
keywords_google_trends_explore : explora las tendencias de palabras clave a lo largo del tiempo

Herramientas de DataForSEO Labs

labs_google_keyword_ideas : obtén ideas de palabras clave basadas en palabras clave iniciales
labs_google_related_keywords - Obtenga palabras clave relacionadas
labs_google_domain_rank_overview - Obtener una descripción general del ranking del dominio

Herramientas de backlinks de DataForSEO

backlinks_summary : obtenga un resumen del perfil de backlinks de un dominio
backlinks_backlinks - Obtener una lista de backlinks para un dominio
backlinks_referring_domains - Obtener dominios de referencia para un objetivo

Herramientas locales de Falcon (si están configuradas)

localfalcon_calculate_grid_points - Calcula puntos de cuadrícula alrededor de una coordenada base
localfalcon_search_gmb_locations : busca ubicaciones de Google My Business
localfalcon_get_ranking_at_coordinate - Obtener la clasificación de la empresa en una coordenada específica
localfalcon_keyword_search_at_coordinate : busca palabras clave en una ubicación específica
localfalcon_run_grid_search : ejecuta una búsqueda de cuadrícula completa para clasificaciones locales

Lista completa de herramientas

Para obtener una lista completa de todas las herramientas disponibles y sus parámetros, consulte la implementación en el directorio src/api .

Ampliación del servidor

El servidor está diseñado para ser extensible. Para añadir compatibilidad con API de SEO adicionales:

Crea un nuevo directorio en src/api/ para tu integración
Implementar el manejo de clientes y el registro de herramientas
Agregue su integración a src/index.ts
Agregar manejo de variables de entorno para la autenticación

Consulte la integración de Local Falcon en src/api/localfalcon/ para obtener una plantilla.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

SEO Tools MCP Server

Integrations