SEO MCP

Descripción del Proyecto

SEO MCP (Protocolo de Control de Modelos) es una herramienta gratuita de SEO que utiliza datos de Ahrefs. Ofrece una API para obtener datos de SEO de Ahrefs, encargándose de resolver CAPTCHAs, la autenticación y la extracción de datos. Los resultados se guardan en caché para mejorar el rendimiento y reducir los costes de la API.

Este servicio está pensado para fines educativos.

Instrucciones de Uso

Requisitos Previos

• Python 3.10 o superior
• Cuenta y clave API de CapSolver

Instalación

Instalar desde PyPI

pip install seo-mcp
# O usando uv
uv pip install seo-mcp

Instalación Manual

1. Clonar el repositorio:

   git clone https://github.com/cnych/seo-mcp.git
   cd seo-mcp
   

2. Instalar dependencias:

   pip install -e .
   # O
   uv pip install -e .
   

3. Configurar la clave API de CapSolver:

   export CAPSOLVER_API_KEY="tu-clave-api-capsolver"
   

Ejecutar el Servicio

Usar en Cursor IDE

En la configuración de Cursor, ve a la pestaña MCP, haz clic en "+Añadir nuevo servidor MCP global" e introduce:

{
  "mcpServers": {
    "SEO MCP": {
      "command": "uvx",
      "args": ["--python", "3.10", "seo-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "CAP-xxxxxx"
      }
    }
  }
}

Referencia de la API

• get_backlinks_list(domain: str): Obtener los backlinks de un dominio.
  • Parámetros: domain (cadena de texto, ej., "example.com")
• keyword_generator(keyword: str, country: str = "us", search_engine: str = "Google"): Generar ideas de palabras clave.
  • Parámetros: keyword (cadena de texto), country (cadena de texto, por defecto: "us"), search_engine (cadena de texto, por defecto: "Google")
• get_traffic(domain_or_url: str, country: str = "None", mode: str = "subdomains"): Estimar el tráfico.
  • Parámetros: domain_or_url (cadena de texto), country (cadena de texto, por defecto: "None"), mode (cadena de texto, "subdomains" o "exact")
• keyword_difficulty(keyword: str, country: str = "us"): Obtener la dificultad de una palabra clave.
  • Parámetros: keyword (cadena de texto), country (cadena de texto, por defecto: "us")

Características Principales

• Análisis de Backlinks: Obtén datos detallados de backlinks (autoridad de dominio, texto ancla, atributos de enlace), filtra dominios educativos y gubernamentales.
• Investigación de Palabras Clave: Genera ideas de palabras clave, consulta su dificultad, volumen de búsqueda y tendencias.
• Análisis de Tráfico: Estima el tráfico de un sitio web, revisa el historial, páginas populares, distribución por país y seguimiento de rankings de palabras clave.
• Optimización del Rendimiento: Usa CapSolver para la resolución automática de CAPTCHAs, incluye caché de respuestas.
• Integración de Datos de Ahrefs: Recopila datos de SEO directamente de Ahrefs.

Usuarios Objetivos

Esta herramienta es para desarrolladores, profesionales de SEO e investigadores que necesitan acceso programático a los datos de Ahrefs para análisis, automatización o fines educativos.

Enlaces del Proyecto

• Repositorio GitHub: https://github.com/cnych/seo-mcp

Escenarios de Aplicación

• Recopilación automatizada de datos de SEO desde Ahrefs.
• Creación de paneles o herramientas de SEO personalizados.
• Investigación de perfiles de backlinks para análisis de la competencia.
• Generación de ideas de palabras clave para la creación de contenido.
• Monitorización programática del tráfico web y los rankings de palabras clave.