Валидатор микроразметки: проверка структурированных данных на одной странице или всём сайте
Структурированные данные сообщают поисковым системам, о чём страница, в форме, которую они могут прочитать без догадок: это товар, это его цена, это автор. Валидатор микроразметки читает эту разметку и сообщает, разбирается ли она, правильно ли использует словарь и достаточно ли полна для функции поиска. Одну страницу проверить легко. Сайту с тысячами страниц на шаблонах нужен тот же тест везде.
Что проверяет валидатор микроразметки
Проверка идёт на четырёх уровнях, и каждый ловит свой вид проблем:
- Синтаксис. Разбирается ли JSON-LD? Находится ли каждое свойство microdata внутри элемента? Пропущенная запятая или неэкранированная кавычка могут сделать нечитаемым весь блок.
- Словарь. Настоящие ли это типы и свойства Schema.org, используются ли они на тех типах, которым принадлежат? Свойство с опечаткой остаётся валидным JSON, но ничего не значит.
- Требования функций. Google описывает обязательные и рекомендуемые свойства для каждого поддерживаемого расширенного результата. Разметка может быть валидной по Schema.org и всё равно не содержать свойства, которое Google нужно для сниппета товара или списка мероприятий.
- Совпадение со страницей. Правила Google для структурированных данных требуют, чтобы разметка описывала контент, видимый посетителям. Цена в разметке, которой нет на странице, или заголовок, отличающийся от видимого, создаёт проблему качества, которую не найдёт ни одна проверка синтаксиса.
Большинство инструментов для одной страницы покрывают первые три уровня. Для четвёртого нужны разметка и отрендеренная страница рядом.
Валидатор Schema.org и Проверка расширенных результатов Google
Два бесплатных инструмента проверяют по одной странице за раз и отвечают на разные вопросы. Введение Google в структурированные данные рекомендует Проверку расширенных результатов во время разработки.
| Schema Markup Validator | Проверка расширенных результатов | |
|---|---|---|
| Разработчик | Schema.org | |
| Страниц за тест | 1 | 1 |
| URL или вставленный код | ✓ | ✓ |
| JSON-LD, microdata, RDFa | ✓ | ✓ |
| Весь словарь Schema.org | ✓ | – |
| Право на расширенные результаты Google | – | ✓ |
| Отсутствие обязательных свойств | – | ✓ |
| Предпросмотр результата | – | ✓ |
Schema Markup Validator заменил старый Инструмент проверки структурированных данных от Google. Используйте его, чтобы узнать, корректна ли разметка по Schema.org, включая типы, которые питают панели знаний или ответы ИИ, но не дают расширенного результата. Используйте Проверку расширенных результатов, когда ваша цель связана с конкретной функцией Google. Ни один из них не проверяет весь сайт за раз. SEO ProCheck разбирает отладку неработающих расширенных результатов с обоими инструментами.
JSON-LD, microdata и RDFa
Google читает все три формата и говорит, что при валидности они одинаково хороши, но рекомендует JSON-LD, потому что он находится в одном блоке script, отдельно от HTML, и его проще всего поддерживать корректным во всех шаблонах. Минимальный блок Product выглядит так:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"image": "https://www.example.com/shoe.jpg",
"offers": {
"@type": "Offer",
"price": "89.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
</script>
Microdata и RDFa размещают те же факты в атрибутах видимого HTML. Так разметка остаётся рядом с контентом, но изменение HTML в шаблоне может незаметно её сломать. Что бы вы ни использовали, используйте один формат на элемент; описание одного товара дважды в двух форматах провоцирует расхождения между ними.
Частые ошибки в структурированных данных
- Сломанный JSON. Лишняя запятая в конце, типографская кавычка, вставленная из документа, или сырой перенос строки внутри строки.
- Нет @context или @type. Без них парсер не знает, что описывает блок.
- Нет обязательных свойств. Смотрите таблицу ниже.
- Разметка расходится со страницей. Цена изменилась на странице, но не в разметке.
- Устаревшие значения. Предложение с прошедшей датой priceValidUntil или dateModified раньше datePublished.
Обязательные свойства для нескольких распространённых функций из галереи поиска Google:
| Тип | Обязательно для Google |
|---|---|
| Сниппет товара | name плюс offers, review или aggregateRating |
| Event | name, startDate, location |
| Recipe | name, image |
| BreadcrumbList | itemListElement: name, position, item |
| Article | 0 (все рекомендуемые) |
Некоторая разметка валидна, но уже не даёт того, что давала раньше:
| Разметка | Изменение | С какого времени |
|---|---|---|
| data-vocabulary.org | Не поддерживается | 2021 |
| HowTo | Нет расширенного результата | Сентябрь 2023 года |
| FAQPage | Только сайты госорганов и здравоохранения | Август 2023 года |
| FAQPage | Нет расширенного результата | Май 2026 года |
Почему одной страницы недостаточно
Структурированные данные почти всегда генерируются шаблонами. Когда они ломаются, то ломаются на каждой странице шаблона или на той части, где одно поле пустое. Проверка страницы товара, которую вы случайно открыли, не покажет, что у 300 товаров нет цены, потому что их поле цены задано диапазоном, или что у статей одного автора нет разметки автора.
Три вещи видны только на всём сайте:
- Покрытие. В каких группах страниц есть разметка и каким страницам внутри группы не хватает того, что есть у соседних.
- Пограничные случаи. Пустые поля, необычные символы и значения, которые есть только у части записей.
- Дрейф. Разметка, которая была валидной при запуске и перестала быть валидной после релиза. Именно поэтому документация Google рекомендует следить за отчётами о расширенных результатах после каждого развёртывания.
Как валидировать микроразметку на всём сайте
- Просканируйте сайт и извлеките структурированные данные с каждой HTML-страницы. Если часть разметки вставляет JavaScript, также рендерите страницы, как описано в руководстве JavaScript SEO-краулер.
- Сначала исправьте синтаксические ошибки. В блоке, который не разбирается, ничего другого проверить нельзя.
- Сгруппируйте страницы по шаблону и перечислите типы в каждой группе. Ищите страницы без типа, который есть у большинства их группы.
- Проверьте обязательные свойства для нужных функций, затем рекомендуемые.
- Сравните разметку с видимым текстом: названия, заголовки и цены должны быть на странице.
- Выборочно проверьте в Проверке расширенных результатов одну страницу каждого шаблона, чтобы убедиться, что видит Google.
- Следите за Search Console после каждого релиза: отчёты о расширенных результатах и проверка URL показывают, что Google нашёл при собственном сканировании.
Структурированные данные входят в число шагов чек-листа технического SEO-аудита, а чистая разметка также помогает ИИ-системам читать страницу, как объясняет руководство ИИ SEO-краулер.
Валидируйте структурированные данные с помощью Neova
Категория «Микроразметка» в Neova помечает разметку schema на каждой странице как валидную, с предупреждениями или с ошибками, добавляет столбец «Типы Schema» и выносит вердикт по каждому типу в панели URL. Она читает JSON-LD, microdata и RDFa на каждой HTML-странице сканирования. Некоторые из проверок:
- В структурированных данных синтаксические ошибки, для JSON-LD, который не разбирается или в котором нет @context или @type
- В микроразметке нет обязательных свойств или она расходится с видимым текстом для функций, которые документирует Google
- В микроразметке нет рекомендуемых свойств: эта проверка также отмечает разметку data-vocabulary.org
- Цена товара (Product) из структурированных данных не показана на HTML-странице и Дата priceValidUntil в предложении уже прошла
- Противоречивые даты в структурированных данных, lastmod карты сайта или Last-Modified
- Нет типа структурированных данных, распространённого в группе страниц и На HTML-странице нет разметки расширенных результатов, которая есть в её группе страниц
- В разметке Organization или Person нет идентифицирующих свойств
- На HTML-странице нет микроразметки: читает и отрендеренный HTML, если сканирование его рендерило
- Расширенный результат недействителен, по данным проверки URL в Google Search Console
Поскольку Neova определяет группы страниц по HTML, проблема шаблона видна как одна группа с одной и той же отметкой, а не как тысячи отдельных строк. На открытые вопросы о типах и форматах отвечает FAQ по микроразметке от SEO ProCheck. Смотрите Возможности или скачайте Neova; тариф Free сканирует 1000 URL со всеми проверками.
Вопросы
Что такое валидатор микроразметки?
Инструмент, который читает структурированные данные на странице в JSON-LD, microdata или RDFa и проверяет, что они разбираются, правильно используют типы и свойства Schema.org и, в некоторых инструментах, содержат то, что требуется для функции поиска.
Чем Schema Markup Validator отличается от Проверки расширенных результатов?
Schema Markup Validator на validator.schema.org проверяет разметку по всему словарю Schema.org. Проверка расширенных результатов от Google показывает, на какие расширенные результаты Google может претендовать страница и каких обязательных или рекомендуемых свойств не хватает.
Гарантирует ли валидная микроразметка расширенный результат?
Нет. Google говорит, что валидная разметка даёт странице право на показ, но не гарантирует его. Показывать ли расширенный результат, он решает по запросу, странице и своим правилам качества.
Можно ли валидировать микроразметку на всём сайте?
Не инструментами для одной страницы. Краулер, который извлекает и проверяет структурированные данные на каждой странице, показывает проблемы шаблонов, отсутствующую разметку и страницы, отличающиеся от своей группы, а затем вы выборочно проверяете по одной странице каждого шаблона в Проверке расширенных результатов.
Какой формат структурированных данных использовать?
Google читает JSON-LD, microdata и RDFa и рекомендует JSON-LD, потому что он находится в одном блоке отдельно от HTML и его проще всего поддерживать.