Что такое JSON-LD?

JSON-LD (JavaScript Object Notation for Linked Data) - это формат структурированных данных, который рекомендуют поисковые системы. Страница добавляет блок <script type="application/ld+json">, описывающий содержание страницы, например товар с его ценой, статью с указанием автора или организацию с её логотипом, используя типы и свойства из словаря schema.org. Google, Bing и другие поисковые системы считывают эти блоки, чтобы показывать расширенные результаты, такие как рейтинги со звёздами, цены, цепочки навигации и карточки рецептов.

Ошибки в JSON-LD не приводят к явным сбоям. Страница по-прежнему загружается, но пропущенная запятая, неправильно написанный тип или отсутствующее обязательное поле приводят к тому, что поисковые системы игнорируют разметку или страница теряет расширенный результат.

Описание инструмента

Этот инструмент загружает HTML страницы на сервере, находит все блоки скриптов JSON-LD и проверяет каждый из них в два этапа. Сначала он проверяет сам JSON-LD: корректно ли разбирается JSON, содержит ли каждый элемент @context со ссылкой на schema.org и @type, а также правильно ли написаны и оформлены такие ключевые слова, как @type и @id. Затем он проверяет содержимое по словарю schema.org и правилам Google для расширенных результатов, сообщая о неизвестных типах, свойствах, которые не относятся к определённому типу, а также об отсутствующих обязательных или рекомендуемых полях либо полях в неправильном формате.

Возможности

  • Находит все блоки JSON-LD на открытой странице - в <head> или <body>
  • Сообщает об ошибках синтаксиса JSON вместе с сообщением анализатора
  • Проверяет @context, @type, @id, @graph и написание ключевых слов
  • Выявляет неизвестные типы schema.org и свойства, которые не поддерживаются определённым типом
  • Проверяет обязательные и рекомендуемые поля Google для товаров, предложений, отзывов, рейтингов, рецептов, вакансий, видео, цепочек навигации и многого другого
  • Перечисляет все элементы структурированных данных с их типом и названием
  • Показывает каждый блок в виде отформатированного JSON

Как это работает

Страница загружается без перехода по перенаправлениям, при этом считываются максимум первые 3 МБ. Каждый блок JSON-LD разбирается отдельно, а элементы внутри @graph проверяются как отдельные элементы. Для проверок schema.org используется копия полного словаря schema.org, а для проверок расширенных результатов Google - валидатор структурированных данных с открытым исходным кодом от Adobe.

Советы

  • Ошибки означают, что поисковые системы, скорее всего, проигнорируют элемент или он не будет показан в расширенном результате, поэтому сначала исправьте их. Предупреждения обычно относятся к рекомендуемым полям, и их добавление может улучшить внешний вид результата.
  • Ключевые слова JSON-LD чувствительны к регистру: @type работает, а @Type - нет.
  • Используйте абсолютные URL для url, image и logo, а также даты в формате ISO 8601, например 2026-09-25 или 2026-09-25T10:00:00+02:00.
  • Инструмент считывает HTML, который возвращает сервер. JSON-LD, добавленный позднее с помощью JavaScript в браузере, найден не будет.