dsh-desktop-kit 0.0.0-stage → 2.0.0

package/skills/seo/references/on-page.md

@@ -0,0 +1,214 @@
+> Часть навыка seo. ≈6 400 токенов. Читать, когда: верстаешь страницу — title/description/H1–H6, URL, контент, изображения, анкоры, OG, крошки, управление сниппетом.
+
+# On-page SEO — как писать и верстать страницу
+
+> On-page решает, **поймут ли поисковик и человек, о чём страница, и кликнут ли по сниппету**.
+> Здесь — правила с числами и примерами на русском, для медицины. Проверено 04.11.2026.
+
+## 1. `title` — главный сигнал и главный текст сниппета
+
+**Формат:** `{что} + {где/уточнение} + {выгода/факт} | {бренд}`
+**Длина:** 50–60 символов (~580–600 px на десктопе). Google **сам переписывает** title, если тот не описывает
+страницу или переспамлен; поэтому title должен быть точным описанием, а не набором ключей.
+
+Правила:
+- Уникальный на каждой странице. Шаблон «{Название} — организация» на 500 страницах = дубли.
+- Главный запрос — в начале (`МРТ головного мозга в Москве …`, а не `В организация можно сделать МРТ головного мозга`).
+- Бренд — в конец. На главной бренд может быть в начале (навигационный интент).
+- Не дублируй `H1` дословно; title может быть «продающим», H1 — «описывающим».
+- Без `!!!`, эмодзи, CAPS, «лучший №1» без доказательств.
+- Не пиши «официальный сайт», если это не официальный сайт организации (вводит в заблуждение).
+- Язык и алфавит — как у контента (русский, кириллица). Смешивать «Moscow» и «Москва» без причины — плохо.
+- Год (`2026`) ставь только если контент действительно актуализирован в этом году и требует даты (цены, приём).
+
+Проверка ширины (в DevTools или эмуляторе SERP):
+`document.querySelector('title').textContent.length` — символы; точная ширина зависит от букв (Ш/Ж шире, i/л уже).
+
+## 2. `description`
+
+**Длина:** 140–160 символов (~920 px).
+**Не влияет на позиции напрямую**, но влияет на CTR — а CTR влияет на поведение и клики.
+- Пиши как мини-объявление: что на странице + факт/польза + призыв.
+- Уникальный; не набор ключей; не «Читайте на сайте».
+- Google может переписать description (взять из текста) — значит первые абзацы тоже должны быть «сниппетными»:
+  конкретные ответы, цифры, имена.
+- В медицине: укажи специальность/стаж, цену «от», время приёма, адрес — это то, что повышает CTR.
+
+## 3. Заголовки H1–H6
+
+- **Ровно один `H1`** на странице. `H1` ≠ логотип, не «Добро пожаловать», не пустой.
+- `H1` отражает главный интент: «МРТ головного мозга в организация», «Кардиология: врачи и диагностика».
+- Иерархия без пропусков: H1 → H2 → H3. Не прыгай H2 → H4 «ради размера шрифта» (размер — CSS).
+- H2/H3 — реальные подтемы и вопросы: «Показания», «Как проходит», «Противопоказания», «Сколько стоит»,
+  «Как записаться». Это же — заготовки для FAQ-блока и ИИ-ответов.
+- Не оборачивай в заголовки целые абзацы и не делай заголовком «Наши преимущества» из 5 пунктов без контента.
+- Заголовки не должны быть «спрятанными» (display:none) — скрытый текст = риск.
+
+## 4. URL
+
+Правила:
+- **Иерархия:** `раздел/подраздел/страница`, максимум 3–4 уровня. Клиника: `/napravleniya/kardiologiya/`,
+  `/uslugi/mrt-golovy/`, `/vrachi/ivanov-ivan-ivanovich/`, `/novosti/...`.
+- **Латиница + транслит**, строчные буквы, дефисы между словами. Google прямо рекомендует `-`, а не `_`
+  (уточнено в документации Google в октябре 2026).
+- Без стоп-слов: `/uslugi/mrt/`, а не `/uslugi/mrt-uslugi-v-moskve-luchshaya-klinika/`.
+- Без `.html/.php`, если это не требование стека; без `index.php` в каноническом URL.
+- Без дат у обновляемых страниц (`/blog/vysokoe-davlenie/`, не `/2024/03/12/vysokoe-davlenie/`).
+- Без ID, если можно: `/vrachi/ivanov-ivan/`, не `/vrachi/?ID=1234`.
+- Без параметров в каноническом URL; UTM/сортировки — через `Clean-param`/canonical.
+- Транслит: используй устойчивую схему (`й→y`, `я→ya`, `ж→zh`, `х→h` или `kh` — главное, единообразно).
+  Не переводи имена врачей «на английский» (`Ivanov`, не `Ivan-off`).
+- Смена URL — **только с 301** и обновлением внутренних ссылок/sitemap (см. `technical-seo.md` §12).
+
+## 5. Контент, который ранжируется
+
+### Структура страницы услуги (эталон)
+1. `H1` + первый абзац-ответ: что это, для кого, где, сколько стоит/как записаться (2–4 строки).
+2. Блок «Кому показано» / «Показания» — список.
+3. «Как проходит» — по шагам (для медицинских процедур обязательно).
+4. «Противопоказания и ограничения» — честно, со ссылкой «проконсультируйтесь с врачом».
+5. «Подготовка» — практическая польза (часто ищут отдельно).
+6. «Цены» — таблица/список, цена «от», что входит.
+7. «Врачи» — 2–4 карточки со ссылками на профили.
+8. «FAQ» — 5–8 реальных вопросов (из Вордстата/подсказок/GSC).
+9. «Как записаться» — телефон, онлайн-форма, адрес, часы.
+10. Экспертный блок: кто проверил текст, дата обновления, источники.
+
+### Требования к тексту
+- Отвечай на интент в **первых 100–150 словах** — и человек, и ИИ-ответы берут начало.
+- Конкретика: цифры, сроки, имена, оборудование, цены. «Современное оборудование» — вода.
+- Один кластер = одна страница. Не склеивай «МРТ головы» и «МРТ позвоночника» в одну гигантскую.
+- Абзацы 2–4 строки, списки, таблицы, подзаголовки — читаемость и «извлекаемость» для ИИ.
+- Уникальность: не копируй тексты с других медсайтов; перерабатывай в факты + местную специфику.
+- Объём: не «минимум 3000 слов», а «достаточно, чтобы полно ответить». Ориентир: услуга 600–1500 слов,
+  статья 800–2000, карточка врача 300–700. **Не добивай объём водой.**
+- E-E-A-T: автор, рецензент, дата, источники — см. `eeat-medical.md`.
+- Не обещай результат лечения; используй «помогает диагностировать», «применяется при», «врач подберёт».
+
+### Свежесть (freshness)
+- Обновляй даты только при реальном изменении контента; «подмена даты» без правок — обман.
+- Цены/расписание/приём — пересматривать минимум раз в квартал.
+- Статьи — раз в 6–12 месяцев проверять актуальность (клинические рекомендации меняются).
+- Устаревшую страницу — обновить или 301 на актуальную, не оставлять «мертвой» в индексе.
+
+## 6. Изображения
+
+| Параметр | Правило |
+|---|---|
+| `alt` | описывает содержимое, 3–12 слов. `alt="МРТ-аппарат 1.5 Тл в кабинете организация"`, не `alt="мрт москва купить"` |
+| Декоративные | `alt=""` (пустой), не мусорить ключами |
+| Размеры | всегда `width`/`height` или `aspect-ratio` (CLS) |
+| Формат | WebP/AVIF, JPEG/PNG как фолбэк; SVG для иконок |
+| Вес | ≤ 150–200 КБ для контентных, `srcset` для адаптива |
+| Lazy | `loading="lazy"` **ниже первого экрана**; LCP-картинка — без lazy, с `fetchpriority="high"` |
+| Имена файлов | латиница, описательно: `mrt-golovnogo-mozga-service-desk.webp` |
+| Текст на картинке | не заменяет текст страницы (поисковик читает плохо) |
+| Лицензия | только свои/лицензированные фото; стоки врачей вместо реальных — минус доверию |
+
+## 7. Внутренние ссылки и анкоры
+
+- Каждая страница получает **входящие** ссылки: из хаба раздела, из смежных услуг, из статей, из крошек.
+- Каждый важный URL достижим за **≤3 клика** от главной; хабы разделов ссылаются на своих детей.
+- Исходящие из текста: **2–6** на страницу (1000 слов), анкоры описательные: «записаться к кардиологу»,
+  «цены на МРТ», а не «здесь», «подробнее», «читать».
+- Не ставь все ссылки в первый абзац и не превращай абзац в список ссылок.
+- Ссылки на важные страницы — с более важных страниц (с главной, из хаба).
+- Не ссылайся на `noindex`-страницы ради «веса» — бесполезно.
+- `nofollow` внутри сайта — только для служебных/рекламных; не закрывай им нормальную навигацию.
+- Проверяй битые ссылки (`seo-audit.mjs` / краул), они бьют и по поведению, и по обходу.
+
+## 8. Open Graph и Twitter Cards
+
+```html
+<meta property="og:type" content="website">                 <!-- article для статей/новостей -->
+<meta property="og:site_name" content="организация">
+<meta property="og:locale" content="ru_RU">
+<meta property="og:title" content="МРТ головного мозга в организация, Москва">
+<meta property="og:description" content="Цена от 4 500 ₽, результат в день исследования, расшифровка врачом.">
+<meta property="og:url" content="https://example.org/uslugi/mrt-golovy/">
+<meta property="og:image" content="https://example.org/upload/og/mrt-golovy-1200x630.jpg">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:image:alt" content="МРТ головного мозга, аппарат в клинике">
+<meta name="twitter:card" content="summary_large_image">
+```
+
+Правила:
+- `og:image` — 1200×630 (1.91:1), реальное фото/инфографика, не логотип; абсолютный URL.
+- `og:url` = canonical URL.
+- Google использует `og:title` как один из источников title для сниппета — держи его согласованным с `<title>`.
+- Telegram/WhatsApp/ВК берут OG — это важный канал для клиники (пересылка страниц врачами/пациентами).
+
+## 9. Хлебные крошки
+
+- Видимые крошки на всех страницах, кроме главной: `Главная → Услуги → МРТ → МРТ головы`.
+- Разметка `BreadcrumbList` (JSON-LD) — дублирует видимую навигацию, последний элемент без ссылки.
+- Google показывает крошки **только на десктопе** (с января 2025 мобильные крошки в сниппете не выводятся) —
+  но разметку всё равно делай: она помогает понимать структуру и Яндексу.
+- Крошки и URL-структура должны совпадать (не «Главная → Лечение → МРТ», если URL `/uslugi/mrt/`).
+
+## 10. Микроразметка на странице (минимум)
+
+| Элемент | Где | Обязательные поля |
+|---|---|---|
+| `BreadcrumbList` | все внутренние | `itemListElement[].position/name/item` |
+| `WebPage` / `MedicalWebPage` | контентные | `name`, `url`, `inLanguage`, `about`, `datePublished`, `dateModified`, `lastReviewed`, `reviewedBy` |
+| `Organization` / `MedicalOrganization` | главная | `name`, `url`, `logo`, `address`, `telephone`, `sameAs` |
+| `Physician` | профиль врача | `name`, `medicalSpecialty`, `jobTitle`, `worksFor`, `alumniOf`, `url`, `image` |
+| `Service` / `MedicalProcedure` | услуга | `name`, `serviceType`, `provider`, `areaServed`, `offers` (если цена публичная) |
+| `Article` / `NewsArticle` | статьи/новости | `headline`, `author` (Person), `datePublished`, `dateModified`, `image`, `publisher` |
+| `FAQPage` | блок вопросов | `mainEntity[].name`, `acceptedAnswer.text` (с 07.05.2026 Google **не показывает** FAQ
+  rich results — разметка остаётся полезной для понимания, но сниппет не обещай) |
+
+Все поля должны совпадать с видимым контентом. Не размечай рейтинги/цены, которых нет на странице.
+Шаблоны: `structured-data.md` и `assets/snippets/`.
+
+## 11. Сниппет: как выглядит и как управлять
+
+Что собирает Google/Яндекс в сниппет: title (или его перепев), description (или фрагмент текста),
+URL (крошки/путь), доп. элементы (звёзды рейтинга, дата, цена, «быстрые ссылки»).
+
+Управление:
+- `title`/`description` — базово.
+- Текст в первых абзацах — то, из чего вырежется фрагмент, если description перепишут.
+- `noindex` — не использовать для «управления сниппетом».
+- `nosnippet`, `max-snippet`, `data-nosnippet` — только если реально нужно скрыть фрагмент
+  (например, платный контент в статье); для клиники почти всегда вредно.
+- «Быстрые ссылки» (Яндекс) и «Sitelinks» (Google) формируются автоматически — влияй структурой навигации
+  и понятными заголовками разделов.
+
+## 12. Чек-лист on-page (10 пунктов, проверяй на каждой странице)
+
+- [ ] `title` уникальный, 50–60 симв., интент в начале, бренд в конце.
+- [ ] `description` уникальный, 140–160 симв., с фактом/пользой.
+- [ ] Один `H1`, совпадает с интентом; H2–H6 по иерархии.
+- [ ] URL читаемый, латиница, дефисы, без параметров.
+- [ ] Первые 100–150 слов отвечают на запрос.
+- [ ] Блоки «показания/как проходит/противопоказания/цены/FAQ/как записаться» (для услуг).
+- [ ] Изображения: `alt`, `width/height`, WebP/AVIF, lazy ниже фолда, LCP без lazy.
+- [ ] 2–6 внутренних ссылок с описательными анкорами + входящие ссылки есть.
+- [ ] OG/Twitter + `og:image` 1200×630.
+- [ ] Крошки + JSON-LD, поля совпадают с контентом.
+
+## 13. Примеры «плохо → хорошо»
+
+| Плохо | Хорошо |
+|---|---|
+| `title` = «Главная» | `организация, Москва — официальный сайт больницы` |
+| `title` = «Услуги, цены, врачи, запись, Москва, клиника, МРТ, КТ, УЗИ» | `МРТ головного мозга в Москве — цена от 4 500 ₽ | организация` |
+| `H1` = «Добро пожаловать на наш сайт!» | `H1` = «Кардиология: врачи, диагностика и лечение в организация» |
+| `alt` = «картинка1» / `alt` = «мрт москва дешево» | `alt` = «Кабинет МРТ в организация: аппарат 1.5 Тл» |
+| URL `/index.php?page=uslugi&id=42` | `/uslugi/mrt-golovy/` |
+| Анкор «Подробнее» ×20 | «записаться к кардиологу», «цены на МРТ», «подготовка к МРТ» |
+| «Мы гарантируем полное излечение» | «Врач подберёт схему лечения по результатам обследования» |
+| Текст 5000 слов «обо всём» | 900 слов строго по интенту + FAQ + цены |
+
+## 14. Первоисточники
+
+- Как формируются title-ссылки: https://developers.google.com/search/docs/appearance/title-link
+- Как формируются сниппеты: https://developers.google.com/search/docs/appearance/snippet
+- URL-структура (включая дефисы vs подчёркивания): https://developers.google.com/search/docs/crawling-indexing/url-structure
+- Изображения: https://developers.google.com/search/docs/appearance/google-images
+- Structured data (общее): https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data
+- Спам-политики (переспам, скрытый текст): https://developers.google.com/search/docs/essentials/spam-policies
+- Обновления документации: https://developers.google.com/search/updates

package/skills/seo/references/page-templates.md

@@ -0,0 +1,56 @@
+> Часть навыка seo. ≈2 250 токенов. Читать, когда: пишешь title/description, проектируешь новую страницу или решаешь, что ставить в JSON-LD/robots/sitemap для конкретного типа страницы.
+
+# Шаблоны по типам страниц: мета, разметка, индексация
+
+> Готовые решения «по умолчанию»: не изобретай title и разметку заново для каждой страницы.
+> Правила самих элементов — `on-page.md`; шаблоны JSON-LD — `structured-data.md`. Проверено 04.11.2026.
+
+## 1. Матрица по типу страницы
+
+| Тип страницы | `title` (шаблон) | JSON-LD | `robots` | sitemap | priority |
+|---|---|---|---|---|---|
+| Главная | `{Клиника} — официальный сайт | {город}` | Organization+WebSite+MedicalClinic | index,follow | да | 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 |
+| Документы/лицензии | `Лицензии и документы {Клиника} — {город}` | MedicalOrganization | index,follow | да | 0.4 |
+| Спасибо / личный кабинет | `{...}` | — | `noindex,follow` | нет | — |
+| Поиск / фильтры / мусорные фасеты | — | — | `noindex,follow` или robots+`Clean-param` | нет | — |
+| 404 / 410 | `Страница не найдена` | — | `noindex` | нет | — |
+
+Оговорки:
+- **`priority` и `changefreq` — подсказка**, а не рычаг: Google их игнорирует, Яндекс учитывает слабо. Ставь для
+  порядка в карте, не «оптимизируй» ими (`technical-seo.md` §4).
+- «Цены» с `Offer` — только если цены публичные, актуальные и совпадают с прайсом на странице.
+- «Документы/лицензии» — страница доверия: номер, дата, орган выдачи, ссылка на реестр Росздравнадзора
+  (`eeat-medical.md` §3).
+- Один кластер = одна страница: если под один интент уже есть страница, не создавай вторую (каннибализация).
+- Тип страницы определяет блоки контента: услуга/направление/статья — `content-seo.md` §4–5.
+
+## 2. Шаблоны `title` / `description` (RU, медицина)
+
+Правило: **что + где + выгода/факт + бренд** (не обязательно все, но первые два — всегда).
+`|` и бренд — не в начало. «Официальный сайт» — только если это действительно официальный сайт организации.
+
+| Тип | `title` | `description` |
+|---|---|---|
+| Главная | `организация, Москва — официальный сайт больницы` | `Многопрофильная больница в Москве: консультации врачей, диагностика, стационар. Запись по телефону и онлайн. Адрес и схема проезда.` |
+| Направление | `Кардиология в организация, Москва — врачи, диагностика, запись` | `Кардиологическое отделение: ЭКГ, ЭхоКГ, холтер, консультации кардиолога. Опытные врачи, современное оборудование. Запись онлайн.` |
+| Услуга | `МРТ головного мозга в Москве — цена от 4 500 ₽, запись в организация` | `МРТ головы на аппарате 1.5 Тл: расшифровка врачом, результат в день исследования. Цена от 4 500 ₽, запись онлайн и по телефону.` |
+| Врач | `Иванов Иван Иванович — кардиолог, организация, Москва` | `Кардиолог с 18-летним стажем: диагностика и лечение гипертонии, ИБС, аритмий. Кандидат медицинских наук. Запись на приём.` |
+| Статья | `Высокое давление: причины, симптомы и когда идти к врачу` | `Почему повышается давление, какие симптомы опасны, как измерять дома и когда нужен кардиолог. Разбор врача организация.` |
+| Новость | `День открытых дверей в организация — 12 апреля 2026` | `12 апреля 2026: бесплатная проверка сердца, консультации кардиолога и эндокринолога. Программа, запись, адрес.` |
+
+## 3. Чего избегать в `title` / `description`
+
+- `Купить, дёшево, в Москве недорого` для государственной клиники — конфликт с реальностью и YMYL-доверием.
+- Пунктуация-мусор `!!!`, эмодзи, слова «лучший», «№1» без доказательств.
+- Обрезанные фразы и «…» вручную — Google/Яндекс обрежут сами по ширине.
+- Дубли: один и тот же шаблон на сотнях страниц = дубли и потеря релевантности (`technical-seo.md` §6).
+- `description` «Читайте на сайте», набор ключей без пользы, обещания результата лечения.
+
+Детали и примеры «плохо → хорошо»: `on-page.md` §1–2, §13.