Servidor MCP de herramientas SEO

Un servidor MCP (Model Context Protocol) stdio completo para API de SEO. Este servidor permite a los LLM (Modelos de Lenguaje Extensos) interactuar con las funciones de la API de DataForSEO y otras herramientas de SEO.

Descripción general

El servidor MCP de herramientas SEO permite una integración fluida 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 el 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, que los LLM pueden llamar para recuperar datos de SEO específicos. El servidor utiliza stdio como su capa de transporte, lo que facilita la integración con varias plataformas de LLM.

Related MCP server: DataForSEO MCP Server

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

• Gestión de autenticación

• Informes de errores detallados

• Definiciones de herramientas con seguridad de tipos mediante esquemas Zod

• Arquitectura extensible para añadir nuevas integraciones de API

• Filtrado selectivo de módulos y herramientas mediante variables de entorno

Regístrate en Data for Seo

https://dataforseo.com/?aff=200885

Categorías de API implementadas

API de DataForSEO

1. API de SERP - Datos de resultados de motores de búsqueda de Google, Bing, Yahoo y más

2. API de datos de palabras clave - Investigación de palabras clave, sugerencias y datos de volumen de búsqueda

3. API de DataForSEO Labs - Análisis de SEO avanzado, comparaciones de dominios y análisis de palabras clave

4. API de backlinks - Perfiles de backlinks, dominios de referencia y análisis de texto de anclaje

5. API OnPage - Auditoría de sitios web, análisis de contenido y comprobaciones técnicas de SEO

6. API de análisis de dominios - Detección de pila tecnológica y análisis de datos de dominios

7. API de análisis de contenido - Evaluación de la calidad del contenido y análisis semántico

8. API de generación de contenido - Herramientas de generación de contenido impulsadas por IA

9. API de Merchant - Datos de comercio electrónico de Amazon y Google Shopping

10. API de datos de aplicaciones - Datos de aplicaciones móviles de Google Play y App Store

11. API de datos empresariales - Datos de listados de empresas de Google My Business, Trustpilot y más

12. API de optimización de IA - Respuestas de LLM, scraper de IA y datos de palabras clave de IA de ChatGPT, Claude, Gemini y Perplexity

API de Local Falcon (Opcional)

1. Calcular puntos de cuadrícula - Generar coordenadas de cuadrícula para el análisis de clasificación local

2. Buscar ubicaciones de GMB - Encontrar ubicaciones de Google My Business por consulta

3. Obtener clasificación en coordenadas - Comprobar la clasificación de la empresa en coordenadas específicas

4. Búsqueda de palabras clave en coordenadas - Probar términos de búsqueda en ubicaciones específicas

5. Ejecutar búsqueda en cuadrícula - Realizar 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, necesitas credenciales de API para los servicios que deseas 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

Filtrado de módulos y herramientas

El servidor expone cientos de herramientas de forma predeterminada. Cuando se utiliza con LLM, la lista completa de herramientas consume un espacio significativo en la ventana de contexto. Puedes reducir el número de herramientas expuestas utilizando variables de entorno para habilitar solo los módulos o herramientas que necesites.

¿Por qué filtrar?

• Reducir el uso de contexto

• Descubrimiento de herramientas más rápido para el LLM

• Respuestas más enfocadas

Filtrar por módulo

Utiliza ENABLED_MODULES para habilitar solo categorías de API específicas (separadas por comas, sin distinción entre mayúsculas y minúsculas):

export ENABLED_MODULES="SERP,BUSINESS_DATA,LABS"

Módulos disponibles:

• SERP - Resultados de motores de búsqueda

• KEYWORDS_DATA - Investigación de palabras clave

• LABS o DATAFORSEO_LABS - Análisis de SEO avanzado

• BACKLINKS - Análisis de backlinks

• ONPAGE - Auditorías de sitios web

• DOMAIN_ANALYTICS - Datos de dominios

• CONTENT_ANALYSIS - Evaluación de contenido

• CONTENT_GENERATION - Generación de contenido por IA

• MERCHANT - Datos de comercio electrónico

• APP_DATA - Datos de aplicaciones móviles

• BUSINESS_DATA - Listados de empresas

• AI_OPTIMIZATION - Respuestas de LLM y datos de IA

Filtrar por herramienta individual

Utiliza ENABLED_TOOLS para un control preciso sobre herramientas específicas (separadas por comas, sin distinción entre mayúsculas y minúsculas):

export ENABLED_TOOLS="serp_google_maps_live,business_data_google_my_business_info"

Si no se establece ninguna variable, todos los módulos y herramientas están habilitados de forma predeterminada.

Suscripciones con alcance de módulo y errores 404

El acceso a DataForSEO a menudo se otorga por módulo, no como una suscripción única de todo o nada. Eso significa que algunos puntos finales pueden funcionar mientras que otros devuelven 404.

Regla de interpretación importante:

• Un 404 en puntos finales activos conocidos como SERP, App Data, DataForSEO Labs App Store o Content Generation puede significar que el módulo no está habilitado para la cuenta actual

• esto no es necesariamente un error en el servidor MCP o una ruta de punto final incorrecta

• los puntos finales de descubrimiento gratuitos, como ubicaciones o idiomas, pueden seguir funcionando incluso cuando los puntos finales activos de pago en la misma área general no están disponibles

El servidor ahora normaliza las respuestas 404 con alcance de módulo conocidas en un mensaje más claro:

• DataForSEO module not enabled: <module> ...

Cuando esto suceda, habilita el módulo en el panel de control de DataForSEO o cambia a herramientas de módulos que ya estén habilitados para la cuenta actual.

Uso con Claude u otros LLM

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

Consulta el directorio de ejemplos para ver ejemplos de uso.

Desarrollo

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

Ejemplos

Consulta el directorio examples para ver código de muestra que muestra cómo utilizar el servidor MCP de herramientas SEO.

El ejemplo básico demuestra:

• Iniciar el servidor

• Conectarse a él desde un cliente

• Realizar llamadas a diferentes puntos finales de la API

• Manejar 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ánica 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 volumen de búsqueda para palabras clave

• keywords_google_ads_keywords_for_site - Obtener sugerencias de palabras clave para un dominio

• keywords_google_trends_explore - Explorar tendencias de palabras clave a lo largo del tiempo

Herramientas de DataForSEO Labs

• labs_google_keyword_ideas - Obtener ideas de palabras clave basadas en palabras clave semilla

• labs_google_related_keywords - Obtener palabras clave relacionadas

• labs_google_domain_rank_overview - Obtener una descripción general de la clasificación de dominios

Herramientas de backlinks de DataForSEO

• backlinks_summary - Obtener 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

• backlinks_history - Obtener datos históricos de backlinks para un objetivo

• backlinks_timeseries_summary - Obtener datos de series temporales sobre backlinks

• backlinks_bulk_new_lost_backlinks - Obtener backlinks nuevos y perdidos para múltiples objetivos

• backlinks_bulk_new_lost_referring_domains - Obtener dominios de referencia nuevos y perdidos para múltiples objetivos

• backlinks_bulk_pages_summary - Obtener resúmenes de página para múltiples objetivos

Herramientas de optimización de IA de DataForSEO

• ai_chatgpt_models - Obtener lista de modelos de ChatGPT disponibles

• ai_chatgpt_llm_responses_live - Obtener respuestas en vivo de ChatGPT

• ai_chatgpt_scraper_locations - Obtener ubicaciones disponibles para el scraper de ChatGPT

• ai_chatgpt_scraper_languages - Obtener idiomas disponibles para el scraper de ChatGPT

• ai_claude_models - Obtener lista de modelos de Claude disponibles

• ai_claude_llm_responses_live - Obtener respuestas en vivo de Claude

• ai_gemini_models - Obtener lista de modelos de Gemini disponibles

• ai_gemini_llm_responses_live - Obtener respuestas en vivo de Gemini

• ai_perplexity_models - Obtener lista de modelos de Perplexity disponibles

• ai_perplexity_llm_responses_live - Obtener respuestas en vivo de Perplexity

• ai_keyword_data_search_volume_live - Obtener datos de volumen de búsqueda de palabras clave de IA

• ai_keyword_data_locations_and_languages - Obtener ubicaciones e idiomas disponibles para datos de palabras clave de IA

Herramientas de Local Falcon (si está configurado)

• localfalcon_calculate_grid_points - Calcular puntos de cuadrícula alrededor de una coordenada base

• localfalcon_search_gmb_locations - Buscar ubicaciones de Google My Business

• localfalcon_get_ranking_at_coordinate - Obtener clasificación de empresa en coordenadas específicas

• localfalcon_keyword_search_at_coordinate - Buscar palabras clave en una ubicación específica

• localfalcon_run_grid_search - Ejecutar 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, consulta la implementación en el directorio src/api.

Extensión del servidor

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

1. Crea un nuevo directorio en src/api/ para tu integración

2. Implementa el manejo del cliente y el registro de herramientas

3. Añade tu integración a src/index.ts

4. Añade el manejo de variables de entorno para la autenticación

Consulta la integración de Local Falcon en src/api/localfalcon/ como plantilla.

Licencia

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• app_data_app_store_app_infoD
• app_data_app_store_languagesD
• app_data_app_store_locationsD
• app_data_app_store_reviewsD
• app_data_app_store_searchD
• app_data_google_play_app_infoD
• app_data_google_play_languagesD
• app_data_google_play_locationsD