dsh-desktop-kit 0.0.0-stage → 2.0.0

package/skills/seo/README.md

@@ -0,0 +1,60 @@
+# SEO-скилл (`seo`) — установка и карта
+
+Полноценный скилл «SEO-эксперт» для агента: техническое SEO, on-page, структурированные данные, E-E-A-T/YMYL
+(медицина), контент, стек-рецепты (Laravel/Blade, Bitrix/Aspro, React/Vite, статика), аудит и измерение.
+Правило скилла: **любой веб-артефакт (страница, шаблон, мета, URL, контент) пишется с SEO по умолчанию**.
+
+Актуальность: **04.11.2026** (Google Search Central + Яндекс Вебмастер + schema.org + web.dev).
+Спорные/меняющиеся места в текстах помечены «проверить на актуальной версии».
+
+## Установка
+
+1. Скопировать каталог в скиллы DSH:
+   `projects/seo-skill/` → `%USERPROFILE%\.dsh\skills\seo\`
+   (SKILL.md в корне, `references/`, `assets/` — рядом).
+2. Проверить каталог скиллов: скилл должен появиться как `seo` (frontmatter: `name: seo`,
+   `whenToUse`, `user-invocable: true`).
+3. Агент загружает его через tool `skill` перед любой веб-задачей; глобальный контракт в `~/.dsh/AGENTS.md`
+   §1b требует загружать `seo` для любого веб-артефакта.
+4. Инструмент `assets/scripts/seo-audit.mjs` добавляет qa-toolsmith (task-5) — контракт интерфейса уже
+   зафиксирован в `assets/scripts/README.md`.
+
+## Что внутри
+
+| Файл | Назначение |
+|---|---|
+| `SKILL.md` | контракт «SEO по умолчанию», процесс 8 шагов, матрица по типам страниц, SEO-GATE, антипаттерны, шаблоны title/description, Google vs Яндекс, lite-режим |
+| `references/technical-seo.md` | краулинг/индексация, статусы, robots.txt, sitemap, canonical, дубли, пагинация, фасеты, hreflang, CWV, JS/SPA, лог-анализ, миграции URL, топ-20 ошибок |
+| `references/on-page.md` | title/description/H1–H6, URL, структура страницы услуги, изображения, анкоры, OG/Twitter, крошки, сниппет, примеры «плохо→хорошо» |
+| `references/structured-data.md` | JSON-LD: граф сайта, BreadcrumbList, MedicalWebPage, Physician, MedicalClinic, Service/MedicalProcedure, FAQPage, Article, Event, Product + что устарело в 2026 + валидация |
+| `references/eeat-medical.md` | YMYL: авторство врачей, рецензент, даты, источники, дисклеймеры, лицензия, локальная клиника (NAP, Яндекс Бизнес, 2ГИС, GBP), 152-ФЗ/38-ФЗ, чек-лист YMYL-гейта |
+| `references/stack-recipes.md` | Laravel/Blade (SeoData, meta-компонент, sitemap/robots-роуты, 301, кэш), Bitrix/Aspro (SEO-шаблоны инфоблоков, canonical, 404, редиректы, robots/sitemap, кэш), React/Vite (Astro/Next/SPA), статика, nginx/.htaccess, проверки |
+| `references/content-seo.md` | SEO-бриф, интенты, семантика/кластеры (Вордстат, Москва), структура лендинга и статьи, перелинковка, CTA, freshness, локализация, ИИ-ответы, редакционный процесс |
+| `references/audit-checklist.md` | 107 проверок P0/P1/P2 по 12 областям + **автоматизируемые проверки (seo-audit.mjs)** + шаблоны отчёта + приоритизация |
+| `references/measurement.md` | GSC, Яндекс Вебмастер, GA4/Метрика, KPI, «до/после», UTM, мониторинг/алерты, шаблоны отчётов |
+| `assets/snippets/` | `meta.blade.php`, JSON-LD (организация, клиника, врач, MedicalWebPage, FAQ, крошки), `robots.txt`, `sitemap.xml` + urlset |
+| `assets/README.md` | как пользоваться сниппетами, статусы разметки в 2026, особенности Битрикса |
+| `assets/scripts/README.md` | контракт `seo-audit.mjs`: интерфейс, выходные файлы, схема JSON, список проверок |
+
+## Ключевые правила (краткая версия)
+
+1. Каждая страница: `title`, `description`, `canonical`, `robots`, OG, **один H1**, семантика, JSON-LD, `alt`,
+   внутренние ссылки, читаемый URL — иначе страница не готова.
+2. Интент важнее ключевых слов; один интент = один URL, без каннибализации.
+3. Медицина = YMYL: автор-врач, рецензент, даты, источники, дисклеймер, без обещаний излечения.
+4. SEO-данные — в **исходном HTML** (SSR/SSG), а не после JS.
+5. Любая смена URL — только с 301 + обновлением sitemap и внутренних ссылок.
+6. **Google + Яндекс сразу**: ИКС, регион, Clean-param, Яндекс Бизнес; не оптимизируй под одного.
+7. Проверяемо: Rich Results Test / Schema validator / GSC / Вебмастер / PSI — а не «я добавил meta».
+8. 2026: FAQ rich results отключены (07.05.2026), HowTo удалён, llms.txt Google не использует,
+   AI Overviews/AI Mode учитываются в общем трафике GSC.
+
+## Проверка комплектности
+
+- [x] SKILL.md с frontmatter (`name`, `description`, `whenToUse`, `user-invocable`), 8 шагов, гейт, антипаттерны.
+- [x] 8 файлов в `references/` (technical, on-page, structured-data, eeat-medical, stack-recipes, content-seo,
+      audit-checklist, measurement).
+- [x] 107 проверок с P0/P1/P2 + порог сдачи + шаблон отчёта.
+- [x] Готовые сниппеты и README для assets.
+- [x] Русский рынок (Google + Яндекс) и медицинский YMYL учтены в каждом релевантном файле.
+- [x] Ссылки на первоисточники; спорные данные помечены «проверить».

package/skills/seo/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: seo
+description: "SEO веб-артефакта по умолчанию: страница, шаблон, URL, мета, JSON-LD, контент, аудит — любой веб"
+whenToUse: "Вёрстка, мета-теги, URL и редиректы, миграции, sitemap/robots, JSON-LD, статьи, аудит — грузить до кода, если задача про веб."
+user-invocable: true
+---
+
+# SEO — ядро
+
+> ≈2 000 токенов. Детали — по ссылкам, когда нужны.
+
+## 0. Когда применять
+
+- Страница, шаблон, `<head>`, sitemap, robots, статья, услуга.
+
+## 1. Главное
+
+### 1.1 Контракт
+
+1. **SEO по умолчанию**: мета, `canonical`, `robots`, OG, один `H1`, семантика, `alt`, ссылки, JSON-LD, читаемый URL — иначе страница не готова.
+2. **Интент важнее ключей**: сначала что человек хочет, потом страница.
+3. **Не выдумывать цифры**: пороги — из первоисточников; спорное — «проверить на актуальной версии» + дата.
+4. **YMYL**: медицина — автор-врач, даты, источники, дисклеймер, без обещаний излечения.
+5. **Не ломать существующее**: фиксируй «до»; смена URL = 301 + sitemap + ссылки.
+6. **Доказывать**: `curl`/`view-source`, Rich Results Test, PSI/CWV, фрагмент HTML.
+7. **Мета и контент — в исходном HTML** (SSR/SSG/prerender), не после JS.
+8. **Google + Яндекс**: так, чтобы работало в обоих (`measurement.md` §10).
+9. **Отчёт**: сделано, проверено (чем), что из P0/P1 осталось и почему.
+
+### 1.2 Процесс — 8 шагов (1–3 до кода, 4–7 в коде, 8 после)
+
+1. **Бриф и интент**: кто, что хочет, CTA, тип страницы → `content-seo.md`.
+2. **Семантика**: Вордстат по региону, GSC; 1 кластер = 1 страница; частотность с датой.
+3. **Архитектура**: URL ≤3–4 уровня, ≤3 клика, анкоры 2–6/1000 слов, без сирот → `on-page.md`.
+4. **On-page**: `title` 50–60, `description` 140–160, один `H1`, `alt`, OG → `page-templates.md`.
+5. **Техника**: 200 + indexable, canonical, 301 без цепочек, CWV, миграции → `technical-seo.md`.
+6. **JSON-LD**: типы, FAQ-сниппета нет с 07.05.2026, поля = контент → `structured-data.md`.
+7. **E-E-A-T**: автор-врач, даты, лицензия, источники, дисклеймер, NAP → `eeat-medical.md`.
+8. **Измерение**: GSC + Вебмастер (регион, ИКС), GA4/Метрика, baseline, 2–4/8–12 недель → `measurement.md`.
+
+**Lite-режим** (шаги сжимаются, но не пропускаются): `title` + `description` + `H1` · `canonical` + `index,follow` + OG · `header/main/article/footer`, `lang="ru"` · `alt`, размеры, lazy ниже фолда · 2–4 ссылки + крошки · JSON-LD минимального типа · гейт §3; аудит — `audit-checklist.md` §15.
+
+### 1.3 YMYL-медицина
+
+Автор-врач, рецензент, даты публикации и проверки, источники, дисклеймер, противопоказания, «когда срочно к врачу»; без обещаний излечения, запугивания, назначений «по интернету», выдуманных отзывов, цены ≠ прайс. Блокеры — `eeat-medical.md` §12.
+
+### 1.4 Антипаттерны
+
+keyword stuffing, скрытый текст, doorway, каннибализация, обещания излечения, `noindex` на деньгах, canonical на чужой URL, «мягкие 404», sitemap с 404, одинаковый `title`, lazy на LCP, выдуманные отзывы, миф про `llms.txt`. Разбор — `antipatterns.md`.
+
+## 2. Куда грузить дальше
+
+| Нужно | Файл | ≈токенов | Когда читать |
+|---|---|---|---|
+| Интент, кластеры | `references/content-seo.md` | 5 850 | новая страница |
+| Мета, матрица страниц | `references/page-templates.md` | 2 250 | title/description |
+| Статусы, robots, sitemap, canonical | `references/technical-seo.md` | 8 050 | техправка |
+| Title/H1–H6, URL, анкоры, OG | `references/on-page.md` | 6 400 | вёрстка |
+| JSON-LD: шаблоны, валидация | `references/structured-data.md` | 8 700 | разметка |
+| Авторство, даты, NAP | `references/eeat-medical.md` | 7 100 | медицина |
+| 107 проверок и отчёты | `references/audit-checklist.md` | 7 900 | аудит |
+| GSC, Вебмастер, KPI, UTM | `references/measurement.md` | 7 250 | замеры |
+| Laravel, Bitrix, React, статика | `references/stack-recipes.md` | 10 100 | код стека |
+| Антипаттерны | `references/antipatterns.md` | 2 050 | сомнение |
+
+Готовое — `assets/snippets/`, `assets/scripts/seo-audit.mjs`.
+
+## 3. Гейт перед сдачей
+
+Порог: P0 закрыты; P1 — в отчёт с причиной; 0 ошибок валидаторов.
+
+- [ ] **P0** `title` 50–60 и уникальный; `description` 140–160; один `H1`, H2–H6 по порядку.
+- [ ] **P0** 200, нет `noindex`/robots-запрета, `canonical` абсолютный, URL в `sitemap.xml`.
+- [ ] **P0** JSON-LD валиден и = контент; не сирота, 2–6 контекстных ссылок.
+- [ ] **P0** медицина: автор-врач, даты, источники, дисклеймер, лицензия.
+- [ ] **P1** URL читаемый (смена — 301), OG/`og:image` 1200×630, крошки + `BreadcrumbList`, `alt`/размеры/lazy (LCP — без lazy)/WebP, CWV ≤2,5 с/≤200 мс/≤0,1 или план с датой.
+- [ ] **P2** `lang`/charset/viewport/favicon; нет битых ссылок и цепочек.

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.

package/skills/seo/assets/scripts/README.md

@@ -0,0 +1,179 @@
+# seo-audit — технический SEO-аудитор страницы
+
+CLI-инструмент для проверки технического SEO, структурированных данных и Core Web Vitals одной страницы.
+Работает через уже запущенный headless Chrome по CDP (`http://127.0.0.1:9333`) и общую инфраструктуру
+`tools/design-qa/lib` (fallback-запуск браузера там же).
+
+| | |
+|---|---|
+| Вход | локальный HTML-файл (`file://`) или URL (`http://`/`https://`) |
+| Выход | `seo-audit.json` + `seo-audit.md` (или `<name>-seo-audit.*`) в `--out` (по умолчанию `tmp/qa-artifacts/`) |
+| Коды выхода | `0` — нет critical/serious; `2` — есть critical/serious; `1` — сбой инструмента |
+
+## Требования
+
+- Node.js 24.
+- Chrome с `--remote-debugging-port=9333` (уже запущен в окружении). Если CDP недоступен — auditor
+  поднимет `chrome.exe` из `ms-playwright` с временным профилем (см. `tools/design-qa/lib/browser.mjs`).
+- `playwright-core` берётся из `tools/design-qa/node_modules` (общая QA-инфраструктура).
+  Ставить ничего не нужно.
+- Переопределения: `--cdp <url>` / env `CDP_URL`, путь к браузеру — env `CHROME_PATH`.
+
+## Быстрый старт
+
+```powershell
+cd %USERPROFILE%\Documents\deepseek-harness\default-workspace
+
+# Локальная страница
+node tools/seo-audit/seo-audit.mjs projects/design-kit/pages/hospital.html --name seo-hospital
+
+# Реальный сайт (read-only, 1 страница)
+node tools/seo-audit/seo-audit.mjs https://example.org/ --name seo-service-desk --max-links 80
+
+# JSON в stdout (для автоматизации), логи — в stderr
+node tools/seo-audit/seo-audit.mjs https://example.org/ --json > seo.json
+```
+
+## Опции
+
+| Опция | Описание |
+|---|---|
+| `--out <dir>` | Каталог отчётов (по умолчанию `tmp/qa-artifacts`) |
+| `--name <name>` | Имена файлов `<name>-seo-audit.json` / `<name>-seo-audit.md`; без `--name` — `seo-audit.json` / `seo-audit.md` |
+| `--viewports <list>` | `desktop` (по умолчанию), `mobile`, или `1440x900,390x844` |
+| `--max-links <n>` | Сколько same-origin ссылок проверить на битость (по умолчанию 80, максимум 400) |
+| `--no-links` | Не проверять битые ссылки (быстрее) |
+| `--no-robots` | Не запрашивать `robots.txt` / `sitemap.xml` |
+| `--serve` | Отдать локальную страницу локальным HTTP-сервером (для `<script type="module">`/fetch) |
+| `--cdp <url>` | CDP-эндпоинт (по умолчанию env `CDP_URL` или `http://127.0.0.1:9333`) |
+| `--timeout <ms>` | Таймаут загрузки страницы (по умолчанию 30000) |
+| `--json` | Полный JSON в stdout (логи — в stderr) |
+| `-h, --help` | Справка |
+
+## Что проверяется
+
+### Meta и индексируемость
+- `title`: наличие, длина 30–65 символов, отсутствие дублей `<title>` на странице;
+- `meta description`: наличие, длина 70–160 символов, дубли;
+- `html lang`: наличие и формат;
+- `meta charset` / кодировка;
+- `meta viewport`: наличие `width=device-width`, не блокируется ли зум;
+- `robots` meta и `X-Robots-Tag`: `noindex` → **critical**, `nofollow` → moderate;
+- `link rel="canonical"`: наличие, ровно один, абсолютный, self-referencing;
+- `robots.txt`, `sitemap.xml` (только для http/https): доступность, `Disallow: /` для `*`,
+  наличие URL страницы в sitemap (поддерживается sitemap-index + первый дочерний sitemap).
+
+### Заголовки
+- ровно один непустой `h1` (0 или >1 → serious);
+- порядок `h1 → h2 → h3` без пропуска уровней.
+
+### Open Graph / Twitter
+- `og:title`, `og:description`, `og:image`, `og:url` (отсутствие → moderate);
+- `og:image` абсолютный и не SVG (SVG соцсети не отображают);
+- `twitter:card` (minor).
+
+### JSON-LD schema.org
+- валидность JSON (**critical** при ошибке парсинга), `@context`, `@type`;
+- обязательные поля для типов: `Organization`, `MedicalClinic`/`MedicalOrganization`/`Hospital`/
+  `LocalBusiness` (name + address), `MedicalWebPage`, `WebPage`, `WebSite`, `Physician`, `Article`/
+  `NewsArticle`/`BlogPosting` (headline + author + datePublished), `FAQPage` (mainEntity → Question →
+  acceptedAnswer.text), `BreadcrumbList` (itemListElement → position + name/item), `Product`;
+- поддержка `@graph` и массивов.
+
+### Изображения
+- отсутствие `alt` (важно также для доступности);
+- отсутствие `width`/`height` (риск CLS);
+- `loading="lazy"` ниже первого экрана;
+- доля устаревших форматов (PNG/JPEG/GIF) — рекомендация WebP/AVIF.
+
+### Ссылки
+- пустые анкоры без текста/`aria-label` (moderate);
+- `href="#"`, пустой `href=""`, `javascript:` (moderate/minor);
+- `target="_blank"` без `rel="noopener"` (minor);
+- битые **same-origin** ссылки: HEAD-запрос (при 403/405/501 — GET), `4xx/5xx` и сетевые ошибки →
+  **serious**; внешние ссылки не хаммерятся (только считаются);
+- якоря `#id` без цели на странице (moderate);
+- ссылки на `http://` (minor), mixed content на https (serious).
+
+### hreflang
+- формат (`ru`, `en-US`, `x-default`), абсолютность, дубли, наличие `x-default` (minor).
+
+### Производительность / Core Web Vitals
+- **LCP** через PerformanceObserver: >4 c → critical, >2.5 c → serious;
+- **CLS** через PerformanceObserver: >0.25 → serious, >0.1 → moderate;
+- TTFB, число длинных задач, размер HTML (150 КБ / 600 КБ), число запросов (100),
+  суммарный вес (3 / 6 МБ), размер DOM (800 / 1500 элементов);
+- render-blocking CSS (>4 в `<head>`) и синхронные скрипты в `<head>`;
+- отсутствие gzip/brotli для HTML (только http/https);
+- **INP** в headless-браузере не измеряется (нет взаимодействий) — отчёт явно это указывает;
+  для INP использовать PageSpeed Insights / поле.
+
+Severity: `critical` и `serious` влияют на код выхода (2), `moderate`/`minor` — нет.
+
+## Как читать отчёт
+
+`seo-audit.md` содержит:
+
+1. **Вердикт** и метрики (LCP, CLS, TTFB, HTML, запросов, вес, DOM, HTTP-статус, код выхода).
+2. **Что чинить в первую очередь** — топ-10 с готовыми рекомендациями.
+3. **Сводка по категориям** (critical/serious/moderate/minor по meta, indexing, headings, schema, images, links, performance…).
+4. Разделы: Meta и индексируемость, Заголовки, JSON-LD, Open Graph/Twitter, Изображения, Ссылки,
+   hreflang, Производительность/CWV, Mixed content, robots.txt/sitemap.xml.
+5. Таблица всех замечаний `severity | id | что не так`.
+
+`seo-audit.json` — машиночитаемо: `summary` (counts, verdict, exitCode, metrics),
+`issues[]` (`id`, `severity`, `category`, `help`, `fix`, `nodes`), `pages[]` (сырые данные по каждому
+viewport: meta, headings, images, links, resources, perf), `schema`, `hreflang`, `robots`, `sitemap`,
+`performance`, `meta`, `http`.
+
+## Проверка инструмента на фикстуре
+
+`fixtures/bad-seo.html` — намеренно проблемная страница: нет canonical/OG/JSON-LD, два H1, пропуск h2,
+битый JSON-LD, noindex, картинки без alt, битые/пустые ссылки, http-ссылки, дубли title/description,
+5 render-blocking CSS, блокирующий скрипт.
+
+```powershell
+node tools/seo-audit/seo-audit.mjs tools/seo-audit/fixtures/bad-seo.html --name seo-bad --max-links 20
+# ожидается FAIL (exit 2): ≈2 critical, ≈9–10 serious, ≈10 moderate, ≈5 minor
+```
+
+## Результаты реальных прогонов (2026-11-04)
+
+| страница | вердикт | critical | serious | moderate | minor | LCP | CLS |
+|---|---|---:|---:|---:|---:|---|---|
+| `projects/design-kit/pages/hospital.html` | FAIL | 0 | 1 (canonical) | 2 (OG, JSON-LD) | 2 | 924 мс | 0.003 |
+| `projects/design-kit/pages/dashboard.html` | FAIL | 0 | 1 (canonical) | 2 (OG, JSON-LD) | 2 | 136 мс | 0.001 |
+| `projects/design-kit/showcase.html` | FAIL | 0 | 1 (canonical) | 2 (OG, JSON-LD) | 4 | 984 мс | 0.000 |
+| `https://example.org/` | FAIL | 0 | 3 (canonical, H1 нет, alt у 8 img) | 10 | 6 | 540 мс | 0.004 |
+
+Демо-страницы дизайн-кита на `file://` не имеют canonical/OG/JSON-LD и не являются индексируемыми
+продакшн-страницами — для них это ожидаемые замечания, инструмент показывает их корректно.
+Для example.org найдено: нет `<h1>` на главной, нет canonical и JSON-LD, 8 изображений без alt,
+25 без width/height, 22 ссылки с пустым href, 8 блокирующих скриптов в `<head>`, тяжёлый DOM (3426),
+description 181 символ, `maximum-scale=1` блокирует зум, `og:image` — SVG, sitemap — индекс из 13 файлов.
+
+## Ограничения
+
+- Проверяется **одна страница**, это не краулер: не проверяются дубли между страницами, битые ссылки
+  на другие страницы (только same-origin HEAD по ссылкам текущей страницы), вложенность.
+- Внешние ссылки не запрашиваются (HEAD только same-origin) — чтобы не создавать нагрузку чужим сайтам.
+- LCP/CLS зависят от окружения (headless + CDP, без троттлинга сети/CPU): сравнивать между итерациями
+  в одном окружении, не как абсолютные полевые значения.
+- INP не измеряется (нет пользовательских взаимодействий в headless).
+- `robots.txt`/`sitemap.xml` проверяются только для `http(s)://` (для `file://` — раздел отчёта пуст).
+- Sitemap-index забирает только первый дочерний sitemap (1 доп. запрос), наличие URL в остальных не проверяется.
+- JSON-LD-валидация структурная (поля/типы), без полного schema.org-валидатора и без проверки E-E-A-T/YMYL
+  контента; медицинская тематика требует отдельной экспертной проверки (см. скилл `seo`).
+- Инструмент не заменяет PageSpeed Insights / Search Console (полевые данные, реальные пользователи).
+
+## Состав каталога
+
+```
+tools/seo-audit/
+  seo-audit.mjs            # аудитор
+  fixtures/bad-seo.html    # фикстура с нарушениями
+  README.md                # этот файл
+```
+
+Зависимость: `tools/design-qa/lib/{args,browser}.mjs` и `tools/design-qa/node_modules/playwright-core`
+(единая QA-инфраструктура; при переносе инструмента в другой профиль — переносить вместе с `tools/design-qa`).