Semust

Servidor MCP de Semust

Pregúntale a Claude sobre tus datos de SEO y publicidad en lenguaje natural. Este servidor MCP conecta Claude Desktop (y Cursor) con tu cuenta de Semust: palabras clave, páginas, tendencias de tráfico, informes de SEO, Google Analytics, Google Ads, Yandex Metrica, Bing Webmaster y más.

"Muéstrame mis palabras clave principales del último mes"

"¿Qué páginas están perdiendo tráfico?"

"¿Cómo está mi tráfico orgánico en comparación con el mes pasado?"

"¿Qué páginas de aterrizaje convierten mejor?"

"¿Cómo están funcionando mis campañas de Google Ads?"

Cómo Funciona

You ask Claude a question
        |
Claude Desktop (on your machine)
        |
   MCP Server (on your machine) ---- Your API key stays here, never sent to Claude
        |
   Semust API (semust.com)
        |
   Your Google Search Console, Analytics & Ads data
        |
   Results sent back to Claude
        |
Claude answers with SEO insights

Tu clave de API nunca sale de tu máquina. Claude solo ve los datos de SEO, no tus credenciales.

Lo Que Puedes Preguntar

Una vez configurado, solo habla con Claude de forma natural:

Tráfico y Rendimiento

• "¿Cómo está funcionando mi sitio este mes?"
• "Muéstrame el tráfico diario de los últimos 30 días"
• "¿Mi tráfico está creciendo o disminuyendo?"

Palabras Clave

• "¿Cuáles son mis 20 palabras clave principales?"
• "¿Qué palabras clave están en la página 2? Esas son mis victorias rápidas"
• "Busca oportunidades de palabras clave de cola larga"

Google Analytics

• "¿De dónde viene mi tráfico?"
• "¿Cómo está funcionando el tráfico orgánico vs. el de pago?"
• "¿Qué páginas de aterrizaje convierten mejor?"
• "Muéstrame el desglose móvil vs. escritorio"
• "¿Qué páginas tienen el peor compromiso?"

Rastreador de Posiciones

• "¿En qué posición estoy para mis palabras clave?"
• "¿Qué palabras clave ganaron o perdieron posiciones?"
• "¿Cuántas palabras clave están en la página 1?"

Rastreador de IA

• "¿Aparezco en los resúmenes de IA de Google?"
• "¿Qué competidores se citan en las respuestas de IA?"

Monitor de Indexación

• "¿Todas mis páginas están indexadas?"
• "¿Cuál es mi puntuación de salud de indexación?"

Yandex Metrica

• "¿Cómo está mi tráfico de Yandex?"
• "¿Qué está buscando la gente en Yandex?"
• "Muéstrame las fuentes de tráfico de Yandex"

Bing Webmaster

• "¿Cómo están mis páginas en Bing?"
• "Muéstrame los problemas de rastreo de Bing"
• "¿Cuáles son mis enlaces entrantes de Bing?"

Google Ads

• "¿Cómo están funcionando mis campañas?"
• "¿Cuánto estoy gastando y cuál es mi ROAS?"
• "¿Qué términos de búsqueda activan mis anuncios?"
• "Muéstrame el rendimiento de los anuncios por país"
• "¿Qué tipos de conversiones estoy obteniendo?"

Análisis de Contenido

• "¿Qué páginas están perdiendo tráfico? Necesito actualizarlas"
• "Muéstrame mi contenido con peor rendimiento"
• "¿Tengo problemas de canibalización de palabras clave?"

Informes

• "Genera un informe SEO mensual para mayo de 2026"
• "¿Qué palabras clave ganaron o perdieron tráfico este mes?"
• "Encuentra palabras clave con CTR bajo que deba optimizar"
• "Dame un informe completo de SEO + analítica"

Ideas de Contenido

• "¿Qué preguntas hace la gente que llevan a mi sitio?"
• "Muéstrame palabras clave de cola larga con 4+ palabras"

Inicio Rápido

Paso 1: Obtén Tu Clave de API

Inicia sesión en Semust > Configuración > Clave de API > Copiar.

Asegúrate de tener al menos un proyecto con Google Search Console conectado.

Paso 2: Descarga e Instala

Opción A: Descargar ZIP (la más fácil)

Descargar ZIP > Extrae a una carpeta que recuerdes.

Opción B: Git Clone

git clone https://github.com/semust/semust-mcp.git

Luego instala las dependencias:

cd semust-mcp
pip install -r requirements.txt

Paso 3: Configura Claude Desktop

Encuentra tu archivo de configuración de Claude Desktop:

%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\

%APPDATA%\Claude\

~/Library/Application Support/Claude/claude_desktop_config.json

Añade mcpServers al archivo. Si el archivo ya tiene contenido, fusiona esto con el JSON existente:

{
  "mcpServers": {
    "semust": {
      "command": "python",
      "args": ["C:\\full\\path\\to\\semust-mcp\\semust_mcp.py"],
      "env": {
        "SEMUST_API_KEY": "your-api-key-here",
        "SEMUST_BASE_URL": "https://api.semust.com/v1/mcp"
      },
      "alwaysAllow": [
        "list_projects",
        "get_keywords", "get_pages", "get_performance",
        "report_cannibalization", "report_monthly_summary", "report_long_tail",
        "report_winner_loser", "report_questions", "report_content_decay",
        "report_striking_distance", "report_low_ctr", "report_thin_content",
        "ga_get_overview", "ga_get_traffic_sources", "ga_get_pages",
        "ga_get_geo", "ga_get_devices", "ga_get_key_events",
        "ga_report_traffic_trends", "ga_report_landing_page_performance",
        "ga_report_channel_comparison", "ga_report_engagement_analysis",
        "gads_get_campaigns", "gads_get_daily_metrics", "gads_get_geo",
        "gads_get_devices", "gads_get_search_terms",
        "gads_report_performance_overview", "gads_report_spend_analysis",
        "gads_report_conversion_breakdown",
        "rank_get_keywords", "rank_get_overview", "rank_get_history",
        "rank_report_gainers_losers", "rank_report_distribution",
        "ai_rank_get_overview", "ai_rank_get_keywords", "ai_rank_get_domains",
        "indexing_get_status", "indexing_get_history",
        "ym_get_overview", "ym_get_traffic", "ym_get_pages",
        "ym_get_geo", "ym_get_devices", "ym_get_search_phrases",
        "bing_get_query_stats", "bing_get_page_stats", "bing_get_crawl_stats",
        "bing_get_crawl_issues", "bing_get_rank_traffic", "bing_get_link_counts",
        "bing_get_keyword_stats", "bing_get_url_traffic", "bing_get_url_links"
      ]
    }
  }
}

Importante: Reemplaza la ruta con la ubicación real de semust_mcp.py en tu máquina.

Windows: Usa dobles barras invertidas: C:\\Users\\you\\semust-mcp\\semust_mcp.py

Si python no funciona: Usa la ruta completa de Python en su lugar, por ejemplo: C:\\Users\\you\\AppData\\Local\\Programs\\Python\\Python312\\python.exe

alwaysAllow: Esta lista permite que Claude use las herramientas de Semust sin pedir permiso cada vez. Todas las herramientas son de solo lectura y seguras para aprobación automática. Elimina este campo si prefieres aprobar cada llamada a herramienta manualmente.

Cierra Claude Desktop por completo (clic derecho en el icono de la bandeja del sistema > Salir) y vuelve a abrirlo.

Paso 4: Verificación

En un nuevo chat de Claude, busca el icono de herramientas (martillo/llave inglesa) cerca del campo de texto. Haz clic en él: deberías ver "semust-mcp" con 56 herramientas.

Escribe: "Muéstrame mis proyectos" — Claude debería listar tus proyectos de Semust.

Seguridad

• El servidor MCP se ejecuta localmente en tu computadora — no es un servicio en la nube
• Tu clave de API de Semust se usa solo para solicitudes directas desde tu máquina a api.semust.com
• Claude ve las respuestas de datos de SEO pero nunca tu clave de API ni tus credenciales de autenticación
• El archivo .env está en .gitignore — no se confirmará accidentalmente en git
• El servidor se niega a iniciar si SEMUST_BASE_URL es http:// (no localhost) — tu clave nunca se envía en texto plano
• Protege tu archivo de configuración de Claude Desktop — cualquiera con acceso de lectura puede leer tu clave de API
• Los datos de SEO que se pasan a Claude se tratan como contenido de confianza del usuario; si tu Search Console contiene consultas de spam con instrucciones incrustadas, el modelo podría actuar en consecuencia — esto es inherente a todas las herramientas MCP que muestran datos de terceros

Herramientas Disponibles (56)

Proyectos

Search Console — Datos

Search Console — Informes

Google Analytics — Datos

Google Analytics — Informes

Google Ads — Datos

Google Ads — Informes

Rastreador de Posiciones

Rastreador de IA

Monitor de Indexación

Yandex Metrica

Bing Webmaster

Configuración en Cursor

Añade el mismo servidor MCP en Cursor: Configuración > Servidores MCP > Añadir servidor (tipo stdio).

Usa los mismos valores de comando, argumentos y entorno de la configuración de Claude Desktop anterior.

Solución de Problemas

Requisitos

• Python 3.10+
• Claude Desktop o Cursor
• Una cuenta de Semust con una suscripción activa
• Google Search Console, Google Analytics, Google Ads, Yandex Metrica y/o Bing Webmaster conectados a al menos un proyecto

Licencia

MIT — consulta LICENSE