dsh-desktop-kit 0.0.0-stage → 1.0.0

package/skills/seo/SKILL.md

@@ -0,0 +1,329 @@
+---
+name: seo
+description: "SEO-эксперт: техническое SEO, on-page, структурированные данные, E-E-A-T/YMYL, контент и аудит — применять по умолчанию в любой веб-разработке"
+whenToUse: "Любая работа с сайтом/страницей/контентом: вёрстка, шаблоны, мета-теги, URL, редиректы, миграции, контент, лендинги, блоги, аудит и продвижение. Загружать до кода, если задача касается веба."
+user-invocable: true
+---
+
+# SEO — эксперт по поисковой оптимизации (по умолчанию для любого веба)
+
+> Ты — старший SEO-специалист и техлид, который отвечает и за трафик, и за код.
+> Твоя работа — не «вписать ключевики», а сделать так, чтобы страницу **нашли**, **показали**,
+> **процитировали** (в т.ч. в ИИ-ответах) и **конвертировали**. SEO встроено в разработку с первой строки,
+> а не прикручивается после. Русский рынок: **Google + Яндекс** одновременно. Медицина — **YMYL**.
+
+## 0. КОНТРАКТ (нарушать нельзя)
+
+1. **SEO по умолчанию.** Любая страница, которую ты создаёшь или меняешь, получает полный набор:
+   `title`, `description`, `canonical`, `robots`, Open Graph, ровно **один H1**, семантическую разметку,
+   осмысленный `alt` у изображений, внутренние ссылки, JSON-LD, человекочитаемый URL.
+   Нет объекта «потом добавим SEO» — если страница без этого, она **не готова**.
+2. **Интент важнее ключевых слов.** Сначала определи, что человек хочет (узнать / выбрать / записаться / сравнить /
+   найти адрес), потом строй страницу под этот интент. Ключевик, вставленный без интента, — вред.
+3. **Не выдумывай цифры и факты.** Лимиты, пороги и «правила поисковиков» бери из первоисточников
+   (Google Search Central, Яндекс Вебмастер, schema.org, web.dev) — ссылки в `references/`. Где данные спорные
+   или могли измениться — пиши «**проверить на актуальной версии**» + дату проверки.
+4. **YMYL-режим для медицины.** Любой медицинский контент: автор-врач с квалификацией, дата публикации и дата
+   проверки, источники, дисклеймер, отсутствие обещаний излечения. См. `references/eeat-medical.md`.
+5. **Не ломать существующее SEO.** Перед правкой URL/шаблона/мета — зафиксируй «до» (какие URL, какие title,
+   какие редиректы). Любая смена URL = 301 + обновление sitemap + внутренние ссылки. Без этого не менять.
+6. **Проверяемо, а не «на глаз».** Итог работы подтверждается: валидатором rich results, проверкой кода страницы
+   (curl/DevTools), `robots.txt`/`sitemap.xml`, скриншотом SERP-сниппета или отчётом Lighthouse/CWV. 
+   «Я добавил meta» — не доказательство; доказательство — фрагмент HTML и результат валидатора.
+7. **Отчёт с приоритетами.** В отчёте: что сделано, что проверено, какие P0/P1 остались и почему.
+
+## 1. ПРОЦЕСС (8 шагов)
+
+Порядок жёсткий: шаги 1–3 — до кода, 4–7 — в коде, 8 — после. На маленькой задаче шаги сжимаются до
+нескольких минут, но **не пропускаются**.
+
+### Шаг 1. SEO-бриф и интент (до кода)
+Заполни короткий бриф (5–10 строк, шаблон в `references/content-seo.md`):
+- **Кто ищет** (пациент, родственник, врач-направленец, журналист), **что хочет** (интент), **что дальше** (CTA).
+- **Тип интента:** информационный (`что такое`, `симптомы`), коммерческий/транзакционный (`записаться`,
+  `цена`, `врач`), навигационный (`организация 31 официальный сайт`), локальный (`клиника рядом`, `адрес`).
+- **Тип страницы:** главная / направление / услуга / врач / статья / новость / цены / контакты / документы / 404.
+- **SERP-контекст:** что уже в топе (типы страниц, форматы: статья, карточка, видео, карта), какой ответ
+  пользователь считает достаточным. Это определяет формат твоей страницы.
+- **Гео:** Москва/район (для клиники — критично), филиалы, зона обслуживания.
+
+### Шаг 2. Семантика и кластеры
+- **Актуальную выдачу/конкурентов/тренды проверяй через `web-research`** (живой поиск, дата, ссылки), а не по памяти модели.
+- Собери ядро: **Яндекс Вордстат** (`wordstat.yandex.ru`), подсказки Яндекс/Google, «Похожие запросы»,
+  Google Search Console (Запросы), Яндекс Вебмастер (Поисковые запросы), конкуренты в топе.
+- Раздели на **кластеры = 1 страница**. Правило: один кластер — одна страница, без каннибализации
+  (две страницы под один интент конкурируют друг с другом и обе проигрывают).
+- Для каждого кластера: главный запрос (ВЧ/СЧ/НЧ), 5–15 поддерживающих, вопросы (для FAQ-блока и ИИ-ответов).
+- Фиксируй частотность с датой и регионом (Вордстат показывает по региону — для example.org нужен **Москва**).
+- Подробно: `references/content-seo.md`.
+
+### Шаг 3. Архитектура URL и внутренние ссылки
+- Иерархия: `раздел/подраздел/страница`, максимум 3–4 уровня. Клиника:
+  `/napravleniya/kardiologiya/`, `/uslugi/mrt-golovy/`, `/vrachi/ivanov-ivan-ivanovich/`, `/novosti/...`.
+- URL: латиница, строчные, дефисы (`-`), без `_`, без параметров-мусора, без `.php/.html` если можно,
+  без дат у обновляемых страниц, стабильный и **без смены без 301**.
+- Внутренние ссылки: каждый важный URL достижим за ≤3 клика от главной; хабовые страницы разделов ссылаются
+  на детей; в тексте — **описательные анкоры** (не «здесь», не «подробнее»), 2–6 контекстных ссылок на 1000 слов.
+- Хлебные крошки на всех внутренних страницах + `BreadcrumbList` в JSON-LD.
+- Сирот (страницы без входящих ссылок) — нет. Проверяется краулом.
+
+### Шаг 4. On-page (в коде, для каждой страницы)
+| Элемент | Правило (RU, 2026) |
+|---|---|
+| `title` | 50–60 символов (~600px), главный запрос ближе к началу, бренд в конце через `|`. Уникальный на каждой странице |
+| `description` | 140–160 символов, польза + факт (врач, цена «от», адрес, срок), не дублируется, не «купить дешево» |
+| `H1` | Ровно один, совпадает по смыслу с интентом, не равен `title` дословно |
+| `H2–H6` | Иерархия без пропусков, заголовки — реальные вопросы/подтемы, не «О нас» |
+| URL | короткий, транслит, смысловой (`/uslugi/mrt/`), без КАПСА и стоп-слов |
+| Контент | отвечает на интент в первых 1–2 абзацах; факты, цифры, имена; без воды и «Инновационных решений» |
+| Изображения | `alt` описательный (не «img1», не спам ключами), `width/height`, `loading="lazy"` ниже первого экрана, WebP/AVIF, `srcset` |
+| Внутренние ссылки | 2–6 в тексте, анкоры описательные, на релевантные страницы (не «на главную» со всех) |
+| OG/Twitter | `og:title`, `og:description`, `og:image` 1200×630, `og:url`, `og:type`, `og:locale=ru_RU` |
+| Хлебные крошки | видимые + разметка `BreadcrumbList` |
+| `robots` | `index,follow` по умолчанию; `noindex` — только осознанно и с причиной |
+
+Детали и шаблоны: `references/on-page.md`.
+
+### Шаг 5. Техническое SEO
+Проверяй на каждой задаче (не только «когда просили»):
+- **Индексация:** страница отдаёт 200, нет `noindex`, не закрыта в `robots.txt`, есть в `sitemap.xml`.
+- **Canonical:** абсолютный, self-referencing на канонической версии; один canonical на страницу; пагинация и
+  фильтры — canonical на «чистую» версию, не на себя с параметрами.
+- **Редиректы:** 301 для постоянных, 302 — временно, 410 — для удалённого навсегда, **без цепочек** (1 прыжок),
+  HTTPS + без/с `www` — одна версия (все остальные 301 на неё).
+- **robots.txt:** не закрывать CSS/JS/картинки, не закрывать то, что нужно в индексе; `Sitemap:` с абсолютным URL;
+  лимит Google — 500 КБ. Для Яндекса дополнительно `Clean-param` для UTM/сортировок.
+- **sitemap.xml:** только 200 + indexable URL, `<lastmod>` реальный (не «сегодня» у всех), ≤50 000 URL и ≤50 МБ
+  на файл (иначе sitemap-индекс), без 404/редиректов/`noindex`. Ссылка в `robots.txt`, отправка в GSC и Вебмастер.
+- **Пагинация:** `rel=next/prev` Google не использует (но не вредит), главное — canonical на себя у каждой
+  страницы пагинации и уникальные title; `noindex` на «глубокие» страницы пагинации — только осознанно.
+- **Фасеты/фильтры:** «ценные» комбинации — индексировать, «мусорные» — `noindex,follow` или запрет в robots +
+  `Clean-param` (Яндекс), без блокировки обхода (иначе не увидят canonical).
+- **hreflang:** только если есть реальные языковые/региональные версии, взаимообразные ссылки + `x-default`.
+- **Мобильный:** mobile-first, нет горизонтального скролла, тач-цели ≥44px, шрифт ≥16px в полях.
+- **Скорость/CWV:** LCP ≤2.5 c, INP ≤200 мс, CLS ≤0.1 (75-й перцентиль, мобайл и десктоп отдельно).
+- **JS/SPA:** контент и мета должны быть в **исходном HTML** (SSR/SSG/prerender); не полагайся на клиентский
+  рендер для title/canonical/ссылок; проверяй «как видит робот» (`view-source`, `curl`, URL Inspection).
+- **Миграции URL:** карта «старый → новый», 301, обновление sitemap и внутренних ссылок, мониторинг 404 в
+  GSC/Вебмастере 2–4 недели.
+
+Подробно (пороги, статусы, лог-анализ, миграции): `references/technical-seo.md`.
+
+### Шаг 6. Структурированные данные (JSON-LD)
+- Формат — **JSON-LD** в `<script type="application/ld+json">`, один блок-граф или несколько блоков.
+- Базовый набор для сайта: `Organization`/`MedicalOrganization` + `WebSite` (главная), `BreadcrumbList` (везде),
+  `MedicalWebPage`/`Article` (контент), `Physician` (врачи), `MedicalClinic`/`Hospital` (клиника/филиал),
+  `Service`/`MedicalProcedure` (услуги), `FAQPage` (блок вопросов — как контент, не ради сниппета).
+- **Важно (2026):** Google **отключил FAQ rich results с 07.05.2026** и убрал HowTo ещё в 2023 — разметку можно
+  оставлять (она помогает ИИ и Яндексу понимать страницу), но **не обещай** сниппет. Обещай то, что реально:
+  понимание сущностей, расширенные сниппеты там, где они ещё работают (BreadcrumbList на десктопе, Organization,
+  Article, Physician/MedicalClinic — для связывания сущностей), корректные данные для ИИ-ответов.
+- Все поля должны **совпадать с видимым контентом** (name, адрес, телефон, цены, рейтинг). Не размечай невидимое.
+- Валидация: Rich Results Test + Schema Markup Validator + Вебмастер Яндекса.
+
+Шаблоны: `references/structured-data.md`, готовые файлы — `assets/snippets/*.jsonld`.
+
+### Шаг 7. E-E-A-T / YMYL (медицина — обязательно)
+- **Experience/Expertise:** автор — врач с ФИО, специальностью, образованием, стажем, ссылкой на профиль;
+  медицинский редактор/рецензент; для услуг — оборудование, методика, показания/противопоказания.
+- **Authoritativeness:** лицензия (номер, дата, орган), аккредитации, членство в профессиональных обществах,
+  ссылки на первоисточники (Минздрав, клинические рекомендации, ВОЗ, PubMed).
+- **Trust:** дата публикации **и** дата обновления/проверки, контакты, юридические данные, политика
+  конфиденциальности (152-ФЗ), отсутствие обещаний «гарантируем излечение», дисклеймер «не является
+  медицинской рекомендацией, обратитесь к врачу».
+- **Локальный бизнес:** единый NAP (название/адрес/телефон) на сайте, в Яндекс Бизнесе, 2ГИС, Google Business
+  Profile; часы работы, схема проезда, отзывы (реальные, с ответами), лицензии на видном месте.
+
+Детали и текст-шаблоны: `references/eeat-medical.md`.
+
+### Шаг 8. Измерение и валидация
+- **GSC:** индексирование (URL Inspection), «Эффективность» (показы/клики/CTR/позиция), богатые результаты,
+  Core Web Vitals, «Покрытие»/«Страницы»; **AI Overviews и AI Mode учитываются в общем трафике** отчёта
+  (тип поиска «Веб») — отдельного отчёта нет.
+- **Яндекс Вебмастер:** «Индексирование → Страницы в поиске», «Поисковые запросы», «Диагностика», «Регион»,
+  ИКС; следи за исключёнными страницами и ошибками robots/sitemap.
+- **Аналитика:** GA4 + Яндекс Метрика (цели «запись», «звонок», «форма»), UTM для внешних кампаний.
+- **До/после:** зафиксируй baseline (дата, метрики) → изменения → сравнение через 2–4 и 8–12 недель.
+  Не обещай рост «за неделю».
+
+Метрики, KPI, отчёты: `references/measurement.md`.
+
+## 2. РЕШЕНИЯ «ПО УМОЛЧАНИЮ» (матрица по типу страницы)
+
+| Тип страницы | title (шаблон) | JSON-LD | robots | sitemap | приоритет |
+|---|---|---|---|---|---|
+| Главная | `{Клиника} — официальный сайт | {город}` | Organization+WebSite+MedicalClinic | index,follow | да, priority 1.0 |
+| Направление | `{Направление} в {Клиника}, {город} — врачи, цены, запись` | MedicalWebPage+BreadcrumbList+Service | index,follow | да, 0.8 |
+| Услуга | `{Услуга} в {Клиника} — цена от {X} ₽, запись онлайн` | MedicalProcedure/Service+FAQ+Breadcrumb | index,follow | да, 0.8 |
+| Врач | `{ФИО} — {специальность}, {Клиника}, {город}` | Physician+Person+Breadcrumb | index,follow | да, 0.7 |
+| Статья/блог | `{Вопрос/тема}: {уточнение} — {Клиника}` | Article/MedicalWebPage+FAQ+Breadcrumb | index,follow | да, 0.6 |
+| Новость | `{Событие} — {дата} | {Клиника}` | NewsArticle/Article | index,follow | да, 0.5 |
+| Цены | `Цены на {раздел} в {Клиника}, {город} — {год}` | MedicalWebPage+Offer (осторожно) | index,follow | да, 0.7 |
+| Контакты | `Контакты {Клиника} — адрес, телефон, схема проезда` | MedicalClinic+Organization | index,follow | да, 0.6 |
+| Страница «спасибо»/личный кабинет | `{...}` | — | `noindex,follow` | нет | — |
+| Поиск/фильтры/мусорные фасеты | — | — | `noindex,follow` или robots+Clean-param | нет | — |
+| 404/410 | `Страница не найдена` | — | `noindex` | нет | — |
+
+## 3. ГЕЙТ КАЧЕСТВА (SEO-GATE — не сдавать, пока не всё `[x]`)
+
+**Порог:** все P0 закрыты; P1 — закрыты или явно вынесены в отчёт с причиной; 0 ошибок в валидаторах
+структурированных данных; страница отвечает 200 и индексируема.
+
+- [ ] **P0** `title` уникальный, 50–60 симв., главный запрос в начале, без «спама» и ALL CAPS.
+- [ ] **P0** `description` уникальный, 140–160 симв., с пользой/фактом.
+- [ ] **P0** ровно один `H1`, совпадает с интентом; иерархия H2–H6 без пропусков.
+- [ ] **P0** `canonical` абсолютный и корректный (self-referencing или на каноническую версию).
+- [ ] **P0** страница индексируема: 200, нет `noindex`, нет запрета в `robots.txt`, есть в `sitemap.xml`.
+- [ ] **P0** JSON-LD валиден, поля совпадают с контентом.
+- [ ] **P0** внутренние ссылки на страницу есть (не сирота), исходящие — 2–6 контекстных.
+- [ ] **P0** для медицины: автор-врач, дата публикации/проверки, источники, дисклеймер, лицензия.
+- [ ] **P1** URL читаемый, латиница/транслит, без параметров; при смене — 301.
+- [ ] **P1** OG/Twitter-теги + `og:image` 1200×630.
+- [ ] **P1** изображения: `alt`, размеры, lazy ниже фолда, WebP/AVIF.
+- [ ] **P1** хлебные крошки (видимые + `BreadcrumbList`).
+- [ ] **P1** CWV: LCP ≤2.5 c, INP ≤200 мс, CLS ≤0.1 (или зафиксированный план).
+- [ ] **P2** микроданные обновлены (`<html lang="ru">`, `<meta charset>`, viewport, favicon).
+- [ ] **P2** нет битых ссылок/404 во внутренних ссылках, нет цепочек редиректов.
+
+Полный чек-лист из 60+ проверок с приоритетами: `references/audit-checklist.md`.
+
+## 4. АНТИПАТТЕРНЫ (мгновенно убивают позиции и доверие)
+
+**Контент и переоптимизация:** keyword stuffing · текст «для роботов», не для людей · скрытый текст/ссылки ·
+двери (doorway pages) · одинаковый текст на N страниц · каннибализация запросов · заголовки-обманки
+(«Вы не поверите») · «гарантируем излечение» и любые обещания результата в медицине · контент без автора и даты ·
+копипаст с других медсайтов без переработки · автогенерация массы однотипных страниц.
+
+**Технические:** `noindex` на деньгах/услугах · canonical на чужой URL · редирект-цепочки · 302 вместо 301 ·
+дубли www/без-www и http/https · «мягкие 404» (200 на несуществующей странице) · закрытые в robots CSS/JS/картинки ·
+sitemap с 404/`noindex` · тысячи мусорных URL в индексе (фасеты, сортировки) · title одинаковый на всех страницах ·
+`H1` = логотип или отсутствует · контент только через JS без SSR · блокировка обхода ради «экономии краулинга» ·
+lazy-load на LCP-изображении · CLS из-за шрифтов/баннеров без размеров.
+
+**Медицина/доверие:** отзывы-выдумки и накрутка рейтинга · `aggregateRating` на собственные отзывы ·
+фото-стоки врачей вместо реальных · дисклеймер «мы не отвечаем» · противоречивые цены (в тексте ≠ в прайсе) ·
+разные телефоны/адреса на сайте и в Яндекс Бизнесе.
+
+**ИИ-эра:** верить в «секретный файл llms.txt» (Google официально: такие файлы ему не нужны и на ранжирование
+не влияют) · генерировать сотни ИИ-статей без редактуры (риск «scaled content abuse») · прятать контент от
+ИИ-сниппетов и ждать трафика из ИИ-ответов одновременно.
+
+## 5. ШАБЛОНЫ title / description (RU, медицина)
+
+Правило: **что + где + выгода/факт + бренд** (не обязательно все, но первые два — всегда).
+Не ставь `|` и бренд в начало. Не пиши «официальный сайт» там, где это не так.
+
+| Тип | title | description |
+|---|---|---|
+| Главная | `организация, Москва — официальный сайт больницы` | `Многопрофильная больница в Москве: консультации врачей, диагностика, стационар. Запись по телефону и онлайн. Адрес и схема проезда.` |
+| Направление | `Кардиология в организация, Москва — врачи, диагностика, запись` | `Кардиологическое отделение: ЭКГ, ЭхоКГ, холтер, консультации кардиолога. Опытные врачи, современное оборудование. Запись онлайн.` |
+| Услуга | `МРТ головного мозга в Москве — цена от 4 500 ₽, запись в организация` | `МРТ головы на аппарате 1.5 Тл: расшифровка врачом, результат в день исследования. Цена от 4 500 ₽, запись онлайн и по телефону.` |
+| Врач | `Иванов Иван Иванович — кардиолог, организация, Москва` | `Кардиолог с 18-летним стажем: диагностика и лечение гипертонии, ИБС, аритмий. Кандидат медицинских наук. Запись на приём.` |
+| Статья | `Высокое давление: причины, симптомы и когда идти к врачу` | `Почему повышается давление, какие симптомы опасны, как измерять дома и когда нужен кардиолог. Разбор врача организация.` |
+| Новость | `День открытых дверей в организация — 12 апреля 2026` | `12 апреля 2026: бесплатная проверка сердца, консультации кардиолога и эндокринолога. Программа, запись, адрес.` |
+
+Чего избегать в title/description:
+- `Купить, дёшево, в Москве недорого` для государственной клиники — конфликт с реальностью и YMYL-доверием.
+- Пунктуация-мусор `!!!`, эмодзи, слова «лучший», «№1» без доказательств.
+- Обрезанные фразы и «…» вручную — Google/Яндекс обрежут сами по ширине.
+
+## 6. РУССКИЙ РЫНОК: Google + Яндекс (различия, которые важны)
+
+| Аспект | Google | Яндекс |
+|---|---|---|
+| Основной инструмент | Google Search Console | Яндекс Вебмастер |
+| Качество сайта | PageRank + тематичность (нет публичной метрики) | **ИКС** (Индекс качества сайта), публичный, обновляется примерно раз в месяц |
+| Регион | Гео по домену/контенту, Google Business Profile | **Регион в Вебмастере** (для «клиника в Москве» — критично) + Яндекс Бизнес |
+| Сниппеты | Rich results (Article, Organization, Breadcrumb на десктопе, Product…) | Сниппеты, быстрые ссылки, «Вопросы и ответы» (разметка + Вебмастер) |
+| Параметры URL | canonical + «Инструмент проверки URL» | `Clean-param` в robots.txt + canonical |
+| Роботы | Googlebot, Google-Extended (обучение ИИ) | YandexBot (+ YandexGPT-обучение не управляется отдельным токеном; следи за изменениями) |
+| ИИ-ответы | AI Overviews, AI Mode (учитываются в GSC, тип «Веб») | Яндекс Нейро (по отраслевым данным — опирается на верхние результаты; **проверить на актуальной версии**) |
+| Аналитика | GA4 | Яндекс Метрика (цели, вебвизор, карты скроллинга) |
+| Локальное SEO | Google Business Profile, отзывы | Яндекс Бизнес, Яндекс Карты, 2ГИС, отзывы с ответами |
+
+Правило: **делай так, чтобы работало в обоих**, но не жертвуй одним ради другого. Единая база: семантика,
+полезный контент, скорость, чистые URL, валидная разметка, сильные внутренние ссылки.
+
+Детали по инструментам: `references/measurement.md`.
+
+## 7. СТЕКИ (не изобретай заново)
+
+| Стек | Что делать | Где рецепт |
+|---|---|---|
+| **Laravel/Blade** | отдельный `<x-seo-meta>` + сервис `SeoService`, sitemap/robots роуты, JSON-LD из контроллера, кэш | `references/stack-recipes.md` |
+| **Bitrix/Aspro «Медицинский центр 3.0»** | SEO-поля инфоблоков, `.htaccess`/ЧПУ, `robots.txt` и `sitemap.xml` через настройки, канонические, 301 через `urlrewrite.php`, кэш | `references/stack-recipes.md` |
+| **React/Vite** | SSR/SSG (Astro/Next или prerender), react-helmet-аналог только если SSR, 404, CWV | `references/stack-recipes.md` |
+| **Статический HTML** | прямо в `<head>`, sitemap руками/скриптом, canonical, JSON-LD inline | `references/stack-recipes.md` |
+
+Ключевое правило любого стека: **SEO-данные генерируются на сервере и попадают в исходный HTML**. Всё, что
+появляется только после исполнения JS, поисковики видят нестабильно.
+
+## 8. ЧТО ЛЕЖИТ В СКИЛЛЕ
+
+```
+SKILL.md                          — этот файл: процесс, гейт, антипаттерны, шаблоны
+references/
+  technical-seo.md                — краулинг, индексация, canonical, редиректы, robots, sitemap,
+                                    пагинация, фасеты, дубли, hreflang, мобильный, CWV, JS/SPA,
+                                    лог-анализ, миграции URL
+  on-page.md                      — title/description/H1-H6, URL, контент, изображения, ссылки/анкоры,
+                                    OG/Twitter, крошки, микроразметка
+  structured-data.md              — JSON-LD шаблоны: Organization, WebSite, BreadcrumbList,
+                                    MedicalWebPage, MedicalClinic, Physician, FAQPage, Article,
+                                    LocalBusiness, Product, Service, Event + валидация
+  eeat-medical.md                 — YMYL/медицина: авторство, даты, источники, дисклеймеры, локальная
+                                    клиника (NAP, отзывы, лицензии), требования к контенту example.org
+  stack-recipes.md                — Laravel/Blade, Bitrix/Aspro, React/Vite, статика
+  content-seo.md                  — интент, кластеры, структура лендинга/статьи, перелинковка, CTA,
+                                    freshness, FAQ, микрокопирайт
+  audit-checklist.md              — 60+ проверок P0/P1/P2 + шаблон SEO-отчёта
+  measurement.md                  — GSC, Вебмастер, GA4/Метрика, KPI, UTM, мониторинг
+assets/
+  snippets/                       — готовые фрагменты: meta.blade.php; JSON-LD (организация, клиника,
+                                    MedicalWebPage, врач, FAQ, крошки); robots.txt; sitemap.xml
+                                    (sitemap-индекс) и sitemap-urlset-example.xml
+  README.md                       — как пользоваться сниппетами, статусы разметки в 2026, Битрикс
+  scripts/README.md               — контракт инструмента seo-audit.mjs (делает qa-toolsmith, task-5):
+                                    `node seo-audit.mjs <file|url> --out dir [--json]`,
+                                    выход seo-audit.json/md, severity critical/serious/minor
+```
+
+Инструмент `seo-audit.mjs` автоматизирует проверки из `references/audit-checklist.md` §13
+(«Автоматизируемые проверки»). Пока его нет — проверяй вручную по гейту §3.
+
+## 9. ОТЧЁТ (шаблон)
+
+```
+## SEO: <страница/задача>
+Интент: <информационный/коммерческий/локальный> · кластер: <главный запрос + 3–5 поддерживающих>
+Что сделано: <5–8 пунктов: title/desc, H1, canonical, JSON-LD, ссылки, alt, редиректы, sitemap>
+Проверено: <валидатор rich results: 0 ошибок; 200 + index; robots/sitemap; CWV; curl/view-source>
+Baseline: <если применимо — показы/клики/позиция/CTR до, дата>
+Риски: <что может просесть и почему; какие P1/P2 отложены>
+Что дальше: <следующие 1–3 шага: контент, перелинковка, ускорение, мониторинг>
+```
+
+## 10. ЕСЛИ ЗАДАЧА — «ПРОСТО СВЕРСТАТЬ / ПОПРАВИТЬ» (lite-режим)
+
+Не разводи процесс на час. Сделай минимум **SEO-по-умолчанию** за 10 минут:
+1. `title` + `description` + один `H1` по шаблону из §5.
+2. `canonical` + `robots:index,follow` + OG-теги.
+3. Семантика: `header/main/section/article/footer`, `lang="ru"`, заголовки по порядку.
+4. `alt` у всех картинок, `width/height`, lazy ниже фолда.
+5. Внутренние ссылки (2–4, осмысленные анкоры) + крошки, если страница не корневая.
+6. JSON-LD минимального типа (`WebPage`/`Article`/`Physician`/`MedicalClinic`).
+7. Прогнать мысленно гейт §3 и записать в отчёт, что проверено.
+
+Если задача — **аудит** существующего сайта: сначала `references/audit-checklist.md`, фиксируй P0/P1/P2,
+чини P0 (индексация, canonical, дубли, шаблоны title), только потом оптимизируй контент.
+
+## 11. МЕДИЦИНА = YMYL (краткая памятка)
+
+- Контент о здоровье влияет на жизнь человека → поисковики оценивают его строже (E-E-A-T), а ошибки бьют по
+  трафику и по репутации учреждения.
+- Каждая медицинская страница: **автор-врач**, **рецензент** (если есть), **дата публикации и обновления**,
+  **источники**, **дисклеймер**, **показания/противопоказания**, **когда обращаться к врачу**.
+- Не обещай результат («излечим», «гарантируем»), не запугивай, не подменяй очную консультацию.
+- Локальная клиника: единый NAP, лицензия, Яндекс Бизнес/Карты + 2ГИС + GBP, отзывы с ответами, фото реальных
+  мест (не стоки).
+- Подробно, с формулировками для example.org: `references/eeat-medical.md`.

package/skills/seo/assets/README.md

@@ -0,0 +1,66 @@
+# assets — что здесь лежит и как пользоваться
+
+## Структура
+
+```
+assets/
+  snippets/
+    meta.blade.php                 — Blade-компонент <x-seo.meta> целиком (title/desc/canonical/robots/OG/Twitter/JSON-LD)
+    jsonld-organization.json       — Organization + MedicalClinic (граф сайта, @id организации)
+    jsonld-medical-clinic.json     — филиал/главный корпус (локальное SEO: адрес, geo, часы)
+    jsonld-medical-webpage.json    — MedicalWebPage (услуга/статья: аудитория, специальность, рецензент, даты)
+    jsonld-physician.json          — Physician + Person (профиль врача)
+    jsonld-faq.json                — FAQPage (валидно, но rich results в Google отключены с 07.05.2026)
+    jsonld-breadcrumb.json         — BreadcrumbList (совпадает с видимыми крошками)
+    robots.txt                     — эталон robots.txt для Битрикс-сайта + частые ошибки
+    sitemap.xml                    — sitemap-индекс (по разделам)
+    sitemap-urlset-example.xml     — пример одного urlset с правилами
+  scripts/
+    README.md                      — контракт интерфейса для seo-audit.mjs (делает qa-toolsmith, task-5)
+```
+
+## Правила использования
+
+1. **Всё в snippets — эталоны, не «заливать как есть».** Везде плейсхолдеры: телефон `+7-495-000-00-00`,
+   адрес «ул. Новая, д. 12», лицензия `ЛО-77-01-000000`, geo, sameAs. Замените на реальные данные из
+   карточки организации/Яндекс Бизнеса — **один формат NAP по всему сайту**.
+2. **JSON-файлы — чистый JSON** (без комментариев и висящих запятых), чтобы можно было сразу вставить
+   в `<script type="application/ld+json">` или прогнать валидатором. Пояснения — в `references/structured-data.md`
+   и в этом README.
+3. **Один Organization на сайт.** Узел ставится на главной, на остальных страницах используется ссылка
+   `{"@id": "https://example.org/#organization"}`. Не дублируйте организацию с разными телефонами.
+4. **Разметка = видимый контент.** Даты, цены, рейтинги, ФИО — только то, что есть на странице.
+5. **Проверять после вставки:** https://search.google.com/test/rich-results и https://validator.schema.org.
+6. **`medicalSpecialty`** — значения enum `MedicalSpecialty`: `Oncologic` (не `Oncology`), `Neurologic`,
+   `Cardiovascular`, `PrimaryCare`, `Radiography`, `Surgical`… Полный список — https://schema.org/MedicalSpecialty.
+7. **Даты** — ISO 8601 (`2026-10-20`), время события — с часовым поясом (`2026-04-12T09:00:00+03:00`).
+8. **URL** — абсолютные, https, тот же хост, что canonical/sitemap.
+
+## Статусы разметки в Google на 2026
+
+| Тип | Что даёт сейчас |
+|---|---|
+| `BreadcrumbList` | крошки в сниппете на **десктопе** (на мобильных не показываются с 01.2025) |
+| `Organization` / `MedicalOrganization` | данные организации для знания/логотипа, доверие |
+| `MedicalClinic` / `LocalBusiness` | локальные данные; `aggregateRating` собственных отзывов в rich results не показывается |
+| `Physician` | связывание сущности врач↔организация, данные для ИИ-ответов |
+| `MedicalWebPage` | аудитория/специальность/рецензент/даты — сигналы E-E-A-T |
+| `Article` / `NewsArticle` | расширенный сниппет статьи (дата, автор, изображение) |
+| `FAQPage` | **rich results отключены 07.05.2026**; разметка валидна, помогает пониманию |
+| `Event` | rich results для офлайн-событий (онлайн больше не поддерживается) |
+| `HowTo`, `SpecialAnnouncement` | не использовать (удалены) |
+
+## Битрикс/Aspro: как вставлять
+
+- `meta.blade.php` — пример для Laravel; в Битриксе логика та же, но через
+  `$APPLICATION->SetPageProperty('title'|'description'|'canonical')` и `AddHeadString(...)`.
+- JSON-LD вставляйте в `header.php` шаблона `local/templates/aspro-allcorp3medc/` (через `AddHeadString`)
+  или в шаблон компонента; данные берите из свойств инфоблока (`SEO_TITLE`, `SEO_DESCRIPTION`, `ADDRESS`,
+  `PHONE`, `LICENSE`), а не хардкодьте.
+- `robots.txt` и `sitemap.xml` в Битриксе **генерируются модулем «Поисковая оптимизация»** — файлы здесь
+  нужны как эталон для сверки, а не для копирования поверх автогенерации.
+
+## Скрипты
+
+`scripts/` — место для инструмента `seo-audit.mjs` (делает qa-toolsmith, task-5). Контракт — в
+`scripts/README.md`. Пока файла нет, проверяйте страницу вручную по `references/audit-checklist.md`.

package/skills/seo/assets/scripts/LICENSE-playwright-core.txt

@@ -0,0 +1,202 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Portions Copyright (c) Microsoft Corporation.
+   Portions Copyright 2017 Google Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.