CMS-интеграция, GEO Scout и откат — полное руководство

Где это находится

Всё управление интеграцией — внутри проекта пользователя: Проекты → ваш проект → SEO → вкладка «CMS». Админ-панель не требуется — интеграция настраивается владельцем проекта. Администраторы видят результат через задачи агентов и журнал изменений.

GEO Scout — разведка перед интеграцией

GEO Scout сканирует публичные страницы сайта до любого подключения и выдаёт Integration Report. Сканирование полностью безопасно: читается только публичный HTML, никаких изменений на сайте не происходит.

1. 1. Откройте вкладку «CMS» и найдите блок «GEO Scout — разведка перед интеграцией».
2. 2. Введите домен сайта (по умолчанию подставляется домен проекта) и нажмите «Сканировать сайт».
3. 3. Через несколько секунд появится отчёт — он сохраняется в проекте и доступен повторно.

Что показывает отчёт:

• CMS — распознанная платформа (WordPress, 1C-Bitrix, Joomla, OpenCart, MODX, Tilda, Wix, Shopify, Webflow или «самописный») с уровнем уверенности.
• SEO-модули — найденные плагины (Yoast, RankMath, AIOSEO, SEOPress) или пометка «штатные поля/шаблон».
• JSON-LD — количество блоков Schema.org, все найденные @type и дубли типов (главный источник конфликтов).
• Заполненность мета-полей — процент страниц, где уже заполнены title, description, canonical, OG, Twitter.
• Конфликты и риски — дубли схем, плагины, которые регенерируют мета, закрытые платформы.
• Рекомендация — какой коннектор подходит и какую seo_policy выбрать.

Способы подключения

Политика метаданных (seo_policy)

Если на сайте уже есть SEO-модуль или вшитые мета — политика решает, кто выигрывает при конфликте.

Снапшоты — защита перед первой записью

При первой публикации на каждую страницу GEO Engine снимает её живое состояние мета (title, description, canonical, OG, JSON-LD) и сохраняет в журнал изменений как «pre-integration snapshot». Снапшот снимается один раз и никогда не перезаписывается — это эталон «до GEO Engine», к которому откатывает off-boarding.

Откат интеграции (off-boarding)

Кнопка «Откатить интеграцию» в блоке GEO Scout возвращает сайт к состоянию до подключения GEO Engine.

1. Сначала показывается dry-run превью: сколько агентов получат задачу отката и сколько снапшотов будет восстановлено, со списком страниц.
2. При подтверждении агентам CMS отправляется задача seo_rollback — агент проигрывает свою историю изменений от новых к старым, восстанавливая оригинальные значения, и снимает runtime-override.
3. Для bridge-проектов снапшоты пушатся обратно через коннектор, затем страницы перезапрашиваются — верификация сравнивает живые мета со снапшотом.
4. Проект помечается seo_managed=false, политика переводится в track — тихих перезаписей больше не будет.
5. Откат идемпотентен: повторный запуск продолжает с места остановки, уже восстановленные страницы пропускаются.

Для администратора

• Аудит изменений — таблица cms_change_logs: каждая запись хранит before_state/after_state, diff и статус (applied / rolled_back / failed).
• Задачи агентов — таблица cms_tasks: seo_rollback виден рядом с обычными задачами, результат агента пишется в task.result.
• Статус отката — project.settings.offboarding: status (running / agent_pending / partial / completed), agent_results, verification.
• API: POST /api/v1/scout/scan, GET /api/v1/scout/report, POST /api/v1/projects/{id}/offboard?dry_run=true.
• Если статус partial — bridge_failed в деталях покажет страницы, которые не восстановились; повторный вызов endpoint'а продолжит с них.

Частые вопросы