Imported from JHamidun/claude-code-config-pack (
plugins/seo-geo/skills/schema-markup-ru/SKILL.md). Install upstream withnpx skills add JHamidun/claude-code-config-pack --skill schema-markup-ru. Copyright stays with the author.
Микроразметка Schema.org / JSON-LD (RU)
Реализация структурированных данных schema.org на своих сайтах, чтобы поисковики (Яндекс, Google) лучше понимали контент и показывали расширенные сниппеты, а AI-поверхности (Яндекс.Нейро, Alice, GigaChat) точнее цитировали. Порт schema из marketingskills: вокабуляр schema.org международный, адаптированы примеры под реальные сущности (YourFirstName, академия, воркшоп, news, блог) и заметка про Яндекс.
Перед началом прочитай ~/.claude/business-context.md — раздел «Продукт» (какие сущности вообще размечаем: организация, персона, курс, услуга, товар) и раздел «Цены» (суммы и URL страниц). Файла нет — заведи из ~/.claude/templates/business-context.md.
Здесь последствие жёстче обычного: разметка обязана совпадать с тем, что видно на странице. Выдуманная цена или несуществующий рейтинг в JSON-LD — это не «неточность», а повод для санкций поисковика. Чего не знаешь — помечай [TODO] и уточняй, а не подставляй правдоподобное.
AEO/GEO связка: JSON-LD — один из сильнейших сигналов для попадания в AI-ответы. После разметки сверяйся с seo-machine-ru → skills/seo-machine-ru/references/aeo-geo.md (цитируемость в Яндекс.Нейро/Alice/GigaChat/ChatGPT/Perplexity).
Принципы
- Точность прежде всего. Разметка обязана соответствовать видимому контенту. Не размечать то, чего нет на странице. Обновлять при изменении контента.
- Используй JSON-LD. Рекомендуемый формат (и Google, и Яндекс). Скрипт
<script type="application/ld+json">в<head>или конце<body>. - Только то, что поддерживается. Без спам-тактик. Проверять требования к rich-результатам.
- Валидируй всё. Тест перед деплоем, мониторинг в Вебмастере.
Заметка про Яндекс (важно для RU-рынка)
- Яндекс читает JSON-LD и микроформаты; расширенные сниппеты в выдаче формируются по разметке (товары, организации, FAQ, хлебные крошки, события).
- Проверка: Яндекс.Вебмастер → Инструменты → Валидатор микроразметки (а не только Google Rich Results Test). Дёргать через скилл
yandex(Вебмастер) либо вручную. - Для бизнеса/локалки — карточка в Яндекс.Бизнес (отдельно от JSON-LD), но
Organization/Personвсё равно ставим на сайт. - AI-цитируемость: чёткий
Person(YourFirstName как эксперт),Organization,FAQPage,Courseпомогают Яндекс.Нейро/GigaChat понять, кто автор и что за продукт.
Типы под свои сайты
| Тип | Где ставить | Обязательные поля |
|---|---|---|
| Organization | your-domain.com (главная/обо мне) | name, url |
| WebSite (+SearchAction) | главная / news (поиск по сайту) | name, url |
| Person | страница «Обо мне» (YourFirstName как эксперт) | name |
| Course | academy.your-domain.com и страницы треков | name, description, provider |
| Article | блог, статьи на /media, новости news | headline, image, datePublished, author |
| FAQPage | лендинги услуг/воркшопа/academy с FAQ | mainEntity (Q&A) |
| Event | воркшоп, конференция, вебинар | name, startDate, location |
| BreadcrumbList | любая страница с навигацией/крошками | itemListElement |
Полные JSON-LD примеры под каждую сущность — references/schema-examples.md.
Объединение типов на странице (@graph)
Несколько типов на одной странице — через @graph:
{ "@context": "https://schema.org", "@graph": [
{ "@type": "Organization", "@id": "https://your-domain.com/#org", "...": "..." },
{ "@type": "Person", "@id": "https://your-domain.com/#user", "...": "..." },
{ "@type": "BreadcrumbList", "...": "..." }
]}Валидация и тестирование
- Яндекс.Вебмастер — валидатор микроразметки + раздел «Структурированные данные» (через
yandex). - Google Rich Results Test — search.google.com/test/rich-results.
- Schema.org Validator — validator.schema.org.
Типичные ошибки: нет обязательных полей; даты не в ISO 8601; URL не абсолютные; значения enum неточные (https://schema.org/InStock); разметка не совпадает с видимым контентом.
Реализация под свой стек
- Tilda (your-domain.com, лендинги): JSON-LD вставляется в блок T123 (custom HTML) или в настройки страницы (head). Деплой и публикация — через скилл
tilda. Учти граблины T123 (scope, лимит кода) — см.tilda. - Свой фронтенд (Next.js, Express и подобные — блог, медиа, платформа курсов): рендерить
<script type="application/ld+json">на сервере (SSR), сериализуя данные в JSON-LD на каждой странице (статья → Article, лендинг → Course/FAQPage).
Связки
| Нужно | Скилл |
|---|---|
| Контекст сущностей, URL, цены | ~/.claude/business-context.md (заведи из templates/) |
| AEO/GEO (цитируемость в AI) | seo-machine-ru (skills/seo-machine-ru/references/aeo-geo.md) |
| Валидация в Вебмастере | yandex |
| Вставка JSON-LD на Tilda + публикация | tilda |
| SEO-контент страницы целиком | seo-machine-ru |
Формат вывода
- Полный JSON-LD блок (готов к вставке).
- Куда вставлять (Tilda T123 / head / SSR-компонент).
- Чеклист: валидируется в Вебмастере + Rich Results; нет ошибок/предупреждений; совпадает с контентом; все обязательные поля; даты ISO 8601; URL абсолютные.
Вопросы под задачу
- Какой тип страницы (главная / обо мне / курс или его модуль / статья / лендинг услуги / новость)?
- Какой rich-результат целевой (FAQ-аккордеон, карточка организации, событие, курс)?
- Какие данные есть на странице для заполнения (цены, даты, автор, изображения)?
- Есть ли уже разметка (не дублировать)?
- Стек страницы — Tilda или Next.js/Express?