Микроразметка 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?
1---2name: schema-markup-ru3description: Schema.org / JSON-LD разметка: Organization, Course, FAQPage; Яндекс читает JSON-LD. Триггеры: «микроразметка», «rich snippets», «звёздочки в выдаче».4---56# Микроразметка Schema.org / JSON-LD (RU)78Реализация структурированных данных schema.org на своих сайтах, чтобы поисковики (Яндекс, Google) лучше понимали контент и показывали расширенные сниппеты, а AI-поверхности (Яндекс.Нейро, Alice, GigaChat) точнее цитировали. Порт `schema` из marketingskills: вокабуляр schema.org международный, адаптированы примеры под реальные сущности (YourFirstName, академия, воркшоп, news, блог) и заметка про Яндекс.910**Перед началом прочитай `~/.claude/business-context.md`** — раздел «Продукт» (какие сущности вообще размечаем: организация, персона, курс, услуга, товар) и раздел «Цены» (суммы и URL страниц). Файла нет — заведи из `~/.claude/templates/business-context.md`.1112Здесь последствие жёстче обычного: разметка обязана совпадать с тем, что видно на странице. Выдуманная цена или несуществующий рейтинг в JSON-LD — это не «неточность», а повод для санкций поисковика. Чего не знаешь — помечай `[TODO]` и уточняй, а не подставляй правдоподобное.1314**AEO/GEO связка:** JSON-LD — один из сильнейших сигналов для попадания в AI-ответы. После разметки сверяйся с `seo-machine-ru` → `skills/seo-machine-ru/references/aeo-geo.md` (цитируемость в Яндекс.Нейро/Alice/GigaChat/ChatGPT/Perplexity).1516## Принципы17181. **Точность прежде всего.** Разметка обязана соответствовать видимому контенту. Не размечать то, чего нет на странице. Обновлять при изменении контента.192. **Используй JSON-LD.** Рекомендуемый формат (и Google, и Яндекс). Скрипт `<script type="application/ld+json">` в `<head>` или конце `<body>`.203. **Только то, что поддерживается.** Без спам-тактик. Проверять требования к rich-результатам.214. **Валидируй всё.** Тест перед деплоем, мониторинг в Вебмастере.2223## Заметка про Яндекс (важно для RU-рынка)2425- Яндекс читает JSON-LD и микроформаты; расширенные сниппеты в выдаче формируются по разметке (товары, организации, FAQ, хлебные крошки, события).26- Проверка: **Яндекс.Вебмастер → Инструменты → Валидатор микроразметки** (а не только Google Rich Results Test). Дёргать через скилл `yandex` (Вебмастер) либо вручную.27- Для бизнеса/локалки — карточка в **Яндекс.Бизнес** (отдельно от JSON-LD), но `Organization`/`Person` всё равно ставим на сайт.28- AI-цитируемость: чёткий `Person` (YourFirstName как эксперт), `Organization`, `FAQPage`, `Course` помогают Яндекс.Нейро/GigaChat понять, кто автор и что за продукт.2930## Типы под свои сайты3132| Тип | Где ставить | Обязательные поля |33|-----|-------------|-------------------|34| Organization | your-domain.com (главная/обо мне) | name, url |35| WebSite (+SearchAction) | главная / news (поиск по сайту) | name, url |36| Person | страница «Обо мне» (YourFirstName как эксперт) | name |37| Course | academy.your-domain.com и страницы треков | name, description, provider |38| Article | блог, статьи на /media, новости news | headline, image, datePublished, author |39| FAQPage | лендинги услуг/воркшопа/academy с FAQ | mainEntity (Q&A) |40| Event | воркшоп, конференция, вебинар | name, startDate, location |41| BreadcrumbList | любая страница с навигацией/крошками | itemListElement |4243Полные JSON-LD примеры под каждую сущность — `references/schema-examples.md`.4445## Объединение типов на странице (@graph)4647Несколько типов на одной странице — через `@graph`:4849```json50{ "@context": "https://schema.org", "@graph": [51 { "@type": "Organization", "@id": "https://your-domain.com/#org", "...": "..." },52 { "@type": "Person", "@id": "https://your-domain.com/#user", "...": "..." },53 { "@type": "BreadcrumbList", "...": "..." }54]}55```5657## Валидация и тестирование5859- **Яндекс.Вебмастер** — валидатор микроразметки + раздел «Структурированные данные» (через `yandex`).60- **Google Rich Results Test** — search.google.com/test/rich-results.61- **Schema.org Validator** — validator.schema.org.6263Типичные ошибки: нет обязательных полей; даты не в ISO 8601; URL не абсолютные; значения enum неточные (`https://schema.org/InStock`); разметка не совпадает с видимым контентом.6465## Реализация под свой стек6667- **Tilda** (your-domain.com, лендинги): JSON-LD вставляется в блок T123 (custom HTML) или в настройки страницы (head). Деплой и публикация — через скилл `tilda`. Учти граблины T123 (scope, лимит кода) — см. `tilda`.68- **Свой фронтенд** (Next.js, Express и подобные — блог, медиа, платформа курсов): рендерить `<script type="application/ld+json">` на сервере (SSR), сериализуя данные в JSON-LD на каждой странице (статья → Article, лендинг → Course/FAQPage).6970## Связки7172| Нужно | Скилл |73|------|-------|74| Контекст сущностей, URL, цены | `~/.claude/business-context.md` (заведи из `templates/`) |75| AEO/GEO (цитируемость в AI) | `seo-machine-ru` (`skills/seo-machine-ru/references/aeo-geo.md`) |76| Валидация в Вебмастере | `yandex` |77| Вставка JSON-LD на Tilda + публикация | `tilda` |78| SEO-контент страницы целиком | `seo-machine-ru` |7980## Формат вывода81821. Полный JSON-LD блок (готов к вставке).832. Куда вставлять (Tilda T123 / head / SSR-компонент).843. Чеклист: валидируется в Вебмастере + Rich Results; нет ошибок/предупреждений; совпадает с контентом; все обязательные поля; даты ISO 8601; URL абсолютные.8586## Вопросы под задачу87881. Какой тип страницы (главная / обо мне / курс или его модуль / статья / лендинг услуги / новость)?892. Какой rich-результат целевой (FAQ-аккордеон, карточка организации, событие, курс)?903. Какие данные есть на странице для заполнения (цены, даты, автор, изображения)?914. Есть ли уже разметка (не дублировать)?925. Стек страницы — Tilda или Next.js/Express?
JHamidun