Aplicación SEO de escritorio

Una aplicación nativa de escritorio escrita en Python con PyQt5, sobre el mismo núcleo que la CLI y el servidor MCP. Abre los mismos proyectos locales y rastreos guardados, sin vista web y sin cuenta alojada.

Qué hace

Todo en una ventana

La aplicación tiene dos modos. Projects sirve para trabajar con un agente de IA: objetivos, tareas, bandeja de entrada, rastreos, comparación antes y después e informes. Crawler sirve para comprobaciones rápidas: introduces una URL y pulsas el botón Start, sin crear un proyecto. Ambos leen el registro de auditoría, así que una incidencia significa lo mismo que en la CLI.

  • Tabla de URL con filtros, detalle por URL, grafo de enlaces y comparación de rastreos
  • Importación de logs del servidor, manuales de método, generador de redirecciones y editor de tareas de snippets
  • Temas claro, oscuro y de alto contraste
  • Interfaz en inglés y en ruso

Instalación y plataformas

Hoy la aplicación se ejecuta desde el código fuente en cualquier sistema con Python 3.11 o posterior, e incluye el núcleo compatible. Se puede compilar un instalador para macOS: coloca SpiderHead.app en Aplicaciones y un envoltorio del comando seohead en /usr/local/bin. Los paquetes de Windows y Linux están preparados en los scripts de compilación, pero aún no tienen una aceptación en un equipo limpio.

  • Desde el código fuente: instálala en un entorno virtual y ejecuta seohead-desktop
  • macOS: paquete PyInstaller y .pkg, firmado localmente, sin notarizar
  • Windows y Linux: existen los scripts de compilación; el paquete de ejecución aún no está verificado
  • La aplicación nunca recurre a un seohead global de tu equipo

Mismo núcleo, mismos archivos

La aplicación no incluye su propio rastreador. Llama al núcleo a través de los mismos contratos de CLI y MCP local que usan los agentes, así que un rastreo iniciado en la terminal aparece en la aplicación, y al revés. Un agente también puede manejar la ventana, pero solo después de que actives el control local.

  • Los rastreos iniciados desde la aplicación se ejecutan como procesos separados, con una cola
  • El interruptor del servidor MCP en la aplicación se comparte con seohead mcp
  • El control local mediante seohead-desktop-agent está desactivado hasta que lo actives

Tres pasos, un análisis guardado

  1. Abre un proyecto local

    Apunta la aplicación a una carpeta de proyecto. Abre los mismos proyectos locales y rastreos guardados que la CLI.

  2. Rastrea o abre un rastreo guardado

    Lanza un rastreo desde la aplicación o abre uno que ya tengas, y lee los resultados en una sola ventana.

  3. Resuelve las incidencias

    Cada incidencia procede del registro de auditoría. Filtra la tabla de URL, abre una URL y consulta sus detalles.

Comprobaciones de esta función

ComprobaciónQué significaGravedadEvidencia
REDIRECT_LOOPLa cadena de redirecciones vuelve a una URL que ya visitóCriticalRuta de redirecciones
TITLE_MISSINGLa página no tiene elemento titleCriticalURL de la página
REDIRECT_CHAINMás de un salto de redirección antes de la URL finalImportantCada salto con su código de estado
CANONICAL_MISSINGUna página indexable no tiene URL canónicaImportantURL de la página
ORPHAN_PAGENinguna página enlaza internamente a esta páginaImportantURL de la página
HREFLANG_MISSING_RETURN_LINKLa hreflang de otra página apunta aquí, pero esta página no apunta de vueltaImportantURL de la página y conjunto de hreflang

Un solo comando

bash
seohead-desktop --project ./shop

Primero, instala SpiderHead: guía de instalación. Cada comando también funciona como herramienta MCP para agentes de IA.

Qué necesitas

  • Una carpeta de proyecto local existente, abierta en modo de solo lectura, o solo una URL en el modo Crawler
  • Python 3.11 o posterior, para ejecutar desde el código fuente
  • El núcleo compatible, instalado con la aplicación o incluido en el paquete de macOS
  • Para el rastreo nativo no hace falta la CLI de Screaming Frog con licencia

Límites

  • macOS es la única plataforma con una prueba de humo sobre el paquete compilado. La aceptación en tiempo de ejecución de Windows y Linux sigue pendiente
  • Todavía no se publican instaladores preparados. Se compilan desde el repositorio
  • No se afirma el rendimiento de la ventana con un millón de URL, y todavía se comprueban tamaños de ventana muy pequeños
  • La guía de ayuda integrada usa actualmente etiquetas en ruso

Preguntas

¿Necesito la línea de comandos para usarla?
Para instalar desde el código fuente, sí: unos pocos comandos en una terminal. Después, la aplicación se maneja con clics. El paquete de macOS también ofrece un botón «Install command line tool» en el primer inicio, y pide derechos de administrador solo cuando lo pulsas.
¿Hace falta una cuenta o se envían mis datos a un servidor?
No existe una cuenta alojada. Los proyectos y los rastreos se quedan en tu equipo, en el mismo almacenamiento local que usan la CLI y el servidor MCP.
¿La aplicación muestra los mismos resultados que la CLI?
Sí. La aplicación funciona sobre el mismo núcleo y abre los mismos rastreos guardados, así que un rastreo hecho en la terminal aparece en la aplicación.
¿Un rastreo cambia mi sitio?
No. Los rastreos son solicitudes de solo lectura. Las reglas de redirección que se generan son archivos que revisas y despliegas tú mismo.
¿En qué sistemas funciona?
Está escrita con Qt, y la instalación desde el código fuente está pensada para macOS, Windows y Linux. Hasta ahora, solo macOS tiene un paquete compilado que ha superado una prueba de humo. En Linux, Qt puede necesitar bibliotecas de visualización del sistema adicionales.
¿Cuál es la licencia?
La aplicación de escritorio está bajo GPL-3.0-or-later, porque PyQt5 lo exige. El núcleo del kit de herramientas, en el mismo repositorio, es MIT.

Pruébalo en tu propio sitio