Настройки cookie

Необходимые cookies держат сайт рабочим. Аналитика показывает, какие страницы полезны. Выбор можно изменить в любой момент — из футера.

Политика cookie — подробно: категории cookie, как мы храним ваш выбор в браузере и как отозвать согласие.

Необходимые

Базовые функции сайта и ваш выбор согласия. Всегда включены.

Аналитика

Помогает понять, как используют сайт. Загружается только после вашего разрешения.

GitHubСкачать ZIP

Проверка структурированных данных и Schema.org

Проверяйте JSON-LD, Microdata и RDFa по встроенному словарю Schema.org и локальным правилам расширенных результатов Google, а новую разметку в JSON-LD создавайте черновиком командой schema-build.

Открыть на GitHubБыстрый старт

Что делает

  • Десктопное приложение SpiderHead: вкладка Schema в разделе URL, где показаны найденные и разобранные блоки JSON-LD.
  • SpiderHead в терминале: seohead schema-check

Два уровня проверки

Первый уровень проверяет, что разметка корректна по Schema.org: тип существует, свойство разрешено для этого типа (унаследованные свойства учитываются), а значение подходит по типу. Второй уровень проверяет условия расширенных результатов Google, которые видны локально, например обязательные свойства. Прохождение второго уровня не обещает, что Google покажет расширенный результат.

  • Встроенный словарь Schema.org, работает офлайн
  • Унаследованные свойства учитываются, поэтому свойство author у Article не считается ошибкой.
  • Обязательные свойства и наборы «одно из» для типов расширенных результатов
  • Ошибки разбора, если блок JSON-LD не является корректным JSON.

Разметка как граф

Сущности связываются через ссылки @id. Проверка показывает, какие сущности имеют @id, какие связаны между собой, какие стоят отдельно и есть ли ссылки, которые ни на что не указывают. Сущность-одиночка — полезная находка: поисковики не могут связать её с остальной страницей.

  • Сущности без @id или без связи с остальной разметкой
  • Ссылки на несуществующий @id
  • Разметка читается из JSON-LD, Microdata и RDFa

Сборка

schema-build создаёт связанный @graph для типа страницы, используя только факты, видимые на ней. Он показывает сигналы, по которым определил тип, и насколько уверен в нём. Если догадка слабая, задайте тип сами флагом --type, а черновик проверьте перед выкладкой.

  • Факты берутся только со страницы
  • Тип определяется по сигналам, с указанием уверенности
  • --type переопределяет тип
  • Перечень рекомендуемых полей, которых не хватает

Три шага — один сохранённый скан

  1. Проверьте по словарю Schema.org

    schema-check читает структурированные данные страницы и проверяет каждый тип и свойство по встроенному словарю Schema.org.

  2. Проверьте разметку как граф

    Инструмент показывает, какие сущности имеют @id, какие связаны, какие стоят отдельно и есть ли ссылки на @id, которые ни на что не указывают.

  3. Соберите недостающую разметку

    schema-build предлагает связанный @graph, используя только факты, видимые на странице, и перечисляет рекомендуемые поля, которых ещё не хватает.

Проверки в этой возможности

ПроверкаЧто значитКритичностьДоказательство
SCHEMA_VALIDATION_ERRORСтруктурированные данные страницы содержат ошибки валидации по словарю Schema.orgImportantЧисло ошибок валидации на странице
STRUCTURED_DATA_PARSE_ERRORБлок JSON-LD есть, но не разбирается как корректный JSON, поэтому поисковики его игнорируютImportantНайденные блоки против разобранных
STRUCTURED_DATA_MISSINGНа странице нет разметки Schema.orgTipСтраница с нулём блоков структурированных данных
Ещё в реестре проверок
STRUCTURED_DATA_SCHEMA_ERRORSTRUCTURED_DATA_SCHEMA_WARNINGSTRUCTURED_DATA_RICH_RESULT_REQUIRED_MISSING

Одна команда

bash
seohead schema-check --url https://example.com/product

Сначала установите: руководство по установке. Каждая команда работает и как MCP-инструмент для ИИ-агентов.

Что нужно

  • URL страницы или сам HTML (аргумент html) для проверки офлайн
  • Название типа для schema-build, если догадка слабая
  • Ключи API не нужны

Ограничения

  • Статическая проверка не скажет, покажет ли Google расширенный результат на самом деле.
  • Инструмент видит только переданный ему HTML: разметку, которую добавляет JavaScript, он пропустит, если сначала не отрендерить HTML.
  • Объём RDFa, HTML и графа ограничен: при достижении лимита инструмент явно выводит частичный результат.
  • schema-build готовит черновик разметки, но не публикует её.

Вопросы

Что запускать?
seohead schema-check --url https://example.com/product. Чтобы проверить разметку офлайн, передайте сам HTML в аргументе html, например через --input с JSON-объектом.
Инструмент проверяет и пригодность для расширенных результатов?
Да, локально. Первый уровень — словарь Schema.org: существует ли тип, разрешено ли свойство и совпадает ли тип значения. Второй уровень проверяет обязательные свойства для каждого типа расширенных результатов Google, для которых есть правила. Знать, покажет ли Google результат, инструмент не может.
Какие форматы разметки он читает?
JSON-LD, Microdata и RDFa. Блок JSON-LD, который не разбирается, выводится как ошибка разбора, потому что поисковики его игнорируют.
Придумает ли schema-build факты для моей страницы?
Нет. Граф строится только из фактов, видимых на странице. Инструмент показывает сигналы и свою уверенность. Если уверенность в типе низкая, задайте тип сами флагом --type.
Меняет ли инструмент мой сайт?
Нет. Обе команды только читают страницу. JSON-LD, который создаёт schema-build, — это предложение, которое вы проверяете и выкладываете сами.
Работает ли он и в сканировании?
Да. Сканирование записывает находки по структурированным данным для каждой страницы: отсутствующую разметку, ошибки разбора, ошибки схемы и отсутствующие обязательные свойства расширенных результатов.

Что ещё посмотреть

Из блога и глоссария

Schema.org JSON-LD: структурированные данные для Google SearchБлогSchema.orgГлоссарийJSON-LD: структурированные данные в виде связанного JSONГлоссарийСтруктурированные данныеГлоссарий

Ещё в этой группе · Аудит

Технический SEO-аудитВозможностьПроверка редиректов: цепочки, петли и 302ВозможностьПроверка битых ссылок с источником и местом размещенияВозможностьПроверка canonical-теговВозможностьПроверка hreflangВозможностьПроверка title и meta descriptionВозможностьПроверка структуры заголовковВозможностьПроверка дублей и тонкого контентаВозможностьПроверка и оптимизация изображений для SEOВозможностьАудит внутренней перелинковки и глубины сканированияВозможностьПроверки веса страницы и скоростиВозможностьПроверка HTTPS и заголовков безопасностиВозможностьВидимость в ИИ-поиске (GEO/AEO)Возможность

Проверьте на своём сайте

Скачать ZIPВсе возможности