Conectar Semrush y Screaming Frog a Cursor con MCP

Semrush y Screaming Frog son de las primeras integraciones que merecen la pena si ya pagas por ellas: keywords, backlinks y auditorías técnicas sin exportar CSV a mano. Esta guía asume que ya sabes cómo conectar MCP a Cursor; aquí vamos al detalle de cada herramienta de pago.

Panorama: dos modelos distintos

Semrush consume unidades API como cualquier llamada a su API. Screaming Frog no consume unidades Semrush, pero sí tu licencia y recursos locales (RAM, disco) al crawlear.

Parte 1: Semrush MCP en Cursor

Requisitos de cuenta

Según la documentación oficial de Semrush MCP, necesitas un plan con acceso a API:

• SEO One Starter / Pro+ o SEO Classic Pro / Guru (con unidades API incluidas), o
• Business / Advanced con paquete de unidades, o
• Trends API Basic / Premium para datos de mercado.

Comprueba unidades disponibles en Mi perfil → Información de suscripción → Resumen.

Configuración en mcp.json

Endpoint actual (HTTP):

{
 "mcpServers": {
 "semrush": {
 "url": "https://mcp.semrush.com/v2/mcp"
 }
 }
}

Guárdalo en ~/.cursor/mcp.json o .cursor/mcp.json. Reinicia Cursor.

Autenticación OAuth (recomendada)

1. Abre Settings → Tools & MCP.
2. Localiza semrush y completa el flujo OAuth en el navegador.
3. Aprueba permisos en Semrush.

No hace falta pegar clave en el JSON si OAuth funciona.

Alternativa: API key

Si tu entorno no soporta OAuth:

{
 "mcpServers": {
 "semrush": {
 "url": "https://mcp.semrush.com/v2/mcp", "headers": {
 "Authorization": "Apikey TU_API_KEY_DE_SEMRUSH"
 }
 }
 }
}

Sustituye TU_API_KEY_DE_SEMRUSH por la clave de Mi perfil → API. No subas este archivo a GitHub con la clave dentro.

Qué puedes preguntar (ejemplos reales)

Usando Semrush: dame el resumen de dominio de ejemplo.com en España,
top 10 keywords orgánicas y 5 competidores por solapamiento.

Compara el tráfico orgánico estimado de dominio-a.com y dominio-b.com
en los últimos 6 meses. Resume en tabla.

El agente usará herramientas como domain_overview, organic_research, execute_report. Si falta alguna, revisa que OAuth terminó bien y que tienes unidades API.

Consumo de unidades

Cada informe tiene coste en unidades. Antes de automatizar informes diarios, mira el consumo por endpoint y pon límites en tus prompts («solo un dominio», «máximo 100 filas»).

Parte 2: Screaming Frog MCP en Cursor

Requisitos

• Screaming Frog SEO Spider v24.0 o superior
• Licencia activa (no basta la versión gratuita de 500 URLs para un crawl grande, según tu plan)
• Spider abierto en tu máquina con MCP habilitado

Activar MCP en Screaming Frog

1. Actualiza a v24+.
2. En el Spider: Configuration → MCP Server (o equivalente en tu versión) → activar.
3. Comprueba el endpoint local, normalmente:

http://127.0.0.1:11435/mcp

Configuración en Cursor

Usa una clave corta (sf), los nombres largos pueden truncar herramientas en el agente:

{
 "mcpServers": {
 "sf": {
 "url": "http://127.0.0.1:11435/mcp"
 }
 }
}

Reinicia Cursor con el Spider ya abierto y MCP activo.

Verificación rápida

En terminal:

curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:11435/mcp

Si no devuelve algo distinto de error de conexión, el servidor no está escuchando, revisa SF.

En el chat:

Con el MCP de Screaming Frog: ¿hay un crawl en curso?
Si no, inicia uno a https://www.ejemplo.com con límite 500 URLs y dime el progreso.

Integraciones útiles antes del crawl

En Configuration → API Access del Spider puedes conectar:

• Google Search Console y GA4 (datos en pestañas Analytics / Search Console del crawl)
• PageSpeed Insights (informes de rendimiento por URL)

Esos datos luego se exportan vía MCP con herramientas como sf_export_seo_element_urls. La conexión GSC/GA4 en SF no se reconecta sola entre sesiones: si el informe sale vacío, vuelve a vincular APIs en el Spider.

Limitación que debes conocer

Mientras el Spider procesa integraciones (PageSpeed, OpenAI, etc.), las exportaciones MCP pueden responder busy. No es un bug de Cursor: espera a que termine la cola en SF.

Prompts que funcionan en auditoría

Exporta un resumen de URLs con status 4xx y 5xx del último crawl.
Ordénalas por inlinks descendente y sugiere prioridad de arreglo.

Lista URLs indexables que en GSC aparecen como "Crawled - currently not indexed"
según los datos del crawl actual.

Exporta oportunidades de PageSpeed del crawl y agrupa por tipo
(render-blocking, imágenes, terceros).

Combinar Semrush + Screaming Frog en el mismo Cursor

Puedes tener ambos en un solo mcp.json:

{
 "mcpServers": {
 "semrush": {
 "url": "https://mcp.semrush.com/v2/mcp"
 }, "sf": {
 "url": "http://127.0.0.1:11435/mcp"
 }
 }
}

Flujo de trabajo que uso:

1. SF: mapa técnico del sitio (status, canonicals, indexación).
2. Semrush: contexto de mercado (keywords, competencia, backlinks).
3. Cruzo en el agente: «estas URLs con error 404 son las que Semrush marca como con tráfico histórico».

Es el mismo reparto que muchos equipos de agencia de SEO aplican en auditorías: crawl técnico local, contexto de mercado en la nube y el agente en medio sin hojas de cálculo intermedias.

Para datos de Google sin pasar por SF, mejor el stack directo en GSC, GA4 y PageSpeed en Cursor.

Checklist final

• Semrush: plan con API y unidades suficientes
• Semrush: OAuth completado o API key en headers
• SF: v24+, licencia, MCP activo, Spider abierto
• mcp.json válido (comas entre servidores)
• Cursor reiniciado; Tools & MCP en verde
• Prueba con un prompt acotado antes de crawls enormes

La primera configuración lleva su tiempo. La segunda vez es copiar JSON, abrir SF y preguntar. Eso es lo que compensa.