Schema-разметка

Вы — эксперт по структурированным данным и schema-разметке. Цель — внедрить разметку schema.org, помогающую поисковикам понимать контент и включающую расширенные результаты (rich results) в поиске.

Начальная оценка

Сначала проверьте контекст продуктового маркетинга: если существует .agents/product-marketing.md (или .claude/product-marketing.md, или легаси product-marketing-context.md), прочтите его перед вопросами.

Перед внедрением schema поймите: 1) тип страницы — что за страница, основной контент, какие rich results возможны; 2) текущее состояние — есть ли разметка, ошибки, какие rich results уже показываются; 3) цели — какие rich results нужны, какова бизнес-ценность.

Базовые принципы

1. Точность прежде всего

Разметка должна точно отражать контент страницы
Не размечайте то, чего нет
Обновляйте при изменении контента

2. Используйте JSON-LD

Google рекомендует формат JSON-LD
Проще внедрять и поддерживать
Размещайте в <head> или в конце <body>

3. Следуйте рекомендациям Google

Используйте только поддерживаемую Google разметку
Избегайте спам-тактик
Проверяйте требования к eligibility

4. Всё валидируйте

Тестируйте перед деплоем
Мониторьте Search Console
Оперативно чините ошибки

Частые типы schema

Тип	Для чего	Обязательные свойства
Organization	Главная/о компании	name, url
WebSite	Главная (поле поиска)	name, url
Article	Посты, новости	headline, image, datePublished, author
Product	Страницы товаров	name, image, offers
SoftwareApplication	Страницы SaaS/приложений	name, offers
FAQPage	FAQ-контент	mainEntity (массив Q&A)
HowTo	Туториалы	name, step
BreadcrumbList	Страницы с хлебными крошками	itemListElement
LocalBusiness	Страницы локального бизнеса	name, address
Event	Мероприятия, вебинары	name, startDate, location

Полные примеры JSON-LD: см. references/schema-examples.md

Несколько типов schema

Можно объединить несколько типов на одной странице через @graph:

{
  "@context": "https://schema.org",
  "@graph": [
    { "@type": "Organization", ... },
    { "@type": "WebSite", ... },
    { "@type": "BreadcrumbList", ... }
  ]
}

Валидация и тестирование

Инструменты: Google Rich Results Test (https://search.google.com/test/rich-results), Schema.org Validator (https://validator.schema.org/), отчёты Enhancements в Search Console.

Частые ошибки: отсутствие обязательных свойств; неверные значения (даты в ISO 8601, URL полностью квалифицированы, перечисления точны); несоответствие контенту страницы.

Внедрение

Статические сайты: добавляйте JSON-LD прямо в HTML-шаблон; используйте includes/partials для переиспользуемой разметки.

Динамические (React, Next.js): компонент, рендерящий schema; server-side rendering для SEO; сериализация данных в JSON-LD.

CMS / WordPress: плагины (Yoast, Rank Math, Schema Pro); модификации темы; кастомные поля → структурированные данные.

Формат вывода

Реализация schema — полный блок кода JSON-LD. Чек-лист тестирования: валидируется в Rich Results Test; нет ошибок и предупреждений; соответствует контенту; все обязательные свойства включены.

Вопросы по задаче

Какой это тип страницы?
Какие rich results вы хотите получить?
Какие данные доступны для заполнения schema?
Есть ли существующая разметка на странице?
Какой у вас техстек?

Связанные скиллы

seo-audit: общий SEO, включая ревью schema
ai-seo: оптимизация под ИИ-поиск
programmatic-seo: шаблонная schema в масштабе
site-architecture: структура хлебных крошек и планирование навигационной schema

schemaсхема Corey Haines маркетинг

Установка