dsh-desktop-kit 0.0.0-stage → 2.0.0

package/skills/seo/references/audit-checklist.md

@@ -0,0 +1,319 @@
+> Часть навыка seo. ≈7 900 токенов. Читать, когда: аудит сайта или финальная приёмка — 107 проверок P0/P1/P2, шаблоны отчёта, карта автотестов `seo-audit.mjs`.
+
+# Чек-лист SEO-аудита (P0/P1/P2) + шаблон отчёта
+
+> 107 проверок по 12 областям. Используй для аудита существующего сайта и как «definition of done» для новых
+> страниц. Приоритеты: **P0** — блокирует индексацию/трафик/доверие (чинить сразу), **P1** — заметно влияет
+> (чинить в текущей итерации), **P2** — улучшение (в бэклог). Проверено 04.11.2026.
+
+## 0. Порог сдачи
+
+- Аудит: все P0 закрыты или явно вынесены в отчёт с причиной и владельцем; P1 — закрыты или запланированы.
+- Новая страница: 0 P0, 0 P1 в блоках «Мета», «Контент», «Индексация», «YMYL»; JSON-LD валиден; CWV в норме
+  (или есть план с датой).
+- `seo-audit.mjs`: `critical = 0`, `serious = 0` (для страницы); для сайта — `critical = 0` и план по `serious`.
+
+## 1. Индексация и обход
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| IDX-01 | Страница отдаёт HTTP 200 | P0 | `curl -I URL` | исправить статус/404/500, убрать «мягкий 404» |
+| IDX-02 | Нет `<meta name="robots" content="noindex">` на деньгах/услугах | P0 | view-source / GSC URL Inspection | убрать `noindex`, проверить шаблон |
+| IDX-03 | Страница не закрыта в robots.txt | P0 | `curl /robots.txt`, GSC тест robots | открыть Allow/убрать Disallow |
+| IDX-04 | Страница есть в sitemap.xml и sitemap валиден | P0 | открыть `/sitemap.xml`, Вебмастер/GSC | добавить URL, перегенерировать |
+| IDX-05 | В sitemap нет 404/301/`noindex` | P1 | сверка sitemap с ответами (скрипт/краул) | фильтровать выборку URL |
+| IDX-06 | `lastmod` реальный (не «сегодня» у всех) | P2 | сравнить даты с изменениями | брать `updated_at` сущностей |
+| IDX-07 | Нет «мягких 404» (200 на пустых страницах) | P0 | краул/выборка URL-ов, GSC «Страницы» | отдавать 404/410, `SET_STATUS_404=Y` (Bitrix) |
+| IDX-08 | Нет лишних URL в индексе (фасеты, сортировки, поиск) | P1 | GSC «Страницы → Проиндексировано», `site:` | `noindex,follow`, canonical, Clean-param |
+| IDX-09 | Служебные зоны (админка, кабинет, «спасибо») закрыты/`noindex` | P1 | view-source | `noindex`/robots |
+| IDX-10 | Тестовые/стейдж-домены закрыты | P0 | GSC/Вебмастер, поиск по домену | Basic Auth/`noindex`/удалить |
+
+## 2. URL и редиректы
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| URL-01 | Одна версия сайта: https + без www (+ без/со слэшем) | P0 | `curl -I` на 4 варианта | 301 на каноническую версию |
+| URL-02 | Нет цепочек редиректов (1 прыжок) | P1 | краул/ручная проверка | прямые 301 |
+| URL-03 | 301, а не 302, для постоянных переездов | P1 | `curl -I` | сменить код |
+| URL-04 | URL читаемые: латиница, дефисы, без параметров | P1 | глазами/краул | переименовать + 301 |
+| URL-05 | Нет `index.php`, `?id=`, КАПС, подчёркиваний | P2 | краул | ЧПУ + 301 |
+| URL-06 | Смена URL сопровождается 301 + обновлением sitemap/ссылок | P0 | git-диff, GSC | карта редиректов |
+| URL-07 | Удалённые страницы: 410 или 301 на релевантную | P1 | GSC 404-отчёт | решить судьбу каждой |
+| URL-08 | Относительный/абсолютный URL в canonical корректен | P0 | view-source | абсолютный URL |
+| URL-09 | Пагинация: canonical на себя, уникальные title | P1 | view-source `?page=2` | поправить шаблон |
+| URL-10 | 404-страница отдаёт 404 и содержит навигацию/поиск | P2 | открыть несуществующий URL | настроить 404-шаблон |
+
+## 3. Мета и сниппет
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| META-01 | `<title>` есть, уникальный, 50–60 симв. | P0 | `seo-audit.mjs`, сверка по сайту | шаблоны + свойства |
+| META-02 | `title` описывает страницу, запрос в начале, бренд в конце | P1 | глазами | переписать |
+| META-03 | `description` есть, уникальный, 140–160 симв. | P1 | `seo-audit.mjs` | SEO-шаблоны/поля |
+| META-04 | Один `H1`, совпадает с интентом | P0 | `seo-audit.mjs` | убрать лишние H1 |
+| META-05 | Иерархия H2–H6 без пропусков | P2 | `seo-audit.mjs` | поправить уровни |
+| META-06 | OG-теги + `og:image` 1200×630 | P1 | view-source/отладчик соцсетей | шаблон OG |
+| META-07 | `canonical` есть и корректен | P0 | `seo-audit.mjs` | см. URL-08 |
+| META-08 | `lang="ru"`, `charset`, `viewport` | P1 | view-source | поправить head |
+| META-09 | Нет дублей мета-тегов (два title/canonical) | P1 | `seo-audit.mjs` | убрать дубли в шаблоне |
+| META-10 | Сниппет выглядит осмысленно (title+desc+путь) | P2 | «как в поиске» / GSC | переписать title/desc |
+
+## 4. Контент и структура
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| CNT-01 | Ответ на интент в первых 100–150 словах | P0 | прочитать | переписать лид |
+| CNT-02 | Контент уникален (не копипаст) | P0 | поиск фразы в кавычках | переработать |
+| CNT-03 | Нет каннибализации (2 страницы под 1 интент) | P1 | GSC «Страницы» по запросу | склеить/развести интенты |
+| CNT-04 | Структура: H2-подтемы, списки, таблицы | P1 | прочитать | переверстать |
+| CNT-05 | Есть блок «Кому показано/Показания» (услуга) | P0 | прочитать | добавить |
+| CNT-06 | Есть «Как проходит» и «Подготовка» | P0 | прочитать | добавить |
+| CNT-07 | Есть «Противопоказания/ограничения» | P0 | прочитать | добавить |
+| CNT-08 | Есть FAQ 5–8 реальных вопросов | P1 | прочитать | собрать из спроса |
+| CNT-09 | Есть цены/сроки/что входит | P1 | прочитать | добавить таблицу цен |
+| CNT-10 | Есть CTA (запись/звонок) | P1 | прочитать | добавить блок |
+| CNT-11 | Нет воды и «инновационных решений» | P2 | прочитать | вычистить |
+| CNT-12 | Свежесть: дата обновления актуальна | P1 | view-source/текст | обновить при изменениях |
+
+## 5. Изображения
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| IMG-01 | У всех контентных изображений `alt` | P1 | `seo-audit.mjs` | добавить описательный alt |
+| IMG-02 | `alt` не спам ключами/не «img1» | P2 | глазами | переписать |
+| IMG-03 | Есть `width`/`height` (или `aspect-ratio`) | P1 | `seo-audit.mjs`/DevTools | добавить размеры |
+| IMG-04 | Форматы WebP/AVIF, вес ≤200 КБ | P2 | DevTools Network | конвертировать/сжать |
+| IMG-05 | LCP-изображение без `loading="lazy"` | P0 | Lighthouse/DevTools | `fetchpriority="high"` |
+| IMG-06 | Осмысленные имена файлов, нет пробелов/кириллицы | P2 | краул | переименовать |
+| IMG-07 | Реальные фото, не стоки (доверие) | P1 | глазами | заменить |
+
+## 6. Ссылки (внутренние/внешние)
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| LNK-01 | Нет битых внутренних ссылок (404) | P0 | краул/`seo-audit.mjs` | исправить/редирект |
+| LNK-02 | Страница не «сирота» (есть входящие) | P1 | краул | добавить ссылки с хаба/статей |
+| LNK-03 | 2–6 контекстных ссылок в тексте | P1 | `seo-audit.mjs` | добавить по смыслу |
+| LNK-04 | Анкоры описательные, не «здесь/подробнее» | P1 | `seo-audit.mjs` | переписать анкоры |
+| LNK-05 | Ссылки на важные страницы с главной/хаба | P1 | глазами/краул | добавить в меню/хаб |
+| LNK-06 | Внешние ссылки: живые, на авторитетные источники | P2 | `seo-audit.mjs` | обновить/убрать битые |
+| LNK-07 | Абсолютные URL в canonical/OG/sitemap | P0 | view-source | исправить |
+
+## 7. Структурированные данные
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| SD-01 | JSON-LD присутствует на значимых страницах | P1 | `seo-audit.mjs` | добавить из `structured-data.md` |
+| SD-02 | JSON валиден (нет ошибок парсинга) | P0 | Rich Results Test/`seo-audit.mjs` | исправить JSON |
+| SD-03 | Поля совпадают с видимым контентом | P0 | глазами | убрать невидимое/поправить |
+| SD-04 | `BreadcrumbList` есть и совпадает с крошками | P1 | валидатор | добавить |
+| SD-05 | `Organization`/`MedicalClinic` с адресом/телефоном/логотипом | P1 | валидатор | добавить |
+| SD-06 | `Physician` на профилях врачей | P1 | валидатор | добавить |
+| SD-07 | `MedicalWebPage`/`Article` с автором и датами | P1 | валидатор | добавить |
+| SD-08 | Нет устаревших типов (HowTo, SpecialAnnouncement) | P2 | `seo-audit.mjs` | удалить |
+| SD-09 | Нет выдуманных `aggregateRating`/`review` | P0 | глазами | убрать |
+| SD-10 | URL в разметке абсолютные | P1 | `seo-audit.mjs` | заменить |
+
+## 8. Скорость и Core Web Vitals
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| CWV-01 | LCP ≤2,5 с (поле, 75-й перцентиль) | P1 | PSI/GSC/CrUX | оптимизация LCP-ресурса |
+| CWV-02 | INP ≤200 мс | P1 | PSI/GSC | меньше/дробить JS |
+| CWV-03 | CLS ≤0,1 | P1 | PSI/GSC | размеры, шрифты, баннеры |
+| CWV-04 | TTFB <0,8 с (цель) | P2 | PSI/DevTools | кеш/CDN/сервер |
+| CWV-05 | Нет блокирующего CSS/JS в head | P2 | Lighthouse | async/defer/критический CSS |
+| CWV-06 | Шрифты: `font-display`, preload, локальные | P2 | view-source | настроить |
+| CWV-07 | Изображения оптимизированы (формат/размер/srcset) | P2 | DevTools | конвертировать |
+| CWV-08 | Сторонние скрипты не блокируют (счётчики, чаты) | P2 | Lighthouse | lazy/async |
+
+## 9. Мобильный и доступность
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| MOB-01 | Нет горизонтального скролла на 390px | P1 | DevTools 390 | адаптив/таблицы в скролл-контейнер |
+| MOB-02 | Тач-цели ≥44px | P2 | DevTools | увеличить |
+| MOB-03 | Шрифт в полях ≥16px (iOS не зумит) | P2 | DevTools | поправить CSS |
+| MOB-04 | Мобильная версия содержит тот же контент/мета, что десктоп | P0 | сравнить | mobile-first |
+| MOB-05 | Контраст текста ≥4,5:1 | P2 | axe/Lighthouse | поправить цвета |
+| MOB-06 | Клавиатурная доступность, focus-visible | P2 | Tab | поправить |
+| MOB-07 | Кнопки/ссылки имеют доступные названия | P2 | axe | aria-label |
+
+## 10. E-E-A-T / YMYL (медицина)
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| YMYL-01 | Автор-врач с ФИО/специальностью/ссылкой на профиль | P0 | прочитать | добавить автора |
+| YMYL-02 | Рецензент и дата проверки | P1 | прочитать | добавить |
+| YMYL-03 | Дата публикации и обновления видимы | P0 | прочитать | вывести даты |
+| YMYL-04 | Ссылки на первоисточники (Минздрав/ВОЗ/PubMed) | P1 | прочитать | добавить |
+| YMYL-05 | Дисклеймер (общий + под статьёй) | P0 | прочитать | добавить |
+| YMYL-06 | Нет обещаний излечения/гарантий | P0 | прочитать | переписать |
+| YMYL-07 | Нет назначений «по интернету» | P0 | прочитать | переписать |
+| YMYL-08 | Лицензия (номер/дата/орган) видна | P1 | прочитать | добавить страницу |
+| YMYL-09 | Юрлицо/ИНН/ОГРН/главврач | P1 | прочитать | добавить |
+| YMYL-10 | «Когда срочно к врачу» на симптомных статьях | P1 | прочитать | добавить |
+| YMYL-11 | Нет выдуманных отзывов/стажа/наград | P0 | выборочно | удалить/заменить |
+| YMYL-12 | Политика конфиденциальности + согласие ПДн | P0 | формы | добавить |
+
+## 11. Локальное SEO (клиника)
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| LOC-01 | NAP совпадает на сайте/в Яндекс Бизнесе/2ГИС | P0 | сверка | привести к одному формату |
+| LOC-02 | Регион указан в Яндекс Вебмастере | P0 | Вебмастер → Регион | указать Москву |
+| LOC-03 | Часы работы актуальны | P1 | сверка | обновить |
+| LOC-04 | Карта/схема проезда на «Контактах» | P1 | глазами | встроить карту |
+| LOC-05 | Страницы филиалов с отдельным адресом | P1 | краул | создать |
+| LOC-06 | Отзывы реальные + ответы | P2 | глазами | отвечать/модерировать |
+| LOC-07 | Карточки: Яндекс Бизнес, 2ГИС, GBP | P1 | открыть | заполнить |
+| LOC-08 | Локальные упоминания (район/метро) в тексте | P2 | прочитать | добавить |
+
+## 12. Аналитика и мониторинг
+
+| ID | Проверка | Приоритет | Как проверить | Как чинить |
+|---|---|---|---|---|
+| AN-01 | GSC: сайт подтверждён, sitemap отправлен | P0 | GSC | настроить |
+| AN-02 | Яндекс Вебмастер: подтверждён, sitemap отправлен | P0 | Вебмастер | настроить |
+| AN-03 | GA4/Метрика: цели «запись/звонок/форма» | P1 | интерфейс | настроить |
+| AN-04 | UTM-разметка внешних кампаний | P2 | ссылки | внедрить шаблон |
+| AN-05 | Отчёты «до/после» и baseline | P1 | документ | завести файл |
+| AN-06 | Мониторинг 404/5xx (логи/GSC/Вебмастер) | P1 | отчёты | алерт |
+
+**Итого: 107 проверок** (P0 — 35, P1 — 48, P2 — 24).
+
+---
+
+## 13. Автоматизируемые проверки (seo-audit.mjs)
+
+> Инструмент делает **qa-toolsmith** (task-5) и живёт в `assets/scripts/seo-audit.mjs` этого скилла.
+> Контракт интерфейса (согласован с Лидом):
+> `node seo-audit.mjs <file|url> --out <dir> [--json]`
+> Выход: `<dir>/seo-audit.json` и `<dir>/seo-audit.md`; severity: `critical | serious | minor`.
+
+### Что инструмент обязан закрывать (маппинг на ID выше)
+
+| Категория | Проверки | Severity |
+|---|---|---|
+| `meta` | META-01 (наличие/длина title), META-03 (description), META-09 (дубли), META-08 (`lang`, charset, viewport), META-06 (OG: наличие ключевых) | critical (нет title/H1), serious (длина/дубли), minor (OG) |
+| `headings` | META-04 (count H1), META-05 (порядок H2–H6) | critical (0 или >1 H1), minor (порядок) |
+| `canonical` | META-07, URL-08, LNK-07 (абсолютность, self-referencing, дубли canonical) | critical |
+| `robots` | IDX-02 (`noindex` на странице), IDX-03 (Disallow для URL, если передан robots.txt) | critical |
+| `jsonld` | SD-01, SD-02 (парсинг), SD-08 (устаревшие типы), SD-10 (относительные URL), SD-03 (пустые обязательные поля по типу) | critical (битый JSON), serious (нет разметки/полей), minor |
+| `images` | IMG-01 (`alt`), IMG-03 (`width/height`/`aspect-ratio`), IMG-05 (lazy на первом экране/LCP), вес/формат (если размер известен) | serious (нет alt/размеров), minor (формат) |
+| `links` | LNK-01 (битые внутренние, при `--crawl`), LNK-03 (мало внутренних), LNK-04 (анкоры «здесь/подробнее»), LNK-07 | serious (битые), minor (анкоры) |
+| `sitemap` | IDX-04, IDX-05 (валидность XML, статусы URL, `noindex` в карте) | critical (невалидна/нет), serious |
+| `crawl` | IDX-01, IDX-07 (soft 404), IDX-08 (мусорные URL), URL-02 (цепочки), LNK-02 (сироты) | critical/serious |
+| `ymyl` | YMYL-01, YMYL-03, YMYL-05, YMYL-06 (маркеры «гарантируем излечение»), YMYL-12 | serious |
+| `perf` | CWV-06 (шрифты), CWV-05 (блокирующие скрипты), размер HTML, число запросов (эвристики) | minor/serious |
+| `local` | LOC-01 (телефон/адрес в разметке vs текст), LOC-03 (часы), NAP-консистентность на странице | serious |
+| `onpage` | CNT-04 (наличие H2/списков), CNT-05/06/07 (маркеры блоков для услуг), CNT-08 (FAQ-маркер), CNT-10 (CTA) | minor/serious (YMYL-страницы) |
+
+### Формат отчёта (ожидаемый)
+
+```json
+{
+  "url": "https://example.org/uslugi/mrt-golovy/",
+  "generatedAt": "2026-11-04T12:40:00+03:00",
+  "status": 200,
+  "score": 82,
+  "checks": [
+    {
+      "id": "META-01",
+      "category": "meta",
+      "severity": "serious",
+      "message": "title 71 символ (>60) — обрежется в выдаче",
+      "value": "...",
+      "fix": "Сократить до 50–60 символов, бренд в конце"
+    }
+  ],
+  "summary": { "critical": 0, "serious": 3, "minor": 7 }
+}
+```
+
+```markdown
+# SEO-аудит: <URL>
+Дата: ... · Статус: 200 · Оценка: 82/100
+## Критично (0)
+## Серьёзно (3)
+- META-01 ... — как чинить
+## Мелочи (7)
+...
+```
+
+### Что НЕ автоматизируется (делать руками)
+- Интент и качество контента (CNT-01, CNT-02, CNT-03).
+- E-E-A-T-суждения (реальность автора, источников, лицензии).
+- Каннибализация и семантика (нужны GSC/Вебмастер/Вордстат).
+- Визуальный сниппет и CTR.
+- Полные полевые CWV (нужны PSI/CrUX).
+
+---
+
+## 14. Шаблон SEO-отчёта (для Лида/заказчика)
+
+```markdown
+## SEO-аудит: <сайт/раздел> — <дата>
+**Объём:** <N страниц проанализировано, M проверок>
+**Инструменты:** seo-audit.mjs, GSC, Яндекс Вебмастер, PSI, Rich Results Test
+
+### Резюме
+- P0: N · P1: M · P2: K
+- Главные проблемы: <3–5 пунктов>
+- Быстрые победы (≤1 день): <3–5 пунктов>
+- Прогноз: <что даст закрытие P0/P1, без обещаний позиций>
+
+### P0 (блокирует)
+| ID | Проблема | Где | Как чинить | Трудоёмкость |
+|---|---|---|---|---|
+| ... | ... | ... | ... | ... |
+
+### P1 (влияет заметно)
+...
+
+### P2 (бэклог)
+...
+
+### Что проверено и в порядке
+<список блоков/проверок>
+
+### План
+1. Неделя 1: P0 ...
+2. Неделя 2–3: P1 ...
+3. Далее: контент/перелинковка ...
+
+### Риски
+<смена URL без редиректов, потеря трафика, YMYL-риски>
+```
+
+### Короткий отчёт по странице/задаче (не аудит)
+
+```markdown
+## SEO: <страница/задача>
+Интент: <информационный/коммерческий/локальный> · кластер: <главный запрос + 3–5 поддерживающих>
+Что сделано: <5–8 пунктов: title/desc, H1, canonical, JSON-LD, ссылки, alt, редиректы, sitemap>
+Проверено: <валидатор: 0 ошибок; 200 + index; robots/sitemap; CWV; curl/view-source>
+Baseline: <если применимо — показы/клики/позиция/CTR до, дата>
+Риски: <что может просесть и почему; какие P1/P2 отложены>
+Что дальше: <1–3 шага: контент, перелинковка, ускорение, мониторинг>
+```
+
+## 15. Как приоритизировать (если P0 много)
+
+1. **Индексация** (IDX-01…04, 07) — без неё остальное бессмысленно.
+2. **Дубли и canonical** (URL-01, META-07).
+3. **Шаблоны title/description** (META-01, META-03) — быстрый прирост CTR по всему сайту.
+4. **YMYL-блокеры** (YMYL-01, 03, 05, 06).
+5. **Битые ссылки/мягкие 404**.
+6. **CWV** (дольше всего, но влияет на всё).
+7. **Контент-глубина и перелинковка** — постоянный процесс.
+
+## 16. Первоисточники
+
+- Google. Основы: https://developers.google.com/search/docs/essentials
+- Google. Отчёты Search Console: https://support.google.com/webmasters
+- Google. Тест Rich Results: https://search.google.com/test/rich-results
+- Schema validator: https://validator.schema.org
+- PageSpeed Insights: https://pagespeed.web.dev
+- Яндекс Вебмастер: https://webmaster.yandex.ru · справка: https://yandex.ru/support/webmaster/ru/
+- CWV: https://web.dev/articles/vitals

package/skills/seo/references/content-seo.md

@@ -0,0 +1,204 @@
+> Часть навыка seo. ≈5 850 токенов. Читать, когда: планируешь новую страницу или статью — бриф, интент, кластеры, структура, перелинковка, CTA, freshness.
+
+# Контент-SEO: интент, кластеры, структура, перелинковка
+
+> Контент ранжируется, когда он **лучше всех отвечает на конкретный интент** и заслуживает доверия.
+> Ключевые слова — следствие, а не цель. Здесь — как планировать, писать и связывать страницы.
+> Проверено 04.11.2026.
+
+## 1. SEO-бриф (заполняется до текста, 10 минут)
+
+```
+Страница: <URL/тип>
+Интент: <информационный | коммерческий | навигационный | локальный>
+Кто ищет: <пациент / родственник / врач-направленец / журналист>
+Гео: <город/район, филиалы, зона обслуживания>  ← для клиники критично
+Запрос-кластер: <главный ВЧ/СЧ> + <5–15 поддерживающих НЧ>
+Что в топе: <типы страниц, форматы, длина, наличие карт/видео/калькуляторов>
+Чего не хватает в топе: <наш шанс: глубина, локальность, эксперт, цены, запись, FAQ>
+Целевое действие (CTA): <запись / звонок / маршрут / скачать памятку>
+Доказательства (E-E-A-T): <автор-врач, рецензент, оборудование, лицензия, цифры>
+Внутренние ссылки: <на 3–5 страниц: хаб, смежные услуги, врач>
+Схема: <тип JSON-LD>
+Дата/актуальность: <когда обновлять>
+```
+
+## 2. Интент: 4 типа и что под них строится
+
+| Интент | Примеры запросов | Формат страницы | Главный ответ |
+|---|---|---|---|
+| **Информационный** | «высокое давление симптомы», «как подготовиться к МРТ» | статья/справочник: ответ в первом абзаце, H2-вопросы, FAQ | прямой ответ + «когда к врачу» |
+| **Коммерческий/транзакционный** | «записаться к кардиологу», «мрт цена», «платная клиника» | услуга/лендинг: цена, врачи, запись, отзывы, лицензия | цена + как записаться |
+| **Навигационный** | «гкб 31 официальный сайт», «гкб 31 врачи» | главная/контакты/раздел: навигация, телефон, расписание | быстрый переход к нужному |
+| **Локальный** | «клиника рядом», «больница на бауманской», «мрт в москве» | страница филиала/направления + карта, NAP, часы | адрес, часы, маршрут |
+
+Правило: **один URL — один интент**. Если интентов два (информация + запись) — либо одна страница с явными
+блоками, либо две страницы с перелинковкой (статья → услуга).
+
+## 3. Семантика: сбор и кластеризация
+
+### Источники
+1. **Яндекс Вордстат** (`wordstat.yandex.ru`) — по региону! Для example.org — Москва и область. Учитывай, что
+   Вордстат показывает суммарную частотность по фразам с хвостами.
+2. Google Search Console → «Эффективность» → запросы (реальные показы вашего сайта) — самый ценный источник
+   «что уже почти работает».
+3. Яндекс Вебмастер → «Поисковые запросы».
+4. Подсказки Яндекс/Google, «Похожие запросы», «Люди также спрашивают».
+5. Конкуренты в топе (Медси/СМ-Клиника/госбольницы) — их структура, H2, FAQ.
+6. Внутренний поиск сайта и вопросы в колл-центре/на приёме — золото для FAQ и статей.
+
+**Актуальную выдачу, конкурентов и тренды проверяй живым поиском** (`web-research`: дата проверки + ссылки),
+а не по памяти модели. Форматы в топе (статья, карточка, видео, карта, калькулятор) задают формат твоей страницы.
+
+### Кластеризация
+- Один кластер = один интент = **одна страница**.
+- В кластере: 1 главный запрос + 5–15 поддерживающих (синонимы, уточнения, вопросы).
+- Проверка каннибализации: в топе по двум запросам — **разные** страницы вашего сайта? Если одна и та же —
+  норма; если две конкурируют — склей/перелинкуй/переопредели интент.
+- Приоритизация: частотность × коммерческая ценность × близость к записи × сложность (конкуренты).
+  Для клиники: услуги > направления > статьи (но статьи приводят новых и поддерживают услуги).
+
+### Частотность: как не соврать
+- Указывай источник, регион и дату («Вордстат, Москва, ноябрь 2026») — иначе цифра бессмысленна.
+- НЧ/СЧ/ВЧ — понятие относительное: для госбольницы «мрт гкб 31» может быть ценнее, чем «мрт москва».
+- Не гонись за ВЧ «мрт» — там коммерческие гиганты; выигрывай НЧ/СЧ + локальные + информационные.
+
+## 4. Структура лендинга/страницы услуги
+
+```
+H1: {Услуга} в {Клиника}, {город}
+kicker/надзаголовок: {специальность} · {стаж} · {ОМС/ДМС}
+1. Лид 2–4 строки: что, кому, сколько стоит, как записаться  ← ответ на интент
+2. CTA-блок: запись онлайн + телефон (виден без скролла)
+3. «Кому показано» (список)
+4. «Как проходит» (шаги, время, ощущения)
+5. «Подготовка» (что взять/не есть/лекарства)
+6. «Противопоказания и ограничения»
+7. «Результат и что дальше»
+8. «Цены» (таблица, что входит, ОМС/ДМС)
+9. «Врачи» (2–4 карточки со ссылками)
+10. «Отзывы» (реальные, с площадок)
+11. «FAQ» (5–8 вопросов)
+12. «Как записаться» (телефон, форма, адрес, часы)
+13. Экспертный блок: автор, рецензент, дата, источники, дисклеймер
+```
+
+Требования к тексту: ответ в первых 100–150 словах; абзацы 2–4 строки; списки/таблицы; конкретика (цифры,
+оборудование, имена); без «инновационных решений»; без воды ради объёма.
+
+## 5. Структура статьи/блога
+
+```
+H1: {Вопрос/тема} — {уточнение}
+Лид: прямой ответ (2–4 предложения)
+H2: Почему это важно / что это
+H2: Симптомы / признаки (если применимо)
+H2: Причины / факторы риска
+H2: Когда нужно к врачу (красные флаги)
+H2: Диагностика: какие обследования
+H2: Лечение: что делает врач (без назначений «по интернету»)
+H2: Профилактика
+H2: Частые вопросы (FAQ, 5–8)
+Блок эксперта: автор, рецензент, дата, источники, дисклеймер
+Блок перелинковки: 3–5 ссылок на услуги/врачей/смежные статьи
+```
+
+- Статья не заменяет услугу: в конце — естественный переход «записаться к …».
+- Не пиши «лечение» как инструкцию; пиши «как лечат», «что назначает врач», «чего не делать».
+- Не копируй тексты других клиник: перерабатывай факты, добавляй локальную специфику и эксперта.
+
+## 6. Внутренняя перелинковка
+
+- **Хабы** — страницы разделов (`/napravleniya/`, `/uslugi/`, `/vrachi/`, `/blog/`), которые ссылаются на детей
+  и получают ссылки с главной.
+- Схема «статья → услуга → врач»: информационная статья ссылается на услугу, услуга — на врачей и статьи,
+  врачи — на услуги и расписание.
+- 2–6 контекстных ссылок на 1000 слов; анкоры описательные, разные (не «мрт» ×20).
+- Не ссылайся на все страницы со всех — это шум; ссылайся по смыслу.
+- Новые страницы получают 2–5 входящих ссылок сразу (иначе «сироты»).
+- Проверка: краул → список страниц без входящих ссылок; `seo-audit.mjs` умеет считать внутренние ссылки
+  и находить сирот в рамках краула.
+
+## 7. CTA и микрокопирайт
+
+- CTA — глагол + выгода: «Записаться к кардиологу», «Посмотреть цены», «Проложить маршрут».
+- Один главный CTA на экран; телефон и «Записаться» — всегда в шапке.
+- Форма: минимум полей (имя, телефон), явное согласие на ПДн (152-ФЗ), понятная ошибка, состояние загрузки.
+- Микрокопирайт: «Запись подтверждает администратор в течение 15 минут» лучше, чем «Мы вам перезвоним».
+- Не используй ложную срочность, «осталось 2 места», «только сегодня» — это недоверие и риск.
+- Для YMYL CTA не должен конкурировать с «когда срочно к врачу»: при красных флагах — «звоните 103/112».
+
+## 8. Freshness и жизненный цикл контента
+
+| Тип контента | Обновление | Триггер |
+|---|---|---|
+| Цены, расписание, приём | раз в квартал / при изменении | изменился прайс/график |
+| Услуги | раз в 6–12 мес | новое оборудование, методика, врачи |
+| Статьи о здоровье | раз в 6–12 мес | новые клинические рекомендации |
+| Новости/события | после события — итоги | завершилось |
+| Врачи | при изменении данных | новый сертификат, должность |
+
+- Обновляй `dateModified`/`lastReviewed` **только при реальных изменениях**.
+- Устаревшую страницу: обновить, объединить с актуальной (301) или удалить (410) — не оставлять в индексе «труп».
+- «Вечнозелёные» статьи (симптомы, подготовка) обновляй по рекомендациям, а не по дате в календаре.
+
+## 9. Локализация и русский язык
+
+- Пиши по-русски, живым языком; медицинские термины — с пояснением.
+- Единые термины по сайту: «приём» vs «консультация», «отделение» vs «центр» — выбери и держи.
+- Локальные маркеры: район, метро, округ, «госпитализация в Москве», ОМС Москвы, ДМС.
+- Не переводи названия учреждений/должностей вольно; ФИО — в исходном виде.
+- Числа: `1 200` (неразрывный пробел), цены `4 500 ₽`, даты `20.10.2026` (в тексте) и ISO (в разметке).
+- Ё — по стилю проекта (gkb-31.ru — обычно без ё в тексте, но проверяй единообразие).
+- Транслит URL — единая схема (`й→y`, `я→ya`, `ж→zh`), не смешивай `h` и `kh` в разных разделах.
+
+## 10. Контент в эпоху ИИ-ответов (AI Overviews, AI Mode, Нейро)
+
+Google прямо говорит: **особых мер для ИИ-функций не нужно** — нужны индексация, сниппеты разрешены, полезный
+контент и обычные SEO-практики. Из этого следуют практические выводы:
+
+1. **Отвечай прямо и коротко в начале** — ИИ берёт «готовый ответ» из первых абзацев и списков.
+2. **Структурируй**: H2-вопросы, списки, таблицы, шаги — «извлекаемый» контент цитируется чаще.
+3. **Факты и сущности**: имена врачей, оборудование, цифры, даты, адреса — связывай разметкой
+   (`Physician`, `MedicalClinic`, `MedicalWebPage`), чтобы система понимала, кто/что/где.
+4. **Уникальность опыта**: реальные кейсы, локальная специфика, комментарии врачей — ИИ не может это выдумать
+   за вас; «пересказ пересказа» не цитируют.
+5. **Не блокируй** `Google-Extended`/сниппеты, если хочешь попадать в ИИ-ответы; понимай trade-off.
+6. **llms.txt** — Google официально: файл не нужен и на ранжирование не влияет; не трать время.
+7. Массовая генерация ИИ-текстов без редактуры — риск нарушения политики «scaled content abuse».
+
+## 11. Редакционный процесс (чтобы контент был, а не «когда-нибудь»)
+
+1. **План на квартал:** 8–12 страниц (2 услуги, 2 направления, 4–6 статей, 1–2 новости/события).
+2. **Бриф** (§1) → **черновик** автора-врача/копирайтера → **медредактура** (рецензент) → **SEO-редактура**
+   (title/description/H1/H2/FAQ/перелинковка/разметка) → **вёрстка** → **проверка** (гейт) → **публикация** →
+   **мониторинг** (GSC/Вебмастер, 2–4 недели).
+3. Единый чек-лист публикации — `audit-checklist.md`, блок «Контент».
+4. Никакой публикации без: автора, даты, дисклеймера (для медицины), внутренних ссылок, alt.
+
+## 12. Частые ошибки контента (топ-15)
+
+1. Текст «под ключ», а не под интент.
+2. Ответ на запрос — в середине/конце страницы.
+3. Дубль услуги в двух разделах (каннибализация).
+4. Вода: «мы предлагаем широкий спектр», «индивидуальный подход».
+5. Нет цен/сроков/врачей — только «уточняйте».
+6. Нет противопоказаний и «когда к врачу» (YMYL).
+7. Автор «Редакция», дата «сегодня» у всего.
+8. Копипаст с другого медсайта.
+9. 5000 слов без структуры и списков.
+10. FAQ выдуманный, не из спроса.
+11. Анкоры «подробнее/здесь» ×100.
+12. Статья без ссылки на услугу/врача (тупик).
+13. Нет даты обновления при изменении цены.
+14. Обещания излечения и запугивание.
+15. Публикация без проверки на мобильном (таблицы, длинные слова, формы).
+
+## 13. Первоисточники
+
+- Google. Полезный контент: https://developers.google.com/search/docs/essentials/creating-helpful-content
+- Google. Спам-политики (scaled content abuse): https://developers.google.com/search/docs/essentials/spam-policies
+- Google. ИИ-функции и ваш сайт: https://developers.google.com/search/docs/appearance/ai-features
+- Google. Как писать описательные title/сниппеты: https://developers.google.com/search/docs/appearance/title-link
+- Яндекс Вордстат: https://wordstat.yandex.ru
+- Яндекс Вебмастер: https://yandex.ru/support/webmaster/ru/