SEO-Projekte und Übergabe an Agenten

Ein Projektordner hält Website, Umfang, Crawl-Regeln, Abdeckung der Checkliste, Scans, gespeicherte Ansichten und den Lauf-Verlauf zusammen. Workflow-Läufe sichern jeden Schritt als Checkpoint, damit ein anderer Agent dort weitermachen kann.

Was es leistet

Ein Projektordner

seohead project new legt einen lokalen Ordner für eine Website an. Er enthält project.json, einen Ordner scans, einen Ordner reports und ein lesbares Protokoll log.md. Gespeicherte Ansichten, ein nur anhängbares Ereignisjournal und die Checkliste entstehen während der Arbeit. Da es ein einfacher Ordner ist, können Sie ihn archivieren und auf einem anderen Rechner wiederherstellen.

  • Scans, Wettbewerber-Scans und Berichte bleiben im Projekt
  • Jeder Scan speichert seine eigene Website, seinen Build und seine Konfiguration
  • project-archive schreibt ein ZIP mit SHA-256-Manifest und überspringt Dateinamen, die nach Zugangsdaten aussehen
  • project-restore schreibt nur in einen neuen Pfad und überschreibt nie einen bestehenden Ordner

Übergabe zwischen Agenten

Ein Workflow-Lauf speichert einen Checkpoint für jeden registrierten Schritt. Bricht ein Agent ab, zeigt workflow-status den genauen nächsten Schritt, und workflow-resume öffnet nur den unterbrochenen Schritt erneut. Jeder Schreibvorgang übernimmt die aktuelle Revision und scheitert bei einem Konflikt. So können sich zwei Agenten nicht unbemerkt gegenseitig überschreiben.

  • Der Posteingang (inbox) speichert die Notizen des Spezialisten und vorgeschlagene Ziele
  • Ein angenommenes Ziel legt genau eine Checklisten-Aufgabe an und startet keinen Crawl
  • seohead watch --project DIR öffnet neben dem Chat eine Terminal-Beobachtung. Sie liest nur, ausgenommen sind Notizen und Ziele, die Sie selbst speichern

Eine Aufgabe ist kein Beleg

Eine erledigte Aufgabe gilt nicht als Nachweis, dass ein Website-Fehler behoben ist. Die Checkliste verfolgt vereinbarte Arbeit. Das Remediation-Ledger verfolgt Befunde und schließt einen Fall nur auf Grundlage exakter Nachprüfungs-Belege oder einer späteren gemessenen Beobachtung ab. Ein Befund, der aus einem unvollständigen Scan verschwindet, zählt nicht als behoben.

  • Checklisten-Punkte zeigen offen, blockiert, veraltet und wartet auf Prüfung
  • Der einzige Prozentwert ist der Abschluss der Audit-Aufgaben. Er erscheint erst nach einem ausdrücklichen Plan
  • Dieser Prozentwert ist kein Score für den Zustand der Website

Drei Schritte, ein gespeicherter Scan

  1. Einen Projektordner anlegen

    seohead project new --directory ./shop --target https://example.com/ legt einen lokalen Ordner mit Website, Scans, Berichten und einem Protokoll an, den Sie als Ganzes verschieben können.

  2. Die vereinbarte Checkliste verfolgen

    Checklisten-Punkte zeigen, was offen, blockiert, veraltet oder auf Prüfung wartet. Eine erledigte Aufgabe wird als Aufgabe vermerkt, nicht als Nachweis, dass der Website-Fehler behoben ist.

  3. Einen Lauf mit Checkpoints übergeben

    Ein Workflow-Lauf schließt Schritte der Reihe nach ab. Ein anderer Agent ermittelt den nächsten Schritt mit workflow-status und öffnet den unterbrochenen mit workflow-resume erneut.

Prüfungen in dieser Funktion

PrüfungBedeutungSchweregradBeleg
BROKEN_PAGE_4XXDie Seite liefert eine 4xx-Antwort. Das Projekt führt sie als offenen Punkt, bis eine Nachprüfung die Behebung bestätigtCriticalStatuscode und URL im gespeicherten Scan
REDIRECT_LOOPDie Weiterleitungskette erreicht nie ein gültiges ZielCriticalWeiterleitungskette im gespeicherten Scan
REDIRECT_CHAINZwei oder mehr Weiterleitungssprünge vor der finalen URLImportantWeiterleitungskette im gespeicherten Scan
TITLE_MISSINGDas Title-Element fehltCriticalSeitenzeile im gespeicherten Scan
CANONICAL_MISSINGEine indexierbare Seite hat keine kanonische URLImportantSeitenzeile im gespeicherten Scan

Ein Befehl

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

Zuerst installieren: Installationsanleitung. Jeder Befehl läuft auch als MCP-Tool für KI-Agenten.

Was Sie brauchen

  • Ein Ordnerpfad für das Projekt und die URL der Zielwebsite
  • Ein Agent über MCP oder die CLI. Die Desktop-App ist optional
  • Crawls oder Audits, die Sie bewusst starten, um das Projekt mit Belegen zu füllen
  • Sonst nichts. Ein Konto ist nicht nötig

Grenzen

  • Projektbefehle halten nur den Zustand fest. Sie starten selbst keine Crawls und lassen keinen Agenten laufen
  • Ein Workflow führt nur registrierte Schritte aus, keinen freien Text aus einer Notiz
  • Projektdaten sind Arbeitsmaterial und können Website-Inhalte enthalten. Sie sind kein öffentlicher Export
  • Ein Wettbewerber ist eine eigene Website und braucht einen eigenen autorisierten Umfang und einen eigenen Scan

Fragen

Brauche ich die Desktop-App, um Projekte zu nutzen?
Nein. Projekte funktionieren über die CLI und den MCP-Server. seohead watch --project DIR öffnet eine optionale Terminal-Beobachtung, die Abdeckung und Befunde zeigt. Sie schreibt nur Notizen und vorgeschlagene Ziele, die Sie selbst speichern.
Startet ein Agent Crawls von selbst?
Nein. Projektbefehle wie project-inbox-submit, workflow-start und Checkpoints halten nur den Zustand fest. Crawls laufen nur über ausdrückliche Befehle wie crawl-site oder project-prepare.
Können sich zwei Agenten gegenseitig die Arbeit überschreiben?
Nicht unbemerkt. Jeder Schreibvorgang übernimmt die aktuelle Revision (expected_revision) und scheitert bei einem Konflikt. Der zweite Schreibende muss deshalb zuerst den neuesten Stand lesen.
Ist ein Fortschrittsprozentwert ein Gesundheitsscore der Website?
Nein. Der einzige Prozentwert heißt Abschluss der Audit-Aufgaben und erscheint erst nach einem ausdrücklichen Plan. Er misst weder den Zustand der Website noch die Behebung von Fehlern.
Kann ich ein Projekt mit einem Kunden oder Teammitglied teilen?
project-archive schreibt ein ZIP mit SHA-256-Manifest und überspringt Dateinamen, die nach Zugangsdaten aussehen. project-restore schreibt nur in einen neuen Pfad und nie in einen bestehenden Ordner. Projektdaten sind Arbeitsmaterial, kein öffentlicher Export. Prüfen Sie das Archiv deshalb, bevor Sie es versenden.
Was passiert, wenn ein anderer Agent übernimmt?
Er liest das gespeicherte Projekt, nicht den alten Chat. workflow-status nennt den genauen nächsten registrierten Schritt, project-progress liefert eine kompakte Checklisten-Seite mit den nächsten Aktionen, und das Ereignisjournal zeigt, was vorher passiert ist.

Testen Sie es auf Ihrer eigenen Website