Projets SEO et passation entre agents

Un dossier de projet conserve le site, le périmètre, la politique de crawl, la couverture de la checklist, les scans, les vues enregistrées et l’historique des exécutions. Chaque étape d’un workflow est enregistrée en point de contrôle, pour qu’un autre agent puisse reprendre le travail.

Ce qu'elle fait

Un dossier de projet

seohead project new crée un dossier local pour un seul site. Il contient project.json, un dossier scans, un dossier reports et un journal lisible, log.md. Les vues enregistrées, un journal d’événements en ajout seul et la checklist apparaissent au fil du travail. Comme il s’agit d’un simple dossier, vous pouvez l’archiver et le restaurer sur une autre machine.

  • Les scans, les scans de concurrents et les rapports restent dans le projet
  • Chaque scan conserve sa propre cible, son build et sa configuration
  • project-archive écrit une seule archive zip avec un manifeste SHA-256 et ignore les fichiers aux noms de type identifiants
  • project-restore ne publie que vers un nouveau chemin, jamais par-dessus un dossier existant

Passation entre agents

Une exécution de workflow enregistre un point de contrôle pour chaque étape enregistrée. Si un agent s’arrête, workflow-status indique l’étape suivante exacte, et workflow-resume rouvre uniquement l’étape interrompue. Chaque écriture porte la révision courante et échoue en cas de conflit : deux agents ne peuvent donc pas s’écraser mutuellement sans que cela se remarque.

  • La boîte de réception conserve les notes du spécialiste et les objectifs proposés
  • Accepter un objectif crée une seule tâche de checklist et ne lance aucun crawl
  • seohead watch --project DIR ouvre un observateur de terminal à côté du chat ; il se contente de lire, sauf pour les notes et objectifs que vous enregistrez

Une tâche n’est pas une preuve

Une tâche terminée n’est pas considérée comme la preuve qu’une erreur du site a été corrigée. La checklist suit le travail convenu. Le registre de remédiation suit les constats, et il ne clôt un cas qu’à partir de preuves de revérification exactes ou d’une mesure ultérieure. Un constat qui disparaît d’un scan partiel n’est pas compté comme corrigé.

  • Les éléments de la checklist affichent : restant, bloqué, obsolète ou en attente de relecture
  • Le seul pourcentage est l’avancement des tâches d’audit, affiché uniquement après un plan explicite
  • Ce pourcentage n’est pas un score de santé du site

Trois étapes, un seul scan enregistré

  1. Créer un dossier de projet

    seohead project new --directory ./shop --target https://example.com/ écrit un dossier local avec le site, les scans, les rapports et un journal que vous pouvez déplacer d’un bloc.

  2. Suivre la checklist convenue

    Les éléments de la checklist indiquent ce qui reste à faire, ce qui est bloqué, obsolète ou en attente de relecture. Une tâche terminée est enregistrée comme tâche, et non comme preuve que l’erreur du site est corrigée.

  3. Transmettre une exécution avec points de contrôle

    Une exécution de workflow valide les étapes dans l’ordre. Un autre agent récupère l’étape suivante avec workflow-status et rouvre l’étape interrompue avec workflow-resume.

Contrôles de cette fonctionnalité

ContrôleSignificationGravitéPreuve
BROKEN_PAGE_4XXLa page renvoie une réponse 4xx ; le projet la garde comme point ouvert jusqu’à ce qu’une revérification la montre corrigéeCriticalCode de statut et URL dans le scan enregistré
REDIRECT_LOOPLa chaîne de redirections n’aboutit jamais à une destination valideCriticalChaîne de redirections dans le scan enregistré
REDIRECT_CHAINDeux redirections ou plus avant l’URL finaleImportantChaîne de redirections dans le scan enregistré
TITLE_MISSINGLa balise title est absenteCriticalLigne de page dans le scan enregistré
CANONICAL_MISSINGUne page indexable n’a pas d’URL canoniqueImportantLigne de page dans le scan enregistré

Une seule commande

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

Commencez par installer : guide d'installation. Chaque commande fonctionne aussi comme outil MCP pour les agents IA.

Ce qu'il vous faut

  • Un chemin de dossier pour le projet et l’URL du site cible
  • Un agent via MCP, ou la CLI. L’application de bureau est facultative
  • Les crawls ou audits que vous lancez explicitement, pour alimenter le projet en preuves
  • Rien d’autre. Aucun compte n’est nécessaire

Limites

  • Les commandes de projet enregistrent un état. Elles ne lancent ni crawl ni agent par elles-mêmes
  • Un workflow n’exécute que les étapes enregistrées, et non du texte libre issu d’une note
  • Les données du projet sont du matériel de travail et peuvent contenir du contenu du site. Ce n’est pas un export public
  • Un concurrent est un site distinct : il exige son propre périmètre autorisé et son propre scan

Questions

Faut-il l’application de bureau pour utiliser les projets ?
Non. Les projets fonctionnent depuis la CLI et le serveur MCP. seohead watch --project DIR ouvre un observateur de terminal facultatif qui affiche la couverture et les constats. Ses seules écritures sont les notes et objectifs proposés que vous enregistrez vous-même.
Un agent lance-t-il les crawls de lui-même ?
Non. Les commandes de projet comme project-inbox-submit, workflow-start et les points de contrôle se contentent d’enregistrer un état. Les crawls ne s’exécutent que par des commandes explicites, comme crawl-site ou project-prepare.
Deux agents peuvent-ils écraser le travail l’un de l’autre ?
Pas en silence. Chaque écriture porte la révision courante (expected_revision) et échoue en cas de conflit : le second auteur doit donc d’abord lire le dernier état.
Un pourcentage d’avancement est-il un score de santé du site ?
Non. Le seul pourcentage est intitulé « Avancement des tâches d’audit » et n’apparaît qu’après un plan explicite. Il ne mesure ni la santé du site ni la remédiation.
Puis-je partager un projet avec un client ou un collègue ?
project-archive écrit une seule archive zip avec un manifeste SHA-256 et ignore les fichiers aux noms de type identifiants. La restauration ne publie que vers un nouveau chemin, jamais par-dessus un dossier existant. Les données du projet sont du matériel de travail, pas un export public : relisez l’archive avant de l’envoyer.
Que se passe-t-il quand un autre agent reprend le travail ?
Il lit le projet enregistré, et non l’ancien chat. workflow-status donne l’étape enregistrée suivante exacte, project-progress fournit une page de checklist compacte avec les actions suivantes, et le journal d’événements montre ce qui s’est passé auparavant.