schema
Скилл schema посвящён добавлению, исправлению и оптимизации разметки Schema.org и структурированных данных, прежде всего JSON-LD. Он применяется, когда нужно сделать содержание страницы понятнее для поисковых систем и подготовить его к поддерживаемым расширенным результатам, но не заменяет общий SEO-аудит и не обещает автоматического появления rich snippets. Первый шаг — определить тип страницы, её основной контент, уже существующую разметку, возможный вид расширенного результата и практическую цель внедрения. Ключевое правило — точность: в schema нельзя отмечать сведения, которых нет на видимой странице, нельзя заполнять свойства догадками и нужно поддерживать разметку синхронной с изменениями контента. Для сайта рекомендуется JSON-LD, поскольку его проще сопровождать и валидировать; в динамическом React или Next.js его следует формировать компонентом и отдавать сервером. Скилл перечисляет типы и обязательные поля для распространённых случаев. Organization использует name и url, Website — name и url, Article — headline, image, datePublished и author, Product — name, image и offers, SoftwareApplication — name и offers, FAQPage — массив mainEntity с вопросами и ответами, HowTo — name и step, BreadcrumbList — itemListElement, а LocalBusiness — name и address. Для Organization дополнительно полезны logo, sameAs и contactPoint; для Article — dateModified, publisher и description; для Product — sku, brand, aggregateRating и review. Эти поля не должны появляться только потому, что они перечислены в справочнике: их можно добавлять лишь при наличии соответствующих фактов. Несколько независимых типов можно объединить в одном JSON-LD через @graph. Такой подход подходит, например, для страницы компании с сущностями Organization и WebSite или для материала с хлебными крошками, если каждая сущность описывает реальный элемент страницы. Валидировать результат нужно до публикации и после изменений. В качестве инструментов источник указывает Google Rich Results Test, Schema.org Validator и отчёты Enhancements в Search Console. Проверка должна искать отсутствующие обязательные свойства, неверные значения, даты не в ISO 8601, неполные URL и перечисления с неправильным написанием. Отдельно нужно проверять соответствие разметки видимому тексту: наличие JSON-LD без такого содержания на странице является ошибкой, а не способом увеличить семантический охват. Для статического сайта разметка размещается в HTML-шаблоне; для Next.js или другого динамического приложения нужен серверный компонент, который сериализует данные в JSON-LD; для CMS вроде WordPress возможны плагины или поля темы, но их результат всё равно необходимо проверить. Практический процесс начинается с ответа на пять вопросов: какой тип страницы обрабатывается, какой rich result нужен, какие данные реально доступны, есть ли существующая schema и какой стек используется. После этого выбирается только поддерживаемый тип, заполняются его обязательные свойства, добавляются подтверждённые рекомендованные поля и запускается валидатор. Скилл также напоминает, что структурированные данные должны отражать текущую страницу, а не маркетинговое намерение: FAQ-разметка требует настоящего набора вопросов и ответов, Product — настоящего товара, изображения и offers, а BreadcrumbList — фактических элементов навигации. В результате он задаёт небольшой, проверяемый workflow для JSON-LD: сначала понять страницу и данные, затем выбрать точный Schema.org тип, отдать разметку сервером, проверить обязательные поля и убедиться, что поисковая система видит ровно те факты, которые пользователь видит на странице.
Для чего подходит
- Добавление JSON-LD на страницу сайта
- Исправление Schema.org-разметки
- Подготовка страниц к rich results
Установка
Сначала прочитайте SKILL.md и scripts в исходном репозитории. Затем выполните команду в каталоге проекта:
npx skills add https://github.com/coreyhaines31/marketingskills/tree/main/skills/schema