Projetos de SEO e transferência entre agentes

Uma pasta de projeto guarda o site, o escopo, a política de rastreamento, a cobertura do checklist, os scans, as visões salvas e o histórico de execuções. Cada etapa de um workflow gera um checkpoint, e outro agente pode retomar a partir dele.

O que faz

Uma pasta por projeto

O seohead project new cria uma pasta local para um site. Ela contém o project.json, uma pasta scans, uma pasta reports e um log legível para humanos, o log.md. Visões salvas, um diário de eventos somente de acréscimo e o checklist aparecem conforme você trabalha. Como é uma pasta comum, você pode arquivá-la e restaurá-la em outra máquina.

  • Scans, scans de concorrentes e relatórios ficam dentro do projeto
  • Cada scan guarda o próprio site, a build e a configuração
  • O project-archive grava um zip com manifesto SHA-256 e ignora nomes de arquivo com cara de credencial
  • O project-restore publica somente em um caminho novo, nunca por cima de uma pasta existente

Transferência entre agentes

Uma execução de workflow salva um checkpoint para cada etapa registrada. Se um agente parar, o workflow-status mostra a próxima etapa exata, e o workflow-resume reabre somente a etapa interrompida. Toda gravação informa a revisão atual e falha em caso de conflito, então dois agentes não sobrescrevem um ao outro sem perceber.

  • A caixa de entrada guarda as anotações do especialista e as metas propostas
  • Aceitar uma meta cria uma única tarefa no checklist e não inicia nenhum rastreamento
  • O seohead watch --project DIR abre um observador no terminal ao lado do chat; ele apenas lê, exceto as anotações e metas que você salvar

Tarefa concluída não é prova

Uma tarefa concluída não é tomada como prova de que um erro do site foi corrigido. O checklist acompanha o trabalho combinado. O registro de correções acompanha os problemas encontrados e só dá um caso por resolvido com base em evidência exata de nova verificação ou em uma medição posterior. Um problema que some de um scan parcial não é contado como corrigido.

  • Os itens do checklist mostram pendentes, bloqueados, desatualizados e aguardando revisão
  • O único percentual é o de conclusão de tarefas da auditoria, exibido somente após um plano explícito
  • Esse percentual não é uma nota de saúde do site

Três passos, um rastreamento salvo

  1. Crie uma pasta de projeto

    O seohead project new --directory ./shop --target https://example.com/ cria uma pasta local com o site, os scans, os relatórios e um log, que você pode mover inteira.

  2. Acompanhe o checklist combinado

    Os itens do checklist mostram o que resta fazer, o que está bloqueado, o que está desatualizado ou aguardando revisão. Uma tarefa concluída fica registrada como tarefa, não como prova de que o erro do site foi corrigido.

  3. Transfira uma execução com checkpoints

    Uma execução de workflow fecha as etapas em ordem. Outro agente recupera a próxima etapa com o workflow-status e reabre a interrompida com o workflow-resume.

Verificações deste recurso

VerificaçãoO que significaGravidadeEvidência
BROKEN_PAGE_4XXA página retorna uma resposta 4xx; o projeto a mantém como item aberto até que uma nova verificação mostre que foi corrigidaCriticalCódigo de status e URL no scan salvo
REDIRECT_LOOPA cadeia de redirecionamentos nunca chega a um destino válidoCriticalCadeia de redirecionamentos no scan salvo
REDIRECT_CHAINDois ou mais saltos de redirecionamento antes da URL finalImportantCadeia de redirecionamentos no scan salvo
TITLE_MISSINGA tag title está ausenteCriticalLinha da página no scan salvo
CANONICAL_MISSINGA página indexável não tem URL canônicaImportantLinha da página no scan salvo

Um comando

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

Instale primeiro: guia de instalação. Todo comando também funciona como ferramenta MCP para agentes de IA.

O que você precisa

  • Um caminho de pasta para o projeto e a URL do site-alvo
  • Um agente via MCP ou a CLI. O app para desktop é opcional
  • Rastreamentos ou auditorias que você executa explicitamente, para preencher o projeto com evidências
  • Mais nada. Não é preciso criar conta

Limites

  • Os comandos de projeto registram estado. Eles não iniciam rastreamentos nem executam um agente por conta própria
  • Um workflow executa apenas etapas registradas, não texto livre de uma anotação
  • Os dados do projeto são material de trabalho e podem conter conteúdo do site. Não são uma exportação pública
  • Um concorrente é um site separado e precisa de escopo autorizado e scan próprio

Perguntas

Preciso do app para desktop para usar os projetos?
Não. Os projetos funcionam pela CLI e pelo servidor MCP. O seohead watch --project DIR abre um observador opcional no terminal, que mostra a cobertura e os problemas encontrados. Suas únicas gravações são as anotações e as metas propostas que você mesmo salvar.
Um agente inicia rastreamentos por conta própria?
Não. Comandos de projeto como project-inbox-submit, workflow-start e os checkpoints apenas registram estado. Os rastreamentos rodam somente por comandos explícitos, como crawl-site ou project-prepare.
Dois agentes podem sobrescrever o trabalho um do outro?
Não sem aviso. Toda gravação informa a revisão atual (expected_revision) e falha em caso de conflito, então o segundo a gravar precisa ler primeiro o estado mais recente.
Um percentual de andamento é uma nota de saúde do site?
Não. O único percentual é rotulado como Conclusão de tarefas da auditoria e aparece somente depois de um plano explícito. Ele não mede a saúde do site nem as correções.
Posso compartilhar um projeto com um cliente ou colega?
O project-archive grava um zip com manifesto SHA-256 e ignora nomes de arquivo com cara de credencial. A restauração publica somente em um caminho novo, nunca por cima de uma pasta existente. Os dados do projeto são material de trabalho, não uma exportação pública, então revise o arquivo antes de enviar.
O que acontece quando outro agente assume o trabalho?
Ele lê o projeto salvo, não o chat antigo. O workflow-status informa a próxima etapa registrada exata, o project-progress dá uma página compacta do checklist com as próximas ações, e o diário de eventos mostra o que aconteceu antes.

Teste no seu próprio site