SEO-проекты и передача работы между агентами

Папка проекта хранит сайт, границы работ, политику сканирования, покрытие чеклиста, сканы, сохранённые виды и историю запусков. Каждый шаг workflow сохраняет контрольную точку, поэтому другой агент может продолжить работу с того же места.

Что делает

Одна папка проекта

seohead project new создаёт локальную папку для одного сайта. В ней лежат project.json, папка scans, папка reports и журнал для человека — log.md. Сохранённые виды, журнал событий только для добавления и чеклист появляются по мере работы. Папка обычная, поэтому её можно заархивировать и восстановить на другой машине.

  • Сканы, сканы конкурентов и отчёты хранятся внутри проекта
  • Каждый скан хранит свой сайт, сборку и конфигурацию
  • project-archive пишет один zip с манифестом SHA-256 и пропускает файлы с именами, похожими на учётные данные
  • project-restore публикует архив только в новый путь и никогда не перезаписывает существующую папку

Передача работы между агентами

Запуск workflow сохраняет контрольную точку для каждого зарегистрированного шага. Если агент остановился, workflow-status показывает точный следующий шаг, а workflow-resume заново открывает только прерванный. Каждая запись принимает текущую ревизию и завершается ошибкой при конфликте, поэтому два агента не перезапишут работу друг друга незаметно.

  • Входящие сохраняют заметки специалиста и предложенные цели
  • Принятие цели создаёт одну задачу в чеклисте и не запускает сканирование
  • seohead watch --project DIR открывает терминальный наблюдатель рядом с чатом. Он только читает, если не считать заметок и целей, которые вы сохраняете сами

Задача — не доказательство

Выполненная задача не считается доказательством, что ошибка сайта исправлена. Чеклист отслеживает согласованную работу. Журнал исправлений отслеживает находки и закрывает случай только по точной повторной проверке или более позднему измеренному наблюдению. Находка, которая пропала из частичного скана, исправленной не считается.

  • Пункты чеклиста показывают: осталось, заблокировано, устарело или ждёт проверки
  • Единственный процент — выполнение задач аудита. Он появляется только после явного плана
  • Этот процент не является оценкой здоровья сайта

Три шага — один сохранённый скан

  1. Создайте папку проекта

    seohead project new --directory ./shop --target https://example.com/ создаёт локальную папку с сайтом, сканами, отчётами и журналом. Её можно переносить целиком.

  2. Ведите согласованный чеклист

    В пунктах чеклиста видно, что осталось, заблокировано, устарело или ждёт проверки. Выполненная задача фиксируется как задача, а не как доказательство, что ошибка сайта исправлена.

  3. Передавайте запуск по контрольным точкам

    Workflow закрывает шаги по порядку. Другой агент получает следующий шаг через workflow-status и заново открывает прерванный через workflow-resume.

Проверки в этой возможности

ПроверкаЧто значитКритичностьДоказательство
BROKEN_PAGE_4XXСтраница отдаёт ответ 4xx. Проект держит её открытым пунктом, пока повторная проверка не покажет исправлениеCriticalКод статуса и URL в сохранённом скане
REDIRECT_LOOPЦепочка редиректов так и не доходит до корректного адресаCriticalЦепочка редиректов в сохранённом скане
REDIRECT_CHAINДва и более редиректа до конечного URLImportantЦепочка редиректов в сохранённом скане
TITLE_MISSINGЭлемент title отсутствуетCriticalСтрока страницы в сохранённом скане
CANONICAL_MISSINGУ индексируемой страницы нет канонического URLImportantСтрока страницы в сохранённом скане

Одна команда

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

Сначала установите: руководство по установке. Каждая команда работает и как MCP-инструмент для ИИ-агентов.

Что нужно

  • Путь к папке проекта и URL целевого сайта
  • Агент через MCP или CLI. Десктопное приложение необязательно
  • Сканирования и аудиты, которые вы запускаете явно, чтобы наполнить проект доказательствами
  • Больше ничего. Аккаунт не нужен

Ограничения

  • Команды проекта только фиксируют состояние. Сами по себе они не запускают сканирование и не включают агента
  • Workflow выполняет только зарегистрированные шаги, а не свободный текст из заметки
  • Данные проекта — рабочие материалы, и в них может быть контент сайта. Это не публичный экспорт
  • Конкурент — отдельный сайт. Для него нужны собственная разрешённая область работ и свой скан

Вопросы

Нужно ли десктопное приложение, чтобы работать с проектами?
Нет. Проекты работают из CLI и MCP-сервера. seohead watch --project DIR открывает необязательный терминальный наблюдатель, который показывает покрытие и находки. Его единственные записи — заметки и предложенные цели, которые вы сохраняете сами.
Агент сам запускает сканирование?
Нет. Команды проекта, например project-inbox-submit, workflow-start и контрольные точки, только фиксируют состояние. Сканирование запускается только явными командами, например crawl-site или project-prepare.
Могут ли два агента перезаписать работу друг друга?
Не незаметно. Каждая запись принимает текущую ревизию (expected_revision) и завершается ошибкой при конфликте, поэтому второй автор должен сначала прочитать последнее состояние.
Процент выполнения — это оценка здоровья сайта?
Нет. Единственный процент подписан как «Выполнение задач аудита» и появляется только после явного плана. Он не измеряет состояние сайта и не показывает, насколько исправлены ошибки.
Можно ли передать проект клиенту или коллеге?
project-archive пишет один zip с манифестом SHA-256 и пропускает файлы с похожими на учётные данные именами. project-restore публикует его только в новый путь и никогда не перезаписывает существующую папку. Данные проекта — рабочие материалы, а не публичный экспорт, поэтому проверьте архив перед отправкой.
Что происходит, когда работу принимает другой агент?
Он читает сохранённый проект, а не старый чат. workflow-status выдаёт точный следующий зарегистрированный шаг, project-progress — компактную страницу чеклиста со следующими действиями, а журнал событий показывает, что было раньше.

Проверьте на своём сайте