screaming-frog-mcp

Servidor MCP que permite a Claude ejecutar rastreos headless de Screaming Frog SEO Spider, exportar datos y gestionar el almacenamiento de rastreos, sin necesidad de abrir la interfaz gráfica.

Escribe una URL en Claude. Screaming Frog se ejecuta en segundo plano. Obtienes los datos de vuelta. Eso es todo.

Bifurcado de bzsasson/screaming-frog-mcp v0.1.0 con correcciones de errores. El original tenía problemas que lo hacían inutilizable en la práctica: bloqueos de tuberías (pipe deadlocks) que colgaban los rastreos, detección falsa de GUI que bloqueaba todo después de la primera ejecución, un comando de eliminación que podía borrar toda tu base de datos de rastreos. Todo solucionado.

Qué se ha corregido

Requisitos

• Screaming Frog SEO Spider con una licencia de pago: los rastreos headless requieren una licencia.

• Python 3.10+

• uv (recomendado) o pip

Instalación

Mac

uvx --from git+https://github.com/marykovziridze/screaming-frog-mcp screaming-frog-mcp

Añadir a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "screaming-frog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/marykovziridze/screaming-frog-mcp", "screaming-frog-mcp"]
    }
  }
}

Windows

Instalar uv primero:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Añadir a C:\Users\[nombre]\AppData\Roaming\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "screaming-frog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/marykovziridze/screaming-frog-mcp", "screaming-frog-mcp"],
      "env": {
        "SF_CLI_PATH": "C:\\Program Files (x86)\\Screaming Frog SEO Spider\\ScreamingFrogSEOSpiderCli.exe"
      }
    }
  }
}

Reinicia Claude Desktop después de editar la configuración.

Herramientas

Configuración

Limitaciones conocidas

• Ruta de rastreo obsoleto en Windows — la limpieza automática funciona en Mac. En Windows, si los rastreos fallan después de una interrupción, busca un archivo crawl.seospider en tu directorio de instalación de SF y bórralo manualmente.

• Sin porcentaje de progreso de rastreo — la CLI headless de SF no informa del progreso a mitad del rastreo. Sabes cuándo empieza y cuándo termina.

• Sitios grandes — probado en sitios de hasta ~160 páginas. No probado bajo estrés en sitios de más de 10.000 páginas.

Licencia

MIT — ver LICENSE

Créditos

Servidor MCP original de Boaz Sasson.