Proyectos SEO y traspaso entre agentes

Un directorio de proyecto guarda el sitio, el alcance, la política de rastreo, la cobertura de la lista de comprobación, los escaneos, las vistas guardadas y el historial de ejecuciones. Las ejecuciones de flujos de trabajo guardan un punto de control en cada paso para que otro agente pueda retomar el trabajo.

Qué hace

Una carpeta por proyecto

seohead project new crea una carpeta local para un sitio. Contiene project.json, una carpeta scans, una carpeta reports y un registro legible para personas, log.md. Las vistas guardadas, un diario de eventos de solo adición y la lista de comprobación aparecen a medida que trabajas. Como es una carpeta normal, puedes archivarla y restaurarla en otro equipo.

  • Los escaneos, los escaneos de competidores y los informes se guardan dentro del proyecto
  • Cada escaneo conserva su propia build y su configuración
  • project-archive escribe un único zip con un manifiesto SHA-256 y omite los archivos cuyo nombre parece de credenciales
  • project-restore publica solo en una ruta nueva, nunca sobre una carpeta existente

Traspaso entre agentes

Una ejecución de flujo de trabajo guarda un punto de control por cada paso registrado. Si un agente se detiene, workflow-status muestra el siguiente paso exacto y workflow-resume reabre solo el que quedó interrumpido. Cada escritura usa la revisión actual y falla si hay conflicto, así que dos agentes no pueden sobrescribirse sin darse cuenta.

  • La bandeja de entrada guarda las notas del especialista y los objetivos propuestos
  • Aceptar un objetivo crea una única tarea en la lista de comprobación y no inicia ningún rastreo
  • seohead watch --project DIR abre un observador en la terminal junto al chat; solo lee, salvo las notas y los objetivos que guardes

Una tarea no es una prueba

Una tarea terminada no se toma como prueba de que se corrigió un error del sitio. La lista de comprobación registra el trabajo acordado. El registro de corrección lleva las incidencias y solo da un caso por resuelto con una nueva comprobación exacta o con una observación medida posterior. Una incidencia que desaparece de un escaneo parcial no se cuenta como corregida.

  • Los elementos de la lista muestran lo pendiente, lo bloqueado, lo desactualizado y lo que espera revisión
  • El único porcentaje es el progreso de las tareas de auditoría, y solo aparece tras un plan explícito
  • Ese porcentaje no es una puntuación de salud del sitio

Tres pasos, un análisis guardado

  1. Crea una carpeta de proyecto

    seohead project new --directory ./shop --target https://example.com/ crea una carpeta local con el sitio, los escaneos, los informes y un registro que puedes mover de una vez.

  2. Haz seguimiento de la lista de comprobación acordada

    Los elementos de la lista muestran qué queda pendiente, qué está bloqueado, qué está desactualizado o qué espera revisión. Una tarea terminada se registra como tarea, no como prueba de que el error del sitio está corregido.

  3. Traspasa una ejecución con puntos de control

    Una ejecución de flujo de trabajo cierra los pasos en orden. Otro agente recupera el siguiente paso con workflow-status y reabre el interrumpido con workflow-resume.

Comprobaciones de esta función

ComprobaciónQué significaGravedadEvidencia
BROKEN_PAGE_4XXLa página devuelve una respuesta 4xx; el proyecto la mantiene como incidencia abierta hasta que una nueva comprobación muestre que está corregidaCriticalCódigo de estado y URL en el escaneo guardado
REDIRECT_LOOPLa cadena de redirecciones nunca llega a un destino válidoCriticalCadena de redirecciones en el escaneo guardado
REDIRECT_CHAINDos o más saltos de redirección antes de la URL finalImportantCadena de redirecciones en el escaneo guardado
TITLE_MISSINGFalta la etiqueta titleCriticalFila de la página en el escaneo guardado
CANONICAL_MISSINGLa página indexable no tiene URL canónicaImportantFila de la página en el escaneo guardado

Un solo comando

bash
seohead project new --directory ./shop --target https://example.com/

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

Qué necesitas

  • Una ruta de carpeta para el proyecto y la URL del sitio objetivo
  • Un agente por MCP, o la CLI. La aplicación de escritorio es opcional
  • Rastreos o auditorías que ejecutes tú de forma explícita, para reunir evidencias en el proyecto
  • Nada más. No necesitas cuenta

Límites

  • Los comandos de proyecto registran el estado. No inician rastreos ni ejecutan un agente por sí solos
  • Un flujo de trabajo ejecuta solo pasos registrados, no texto libre de una nota
  • Los datos del proyecto son material de trabajo y pueden contener contenido del sitio. No es una exportación pública
  • Un competidor es un sitio aparte y necesita su propio alcance autorizado y su propio escaneo

Preguntas

¿Necesito la aplicación de escritorio para usar los proyectos?
No. Los proyectos funcionan desde la CLI y el servidor MCP. seohead watch --project DIR abre un observador opcional en la terminal que muestra la cobertura y las incidencias. Sus únicas escrituras son las notas y los objetivos propuestos que guardes tú.
¿Un agente inicia rastreos por su cuenta?
No. Los comandos de proyecto, como project-inbox-submit, workflow-start y los puntos de control, solo registran el estado. Los rastreos se ejecutan únicamente con comandos explícitos, como crawl-site o project-prepare.
¿Dos agentes pueden sobrescribir el trabajo del otro?
No en silencio. Cada escritura usa la revisión actual (expected_revision) y falla si hay conflicto, así que el segundo que escriba debe leer antes el estado más reciente.
¿El porcentaje de progreso es una puntuación de salud del sitio?
No. El único porcentaje se llama progreso de las tareas de auditoría y aparece solo tras un plan explícito. No mide la salud del sitio ni la corrección de errores.
¿Puedo compartir un proyecto con un cliente o con un compañero?
project-archive escribe un único zip con un manifiesto SHA-256 y omite los archivos cuyo nombre parece de credenciales. Restaurar solo publica en una ruta nueva, nunca sobre una carpeta existente. Los datos del proyecto son material de trabajo, no una exportación pública, así que revisa el archivo antes de enviarlo.
¿Qué pasa cuando toma el relevo otro agente?
Lee el proyecto guardado, no el chat anterior. workflow-status indica el siguiente paso registrado exacto, project-progress ofrece una página compacta de la lista de comprobación con las siguientes acciones, y el diario de eventos muestra lo que pasó antes.

Pruébalo en tu propio sitio