Progetti SEO e passaggio di consegne agli agenti

Una cartella di progetto conserva sito, ambito, policy di scansione, copertura della checklist, scansioni, viste salvate e storico dei run; i run di workflow mettono un checkpoint a ogni passo così un altro agente può riprendere.

Cosa fa

Una cartella di progetto

seohead project new crea una cartella locale per un sito. Contiene project.json, una cartella scans, una cartella reports e un registro leggibile, log.md. Viste salvate, un giornale di eventi in sola aggiunta e la checklist compaiono mentre lavori. Essendo una cartella normale, puoi archiviarla e ripristinarla su un'altra macchina.

  • Scansioni, scansioni dei concorrenti e report restano sotto il progetto
  • Ogni scansione conserva il suo sito, la sua build e la sua configurazione
  • project-archive scrive uno zip con un manifest SHA-256 e salta i nomi di file simili a credenziali
  • project-restore pubblica solo su un percorso nuovo, mai sopra una cartella esistente

Passaggio tra agenti

Un run di workflow salva un checkpoint per ogni passo registrato. Se un agente si ferma, workflow-status mostra il prossimo passo esatto e workflow-resume riapre solo quello interrotto. Ogni scrittura prende la revisione corrente e fallisce su un conflitto, quindi due agenti non si sovrascrivono senza accorgersene.

  • L'inbox conserva le note dello specialista e gli obiettivi proposti
  • Accettare un obiettivo crea un task della checklist e non avvia alcuna scansione
  • seohead watch --project DIR apre un osservatore nel terminale accanto alla chat; legge soltanto, salvo le note e gli obiettivi che salvi tu

Il task non è una prova

Un task completato non è trattato come prova che un errore del sito fosse corretto. La checklist segue il lavoro concordato. Il registro dei rimedi segue le segnalazioni, e risolve un caso solo su evidenza esatta di ricontrollo o su un'osservazione misurata successiva. Una segnalazione che scompare da una scansione parziale non è contata come corretta.

  • Le voci della checklist mostrano rimanente, bloccato, stantio e in attesa di revisione
  • L'unico aumentare percentuale è Audit-task completion, mostrato solo dopo un piano esplicito
  • Quella percentuale non è un punteggio di salute del sito

Tre passaggi, una scansione salvata

  1. Crea una cartella di progetto

    seohead project new --directory ./shop --target https://example.com/ scrive una cartella locale con sito, scansioni, report e un registro che puoi spostare intero.

  2. Segui la checklist concordata

    Le voci della checklist mostrano cosa resta, cosa è bloccato, stantio o in attesa di revisione. Un task finito è registrato come task, non come prova che l'errore del sito è corretto.

  3. Passa un run con checkpoint

    Un run di workflow chiude i passi in ordine. Un altro agente recupera il prossimo passo con workflow-status e riapre quello interrotto con workflow-resume.

Controlli di questa funzionalità

ControlloCosa significaGravitàEvidenza
BROKEN_PAGE_4XXLa pagina restituisce una risposta 4xx; il progetto la tiene come voce aperta finché un ricontrollo non la mostra correttaCriticalCodice di stato e URL nella scansione salvata
REDIRECT_LOOPLa catena di redirect non raggiunge mai una destinazione validaCriticalCatena di redirect nella scansione salvata
REDIRECT_CHAINDue o più hop di redirect prima della URL finaleImportantCatena di redirect nella scansione salvata
TITLE_MISSINGManca l'elemento titleCriticalRiga della pagina nella scansione salvata
CANONICAL_MISSINGLa pagina indicizzabile non ha URL canonicalImportantRiga della pagina nella scansione salvata

Un solo comando

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

Prima installa SpiderHead: guida all'installazione. Ogni comando funziona anche come strumento MCP per agenti AI.

Cosa ti serve

  • Un percorso di cartella per il progetto e la URL del sito di destinazione
  • Un agente via MCP, oppure il CLI. L'app desktop è facoltativa
  • Scansioni o audit che esegui esplicitamente, per riempire il progetto di evidenze
  • Nient'altro. Non serve alcun account

Limiti

  • I comandi di progetto registrano stato. Non avviano scansioni né eseguono un agente da soli
  • Un workflow esegue solo passi registrati, non testo libero da una nota
  • I dati di progetto sono materiale di lavoro e possono contenere contenuti del sito. Non sono un export pubblico
  • Un concorrente è un sito separato e richiede il suo ambito autorizzato e la sua scansione

Domande

Serve l'app desktop per usare i progetti?
No. I progetti funzionano dal CLI e dal server MCP. seohead watch --project DIR apre un osservatore facoltativo nel terminale che mostra copertura e segnalazioni. Le sue uniche scritture sono note e obiettivi proposti che salvi tu.
Un agente avvia scansioni da solo?
No. I comandi di progetto come project-inbox-submit, workflow-start e i checkpoint registrano solo stato. Le scansioni girano solo tramite comandi espliciti come crawl-site o project-prepare.
Due agenti possono sovrascriversi il lavoro a vicenda?
Non in silenzio. Ogni scrittura prende la revisione corrente (expected_revision) e fallisce su un conflitto, quindi il secondo che scrive deve prima leggere lo stato più recente.
Una percentuale di avanzamento è un punteggio di salute del sito?
No. L'unica percentuale è etichettata Audit-task completion, e compare solo dopo un piano esplicito. Non misura la salute del sito né i rimedi.
Posso condividere un progetto con un cliente o un collega?
project-archive scrive uno zip con un manifest SHA-256 e salta i nomi di file simili a credenziali. Il ripristino pubblica solo su un percorso nuovo, mai sopra una cartella esistente. I dati di progetto sono materiale di lavoro, non un export pubblico, quindi rivedi l'archivio prima di inviarlo.
Cosa succede quando subentra un agente diverso?
Legge il progetto salvato, non la vecchia chat. workflow-status dà il prossimo passo registrato esatto, project-progress dà una pagina compatta della checklist con le prossime azioni, e il giornale degli eventi mostra cosa è successo prima.