agentsready
Content Accessibility Средне

Schema.org JSON-LD для AI: разметка, которую читают агенты

Что такое Schema.org JSON-LD, зачем он для AI и rich-результатов, минимальный пример, правильно vs неправильно, ошибки и как проверить.

Обновлено:

Что это

Schema.org — словарь типов (Organization, Product, Article, FAQPage…), которым вы описываете содержимое страницы машиночитаемо. Рекомендуемый формат — JSON-LD в теге <script type="application/ld+json"> в <head> или <body>.

Зачем это AI-агентам

Человек видит «цена 1990 ₽», а машина — просто текст. JSON-LD говорит явно: это Product, цена 1990, валюта RUB. AI-движки и поисковики используют эту разметку для rich-результатов (звёзды, цены, FAQ) и как опору в AI Overviews / ответах ChatGPT и Perplexity — структурированные факты цитировать надёжнее.

Минимальный рабочий пример

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Example Inc.",
  "url": "https://example.com",
  "logo": "https://example.com/logo.png",
  "sameAs": [
    "https://www.linkedin.com/company/example",
    "https://github.com/example"
  ]
}
</script>

Правильно vs неправильно

ПравильноНеправильно
JSON-LD в <script type="application/ld+json">Устаревшие microdata/RDFa в атрибутах
Есть @context и валидный @typeПропущен @context — разметка игнорируется
Разметка соответствует видимому контентуРазметка цены/отзывов, которых нет на странице (спам → санкции)
Валидный JSONВисячая запятая / кавычки — парсер отбрасывает весь блок

Типичные ошибки

  • Невалидный JSON (лишняя запятая, одинарные кавычки) — один символ ломает весь блок.
  • Нет @context: "https://schema.org" — без него тип не распознаётся.
  • Markup ≠ контент — разметка отзывов/цен, отсутствующих на странице. Google это карает.
  • Слишком общий @type (Thing) вместо конкретного (Product, Article).
  • Дубли одного типа с противоречивыми данными.

Как проверить

Скан проверит наличие и базовую валидность JSON-LD. Глубже:

curl -s https://example.com/ | grep -o 'application/ld+json'

Источники