SEO-редакция

01

Проблема и цели

Проблема. У продуктов «По душе» (события) и «По любви» (знакомства) нет канала бесплатного стабильного притока пользователей из поиска: нет блога, публичные страницы не оптимизированы, а команда не обладает SEO-экспертизой, чтобы писать находимые статьи вручную. Платный трафик дорожает; органический поиск — единственный канал, который со временем дешевеет.

Решение. Инструмент внутри своей админки, который берёт SEO-экспертизу на себя: менеджер сосредоточен на смысле, система — на находимости, а ИИ ускоряет производство при обязательном человеческом контроле.

Метрики успеха

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

02

Допущения

• Д-1. Масштаб. Точный масштаб команда не определила («неизвестно»). Спецификация рассчитана на 1–5 авторов и до ~30 статей/месяц; всё спроектированное выдерживает рост до сотен статей в год без переделки. Если план окажется > 40 статей/мес — пересмотреть защиту от ИИ-конвейера (§26, риск R-1) до запуска.
• Д-2. Домен нужен только для го-лайва — открытия блога поисковикам и регистрации в кабинетах. Разработка и приёмка всех функций идут на закрытом стенде параллельно покупке домена; блокируется доменом только последний шаг «открыть индексацию».
• Д-3. Оплата OpenRouter решаема командой; при недоступности ИИ редактор полноценно работает без него (§22, E-1).
• Д-4. Контент — только русский; аудитория — Россия.
• Д-5. Юридическая возможность собирать согласия для витринных анкет существует; до подтверждения лента анкет не строится (приоритет COULD).

03

Персоны

04

Сценарии использования

S1 — статья с ИИ, от идеи до публикации (главный путь)

1. Марина открывает SEO → Статьи → «Новая статья», выбирает продукт «События».
2. В подборе запросов вводит «куда сходить в москве» — видит частотности и сезонность, отмечает главный запрос и 4 дополнительных.
3. Жмёт «Попросить ИИ»: получает план (H1, разделы, где CTA и лента), правит два раздела, жмёт «Написать».
4. Через минуту черновик в редакторе с плашкой «Черновик от ИИ — вычитайте». Балл 64: чек-лист просит сократить title, добавить внутренние ссылки и alt к картинкам.
5. Марина вычитывает, правит факты, вставляет блок «Лента» (Москва, 14 дней, 6 карточек), принимает у ИИ два предложения по title. Балл 84. Жмёт «Вычитано», затем «Опубликовать».
6. Статья открывается на домене «По душе» по адресу /blog/kuda-shodit-v-moskve; Яндекс получает IndexNow-пинг. Общее время: ~1,5 часа вместо дня.

S2 — статья без ИИ

Как S1, но текст Марина пишет сама с нуля; ИИ-панель свёрнута. Все подсказки, балл и публикация работают одинаково — ИИ строго опционален (плашки «вычитайте» нет).

S3 — доработка по аналитике

Через месяц во вкладке «Аналитика» у статьи подсказка: «запрос "куда сходить в москве бесплатно" — позиция 11, близко к топу». Марина открывает статью из карточки аналитики, добавляет раздел про бесплатные события, жмёт «Опубликовать изменения» — дата обновления меняется, поисковики видят свежесть. Через две недели по графику видно рост кликов после отметки публикации.

S4 — авария и откат

Стажёр случайно удалил половину опубликованной статьи и опубликовал. Марина открывает «⋯ → Версии», сравнивает с предыдущей, жмёт «Восстановить» и публикует. В аудит-логе видно, кто и что сделал. Потерь нет.

S5 — конфликт: двое в одной статье

Пока Марина редактирует, Олег открывает ту же статью — видит плашку «Сейчас редактирует Марина» и режим «только чтение». Ему нужно срочно: жмёт «Всё равно редактировать» — блокировка переходит к нему, у Марины появляется предупреждение «Редактирование перехватил Олег — ваши несохранённые правки: скопировать». Никто молча не потерял работу. (Механика — EC-9, §22.)

05

Решения (история двух грилей)

06

Домены и архитектура

Принцип: один движок — много доменов. Блог — одно приложение с серверным рендером, развёрнутое на обоих доменах; настройка SITE_PRODUCT решает, чьи статьи домен отдаёт. Смена/добавление домена — конфигурация, не разработка. На каждый домен — свой комплект внешних привязок: счётчик Метрики, сайт в Вебмастере, ресурс GSC, sitemap, robots.txt, ключ IndexNow. Менеджер этого не видит: он выбирает продукт статьи, остальное система делает по нужному домену.

Серверный рендер обязателен (Яндекс рендерит JavaScript нестабильно). Кеш страниц 5–10 минут; после публикации кеш конкретной страницы сбрасывается принудительно.

07

Состав раздела и реестр требований

Реестр верхнеуровневых требований. Каждое — атомарное и проверяемое; детали — в указанном разделе. Приоритеты SHOULD/COULD подтверждаются владельцем (вопрос O-5).

08

Модель данных

Статья (Article)

Остальные сущности

09 · LS

Список статей

Таблица в стандартном стиле админки (панель, sticky-шапка, пагинация по 20).

Фильтры: статус, продукт, автор, рубрика, «нужна вычитка», поиск по названию/slug. Действия строки: в редактор · в аналитику · открыть на сайте · дублировать (копия-черновик) · снять с публикации. Удаление — только черновиков, с подтверждением; опубликованные не удаляются — снимаются (история и метрики сохраняются). Состояния экрана: пусто — крупные «Начать с нуля / Попросить ИИ»; загрузка — скелетон; ошибка — тост + «Повторить» без падения оболочки.

10 · ED

Редактор

Шапка: статус · индикатор сохранения · «Предпросмотр» (страница как на сайте, в новой вкладке, с noindex) · «Опубликовать» / «Опубликовать изменения» · меню «⋯»: версии, запланировать, снять с публикации, дублировать. Плашка мягкой блокировки — если статью уже редактируют (S5, EC-9).

Типы блоков (ED-2)

Вставка из Word/Google Docs очищается до поддерживаемых блоков. «Содержание» генерируется автоматически из H2 при их числе ≥ 3.

11 · MT

Метаданные: title, description и остальное

Заголовок для выдачи (seo_title → <title>) — MT-1

• Длина: цель ≤ 60 знаков (~580 px). Обрезка в выдаче — по пикселям, поэтому поле показывает живой предпросмотр сниппета (desktop и mobile) и пиксельный индикатор: зелёный ≤ 580 px, жёлтый ≤ 700 px («обрежется, не штраф»), красный дальше.
• Главный запрос — в первых 3–4 словах (Google переписывает ~76% title; суть обязана быть в начале).
• Шаблон: «<суть с ключом> — <бренд>»; бренд подставляется по продукту, переключатель «без бренда». Одно тире, без CAPS/эмодзи/перечней через «|».
• Не дубль H1: рекомендация — title «кликабельный для выдачи» (год, город, число: «15 идей…»), H1 — естественный заголовок.
• Автогенерация: «Предложить» — 5 вариантов от ИИ по H1, лиду и запросу. Пустой title при публикации → H1 + бренд.

Описание (seo_description → meta description)

• Длина: 150–160 знаков (~920 px desktop / 680 px mobile), тот же индикатор; < 120 — предупреждение «выдача может подставить случайный кусок».
• Структура: 1–3 предложения; первое — конкретная польза; активный залог; мягкий призыв в конце; главный запрос один раз, естественно.
• Честность: подсказка объясняет — это «предложение сниппета»; Яндекс часто берёт лид-абзац, поэтому лид проверяется отдельно (§12, №8).
• Автогенерация: 3 варианта от ИИ.

Адрес (slug)

• Автогенерация из H1: транслит, нижний регистр, дефисы, без стоп-слов, 3–6 слов; без дат для вечнозелёного контента. Свободно редактируем до первой публикации.
• Смена после публикации — предупреждение + вечный 301 со старого адреса (PB-4, EC-11).
• Коллизия — суффикс -2 с предупреждением (EC-7).

Автоматическая разметка (MT-2 — менеджер её не видит и не может сломать)

<title>Куда сходить в Москве: 15 идей на выходные — По душе</title>
<meta name="description" content="Собрали 15 проверенных мест…">
<link rel="canonical" href="https://ДОМЕН/blog/kuda-shodit-v-moskve">  ← срезает UTM
<meta property="og:type" content="article">   + og:title/description/url/site_name
<meta property="og:image" content="…1200×630…">
<meta name="twitter:card" content="summary_large_image">
<script type="application/ld+json">            ← для Google; Яндексу хватает HTML+OG
{ "@type":"Article", "headline":h1, "image":[16:9, 4:3, 1:1],
  "author":{"@type":"Person","name":автор,"url":стр.автора},
  "datePublished":…, "dateModified":…,
  "publisher":{"@type":"Organization","name":бренд,"logo":…} }
</script>
<script type="application/ld+json">{ "@type":"BreadcrumbList", … }</script>

Плюс: видимые даты «Опубликовано / Обновлено», блок автора, noindex на черновиках и предпросмотрах.

12 · SC

SEO-балл: 20 проверок и весов

Веса — серверная конфигурация, меняются без релиза. Каждый пункт в панели раскрывается в объяснение простым языком: что сделать и почему это важно.

13 · KW

Подбор запросов (Вордстат)

1. Менеджер вводит тему (и, опционально, регион).
2. Система показывает: частотность, топ связанных запросов за 30 дней, динамику по месяцам (сезонность), географию; у каждого запроса — эвристический интент («информационный» / «коммерческий — статья такой не возьмёт»).
3. Менеджер отмечает 1 главный + до 10 дополнительных — они прикрепляются к статье, проверки №1, 11, 12 начинают их отслеживать.

Кеш обязателен: квота API ~1000 обращений/сутки; ответы кешируются 7 дней (запрос+регион). Частотности прикреплённых запросов обновляются раз в месяц фоном. Поведение при исчерпании квоты — EC-2.

14 · AI

ИИ-помощник

Вызовы — через сервер (ключ OpenRouter в браузер не попадает), ответы стримятся. Три модельные настройки: писательская (длинные тексты), быстрая (title/description/мелкие правки), картиночная; меняются в конфигурации без релиза.

Контекст каждого запроса

1. SEO-гайд — зашитая выжимка правил §11–12 в форме инструкции.
2. База знаний — активные документы по продукту статьи + общие (§20).
3. Живой срез данных — автосводка каталога (события по городам, категории, примеры), кеш 1 час; для дейтинга — факты из базы знаний.
4. Статья — блоки, метаданные, запросы, балл, незакрытые пункты чек-листа.

Статичная часть кешируется на стороне модели (prompt caching) — повторные обращения кратно дешевле. Проверки балла, читабельность и разметка работают без ИИ — мгновенно и бесплатно; ИИ включается только там, где нужен текст.

Режимы

1. Статья целиком (AI-1): бриф (тема/пожелания или запрос из §13) → план (H1, разделы, места CTA и ленты; правится и перегенерируется) → генерация секциями с видимым прогрессом и стопом → черновик с флагом «нужна вычитка».
2. Чат (AI-2): полный контекст статьи; предложения правок — diff «было → станет» с «Применить/Отклонить»; молчаливых изменений не бывает. Быстрые кнопки: план, лид, 5 title, сократить на треть, проверить факты (сверка с базой знаний). История хранится у статьи.
3. Правка выделенного (AI-3): перефразировать · сократить · расширить · упростить · исправить ошибки; на быстрой модели; тот же diff.
4. Картинки (AI-4): в блоке «Картинка» и в обложке: описание сцены (ИИ предлагает по секции) → 2–4 варианта → выбранный уходит в S3 обычной картинкой. Стиль бренда — документ базы знаний.

15 · FD

Блок «Лента»

Лента событий (FD-1) — для статей продукта «события»

Карточка: обложка, название, дата ближайшего сеанса, место, цена. Клик → страница события на том же домене. Прошедшие выпадают сами; пустая лента не рендерится совсем (EC-5). Первичный рендер серверный (индексируется, даёт свежесть), на клиенте — тихая актуализация.

Лента анкет (FD-2, COULD) — для статей продукта «знакомства»

Источник — только витринные анкеты (ShowcaseProfile): ручной набор с зафиксированным согласием (или редакционные персоны). Карточка: фото, имя, возраст, город, строка «о себе»; клик — умная ссылка на установку/открытие приложения (стор по устройству). Публичных страниц анкет не существует.

Аналитика ленты: feed_view (блок доехал до экрана) и feed_item_click (id и позиция карточки) — свой счётчик; в карточке статьи — CTR ленты и топ карточек; клики входят в главную метрику конверсий (§1).

16 · PB

Публикация

Конвейер «Опубликовать» (PB-1)

1. Блокеры (не пускают): нет H1 · нет автора · нет обложки · не снят needs_review · пустой текст. Предупреждения (пускают после подтверждения): балл < 50 · нет прикреплённых запросов.
2. Версия — снапшот в ArticleVersion (PB-2).
3. Статус → published; выставляются даты.
4. Страница — сброс кеша /blog/<slug> на домене продукта; доступна сразу со всей разметкой §11.
5. sitemap.xml домена пересобирается (lastmod = updated_at).
6. IndexNow-пинг в Яндекс (индексация за часы); Google — по sitemap. Ошибка пинга не блокирует публикацию — ретрай фоном (EC-3).
7. Тост: «Опубликовано → открыть на сайте».

Остальные переходы

• Опубликовать изменения: тот же конвейер; updated_at обновляется, published_at неизменен.
• Запланировать (PB-3): статус scheduled; фоновая задача раз в минуту публикует созревшие; «Отменить» → черновик. Время в прошлом — EC-14.
• Снять с публикации: страница отдаёт 410 Gone, из sitemap исчезает; статья с историей и метриками остаётся в админке.
• Откат: версии со сравнением; «Восстановить» кладёт снапшот в черновик → обычная публикация (S4).
• Смена slug: предупреждение + вечный 301 (PB-4, EC-11).

17 · BL

Публичный блог

18 · TR

Свой счётчик

Скрипт < 2 КБ на страницах статей. Анонимный: случайный session_id на вкладку, без кук идентификации и PII. Публичная ручка без авторизации; боты отсекаются по User-Agent и отсутствию взаимодействий. Зачем при Метрике: мгновенные цифры в админке, независимость, вечное хранение агрегатов.

Сырые BlogHit — 180 дней; ночная свёртка в ArticleMetricDaily (source=own) — вечно. «Дочитал», «клик CTA», «клик ленты» дублируются в Метрику как цели (сегменты + Вебвизор по дочитавшим).

19 · AN

Аналитика (этап 2)

Словарь метрик — единственные определения, всюду одинаковые

Внешние API опрашиваются ночью за вчера → ArticleMetricDaily. Вкладка открывается мгновенно из нашей базы; у внешних данных подпись «данные за <дата>». История не теряется (GSC сам хранит лишь 16 мес).

Сводный дашборд (период 7 / 30 / 90 дней)

Тайлы: конверсии из статей (главная, с динамикой) · визиты из поиска · опубликовано статей · средняя дочитываемость · средний SEO-балл. Ниже: топ-5 статей по конверсиям и топ-10 запросов (Я+G).

Список статей

Столбцы: статья · продукт · опубликована · просмотры (спарклайн) · % из поиска · дочитываемость · позиция Я/G · конверсия. Сортировка по всем; фильтры: продукт, автор, рубрика, период.

Карточка статьи

1. Шапка: обложка, H1, «открыть на сайте» / «в редактор», балл.
2. Воронка: показы → клики (CTR) → просмотры → дочитали → конверсии.
3. График просмотров и кликов из поиска с отметками публикаций изменений (S3).
4. Запросы: таблица (запрос · показы · клики · CTR · позиция · динамика), вкладки Яндекс/Google; подсказка «позиция 5–15 — близко к топу, усильте в тексте».
5. Источники: поиск (Я/G) / соцсети / прямые / внутренние.
6. Поведение: пороги дочитывания, медианное время; кнопки «Карта кликов» и «Записи сессий (Вебвизор)» — в Метрику с фильтром по адресу.
7. CTA и лента: клики по каждой кнопке; CTR ленты, топ-5 карточек.

20 · KB

База знаний и Авторы

База знаний: список документов (заголовок, продукт, активен, обновлён) + markdown-редактор. Стартовый набор: «Продукт "По душе"» · «Продукт "По любви"» · «Аудитория» · «Тон и стиль» (пишем так / не так) · «Факты и цифры» (с датами) · «Запретные темы» · «Стиль иллюстраций». Деактивация выводит из контекста ИИ немедленно. Индикатор суммарного объёма активных документов; при превышении лимита — предупреждение, какие ужать.

Авторы: имя, slug, фото (квадрат ≥ 400 px), био ≤ 600, регалии, активен. Используются в выборе автора, блоке автора, странице автора, разметке Article. Деактивированный скрыт из выбора; его статьи и страница работают (EC-13). Удаление запрещено.

21 · AC

Интеграции · RBAC · аудит

• Новый продукт seo в рельсе; секции: статьи, аналитика, база знаний, авторы.
• Право seo.write — роли Admin и Content; остальным раздел не виден. Витринные анкеты — только Admin.
• Аудит-лог: публикации, снятия, откаты, смены slug, снятие «нужна вычитка», перехваты блокировки, изменения базы знаний и авторов — кто и когда.

22 · EC

Граничные случаи и тексты ошибок

23 · NF

Нефункциональные требования

24

Критерии приёмки и готовность

Ключевые критерии (формат «дано → когда → тогда»)

Готовность этапов (Definition of Done)

• Этап 0 готов: домен(ы) отвечают по HTTPS; в robots/заголовках нет запретов индексации; Метрика/Вебмастер/GSC подтверждены; ключи OpenRouter, Вордстата, IndexNow в конфигурации; фоновый воркер жив (тестовая задача исполняется).
• Этап 1 готов: сценарии S1, S2, S4, S5 проходят целиком; критерии A-1…A-7 зелёные; страница статьи валидна в Rich Results Test и валидаторе Вебмастера; NF-1…NF-5 проверены; смоук-тест админки дополнен разделом SEO.
• Этап 2 готов: A-8 зелёный; ночные сборщики трёх API отработали ≥ 3 суток подряд; вкладка «Аналитика» показывает все виджеты §19 на реальной статье; определения метрик совпадают со словарём §19.

25

Этапы запуска

26

Открытые вопросы · риски

Все вопросы должны быть закрыты (и решения внесены в эту спеку) до начала соответствующих работ; O-1, O-6 — до старта этапа 0/1.

27

Что сознательно не делаем (non-goals)

• Анализ конкурентов из выдачи — исключён решением гриля-2.
• FAQ- и HowTo-разметка schema.org — Google отключил отображение; сами вопросы-ответы в тексте остаются.
• Турбо-страницы Яндекса — технология закрыта в 2025.
• Свой аналог Вебвизора — записи сессий в Метрике.
• Инструменты для профессионального SEO-специалиста (персона «не персона», §3).
• Мультиязычность, комментарии читателей — не в этой версии.
• Публичные страницы реальных анкет — никогда.

28

Заметки для разработки

Точки в существующем коде

• Админка: продукт seo в PRODUCTS (admin-panel/assets/core.js) и adminpanel/rbac.py; секции в SECTIONS, файлы assets/sections/seo*.js, регистрация в admin.js; эталон — sections/telegram.js. Инварианты: секция → SECTION_PRODUCT (тест), endpoint → ENDPOINT_RULES (иначе 403).
• Бэкенд: новый Django-app seo/. Образец публикуемой сущности — EventCollection + views/collections.py + collections/[slug].vue.
• Витрина: блог-страницы в web-events (Nuxt SSR), routeRules '/blog/**': swr 300 + инвалидация при публикации; один билд, продукт домена — env SITE_PRODUCT; для дейтинга — второй деплой того же приложения.
• Caddy: отдельные site-блоки публичных доменов — без X-Robots-Tag и basic auth. Стенд остаётся закрытым.
• Воркер — этап 0: на демо-стенде нет Dramatiq-воркера; поднять rundramatiq. Задачи: публикация по расписанию (минутная), ночные сборщики, свёртка BlogHit, IndexNow-ретраи, часовой срез данных для ИИ, месячный рефреш частотностей.

API админки (все — в ENDPOINT_RULES, запись — seo.write)

GET/POST   /seo/articles                     список / создание
GET/PATCH  /seo/articles/{id}                чтение / автосохранение
POST       /seo/articles/{id}/publish | unpublish | schedule | review-done
POST       /seo/articles/{id}/lock | unlock  мягкая блокировка (heartbeat)
GET        /seo/articles/{id}/versions       POST …/versions/{n}/restore
POST       /seo/articles/{id}/score          серверный пересчёт
GET        /seo/keywords?q=®ion=          Вордстат (кеш)
POST       /seo/ai/chat | generate | edit | image     (SSE-стриминг)
GET/POST/PATCH /seo/authors, /seo/kb, /seo/showcase-profiles
GET        /seo/analytics/summary | articles | articles/{id}

Публичные ручки (домены блога, без авторизации)

GET  /api/v1/blog/articles?page=&tag=     список (SSR)
GET  /api/v1/blog/articles/{slug}         статья (404 / 410 / 301 по slug_history)
GET  /api/v1/blog/feed/{block_id}         данные ленты
POST /api/v1/blog/track                   счётчик (батч, троттлинг по IP)

Переменные окружения

OPENROUTER_API_KEY            SEO_AI_MODEL_WRITER / _FAST / _IMAGE
SEO_AI_MONTHLY_BUDGET_RUB     WORDSTAT_OAUTH_TOKEN
METRIKA_TOKEN                 METRIKA_COUNTER_EVENTS / _DATING
WEBMASTER_TOKEN               GSC_CREDENTIALS_JSON
INDEXNOW_KEY_EVENTS / _DATING BLOG_DOMAIN_EVENTS / _DATING
SITE_PRODUCT                  (events | dating — на каждом деплое витрины)

29

История версий документа

30

Состояние реализации

По разделам спецификации

Что уже работает целиком

Менеджер заводит статью и получает адрес из заголовка → набирает текст блоками, статья сохраняется сама, второй редактор видит плашку блокировки → загружает обложку, сервер сжимает её в WebP и сам читает размеры из файла → балл и чек-лист обновляются тем же ответом, что и сохранение. Проверено сквозным прогоном по HTTP; на стенде раздел ещё не разворачивался.

Где реализация сознательно отошла от буквы спеки

Каждое отклонение помечено Δ в SEO_ADMIN_API.md и объяснено там же. Коротко:

• Проверка №15 переосмыслена. «Alt у 100% картинок» не могло провалиться никогда: валидатор не пропускает картинку без alt. Теперь проверяется осмысленность alt (не имя файла, не «фото»), а alt обложки остался за №4 — одна пустая строка не должна штрафоваться дважды.
• Неприменимая проверка засчитывается. Нет картинок — №15 пройдена, нет цифр — №18, текст короче 150 слов — №13, нет заголовков — №6, нет текста — №16. Обратное наказывало бы за то, чего в статье нет.
• Не прикреплён запрос — незачёт у семи проверок: иначе статья без подбора запросов получала бы балл выше, чем статья с подобранным, но не использованным.
• №9 читает то, что стоит сразу под заголовком-вопросом, и считает ответом список целиком: «куда сходить» — это листикл, и перечисление отвечает не хуже абзаца.
• Год не считается фактом для №18. «Фестиваль в 2026 году» — дата, а не статистика; иначе проверка краснела почти на каждой статье про события.
• Канцелярит не влияет на зачёт №14 — §12 просит подсветку с заменами, а не запрет.
• Отказ загрузки по размеру — 413, а не 400: тем же кодом отвечает nginx, когда тело не доходит до приложения. У «не картинки» текст свой: «Файл больше 10 МБ. Сожмите» в ответ на PDF отправляет менеджера сжимать документ, который надо заменить.
• Набора ширин (srcset) загрузка не делает — класть их некуда: схема блока закрытая, а в cover_id помещается один ключ. Ширины появятся вместе с рендером витрины.
• Список статей по умолчанию сортируется по последней правке, а не по датам публикации: у черновиков этих дат нет вовсе.
• Порог заголовка — пиксели, а не знаки. 580 px по таблице ширин это ~56 русских знаков, а не 60: «60 знаков» из §11 — английская прикидка, кириллица шире.