Lista de tareas SEO para desarrolladores

Una auditoría puede generar una lista de tareas priorizada: una tarea por tipo de problema, con prioridad, esfuerzo, URL afectadas, una sugerencia de corrección y filas de reproducción. Los enlaces rotos también muestran la página de origen, la posición del enlace y el XPath.

Qué hace

De P1 a P3

Las tareas se agrupan por prioridad en tasks.md y también se guardan en tasks.json para scripts y agentes. Por defecto, las incidencias críticas pasan a P1 con esfuerzo alto, las advertencias a P2 con esfuerzo medio y los avisos a P3 con esfuerzo bajo. La correspondencia es una regla, no una estimación para cada sitio, y puedes cambiarla.

  • Una tarea por comprobación de forma predeterminada; group_by también admite una tarea por URL o por plantilla declarada
  • Cada tarea incluye una sugerencia de corrección tomada de la comprobación
  • Las URL afectadas tienen un límite por tarea, y la tarea indica cuántas se han dejado fuera
  • Las gravedades, las comprobaciones y el número mínimo de apariciones se pueden filtrar en la configuración

Reproducción y evidencias

Cada tarea incluye filas de reproducción tomadas de la auditoría guardada: la URL, el código de estado y, en el caso de los enlaces, dónde están en la página. Si la auditoría no tiene reproducción, tasks.md lo indica y no inventa ninguna. Las tareas también conservan referencias a las observaciones guardadas de las que proceden, cuando la auditoría las tiene.

  • Enlaces rotos: destino, página de origen, posición del enlace y XPath
  • Las auditorías parciales o con comprobaciones omitidas trasladan esa advertencia a tasks.md
  • Las URL ocultas por reglas de exclusión no aparecen en la lista, y el archivo indica cuántas son

Nueva comprobación

tasks.md es un backlog propuesto, no un plan aprobado. Después de una publicación, no des una tarea por corregida solo porque ya no aparece en la lista. Compruébalo con una nueva comprobación de las URL afectadas, usando las herramientas de corrección o verify-fixes, y compara un escaneo anterior con uno posterior.

  • verify-fixes vuelve a comprobar las incidencias base seleccionadas en un subconjunto explícito de URL
  • remediation-recheck trabaja con casos exactos del registro y escribe las evidencias de verificación
  • Una incidencia que desaparece no es prueba de corrección si el escaneo posterior fue parcial

Tres pasos, un análisis guardado

  1. Ejecuta la auditoría a partir de tus exportaciones

    Indica a la CLI una carpeta con exportaciones CSV o XLSX de Screaming Frog y añade --tasks para obtener el backlog en la misma ejecución.

  2. Obtén las tareas ordenadas de P1 a P3

    Cada tarea tiene una prioridad, una estimación de esfuerzo, las URL afectadas, la corrección y la reproducción. Los enlaces rotos también muestran la página de origen, la posición del enlace y el XPath.

  3. Vuelve a comprobar tras la publicación

    Verifica cada corrección con remediation-recheck y no te fíes de que la tarea haya desaparecido de la lista.

Comprobaciones de esta función

ComprobaciónQué significaGravedadEvidencia
BROKEN_PAGE_4XXLa página devuelve una respuesta 4xxCriticalURL afectada y su código de estado
BROKEN_INTERNAL_LINKUn enlace interno apunta a una URL 4xxCriticalDestino, página de origen, posición del enlace y XPath de cada enlace roto
REDIRECT_LOOPUn ciclo de redirección que nunca llega a un destino válidoCriticalFilas del informe de cadenas de redirección
TITLE_MISSINGLa página no tiene elemento titleCriticalURL afectadas, con límite por tarea
REDIRECT_CHAINDos o más saltos de redirección antes de la URL finalImportantSaltos en el informe de cadenas de redirección
DESC_MISSINGLa página no tiene meta descripciónImportantURL afectadas, con límite por tarea
H1_MISSINGLa página no tiene encabezado H1ImportantURL afectadas, con límite por tarea
BAD_REDIRECT_TYPESe usa un 302, 303 o 307 cuando se espera un traslado permanenteTipURL afectadas, con límite por tarea

Un solo comando

bash
seohead sf run --exports-dir ./exports --out ./report --tasks

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

Qué necesitas

  • Una carpeta con exportaciones CSV o XLSX de Screaming Frog, o un audit.json existente
  • O un escaneo nativo guardado (archivo SQLite scan.v1) de crawl-site
  • Un config.json opcional con un bloque tasks_pipeline
  • Una licencia de la CLI de Screaming Frog solo si quieres que sf run inicie el rastreo

Límites

  • Construye un backlog propuesto a partir de una auditoría. No aprueba, asigna ni despliega trabajo
  • La prioridad y el esfuerzo salen de la gravedad según una regla, no del tamaño de tu sitio ni del equipo
  • Las listas de URL y las filas de reproducción tienen un límite por tarea, así que cada tarea muestra una muestra y un recuento
  • La cobertura depende de la auditoría: una comprobación que no se ejecutó no genera ninguna tarea

Preguntas

¿Necesito una licencia de Screaming Frog?
No para el generador de tareas. Lee exportaciones que ya tienes (CSV o XLSX), un audit.json o un escaneo nativo. Solo sf run con --crawl inicia un rastreo a través de la CLI de Screaming Frog con licencia.
¿Cambia algo en mi sitio?
No. El generador de tareas lee la auditoría y escribe archivos: tasks.json y tasks.md, en la carpeta que indiques con --out. Tú decides qué desplegar.
¿Puedo cambiar las prioridades?
Sí. Pasa un config.json con --config y define priority_map, effort_map, group_by, include_severities, max_urls_per_task y min_occurrences dentro de tasks_pipeline.
¿Qué pasa si una tarea no tiene pasos de reproducción?
tasks.md indica que la reproducción no está disponible en la auditoría guardada. No inventa ninguna.
¿Puedo crear tareas a partir de una auditoría que ya tengo?
Sí. Ejecuta sf tasks con --json apuntando a un audit.json o a un archivo de escaneo nativo. Escribe tasks.json y tasks.md sin rastrear ni enviar peticiones.
¿Puede ejecutarlo un agente de IA?
Sí. Los mismos pasos existen como herramientas MCP: sf_audit_run para la auditoría y sf_audit_tasks para el backlog.

Pruébalo en tu propio sitio