JSON-LD · разметка для ИИ-поиска

JSON-LD для нейросетей: 3 типа разметки, по которой цитирует ИИ

JSON-LD - невидимый блок кода внутри страницы, который прямым текстом объясняет машине структуру: где заголовок, где автор, где ответы на частые вопросы. У меня эта разметка стоит на каждой статье https://theivansergeev.com, и я показываю здесь живой пример - код своей же страницы, разбор трёх главных типов и результат официальной проверки, снятый 6 сентября 2026 года

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

Открой у себя правый клик на любой статье, выбери «Просмотр кода страницы» и поищи строку application/ld+json - если её нет, машина не понимает структуру твоей страницы. Дальше в статье - как это выглядит на моей живой странице, как проверить официальным валидатором и какие три ошибки чаще всего рвут разметку

Шаг 0. Пойми, зачем это вообще нужно

Когда нейросеть вроде ChatGPT, Perplexity или Gemini собирает ответ на чей-то вопрос, ей нужно быстро понять, что перед ней за страница: статья это, товар, инструкция или список вопросов-ответов. Обычный текст она читает и додумывает структуру сама, а с готовой разметкой ей не нужно догадываться - она прямо говорит: «вот заголовок, вот дата публикации, вот список источников, вот ответы на вопросы»

Официальная позиция Google подтверждает эту логику прямым текстом: структурированная разметка не обязательна для попадания в обычный поиск, но помогает машине точнее понять контент и может открыть расширенный вид в выдаче. Из трёх возможных вариантов такой разметки - Microdata, RDFa и разбираемый здесь формат - сама Google рекомендует именно его как самый простой в поддержке, менее подверженный ошибкам пользователя

Шаг 1. Найди JSON-LD в коде своей страницы

Куда нажать: открой любую свою опубликованную страницу, нажми правой кнопкой мыши в любом пустом месте и выбери пункт «Просмотр кода страницы» (в некоторых браузерах пункт называется «Исходный код страницы»). Откроется новая вкладка со сплошным текстом кода - это нормально, выглядит непривычно, но это просто исходник страницы

Что увидишь: используй поиск по странице (сочетание Cmd+F на Mac или Ctrl+F на Windows) и введи application/ld+json. Если такая строка нашлась - у тебя открыт тег <script type="application/ld+json">, а сразу за ним идёт сама разметка в виде фигурных скобок с полями вроде @type, headline, datePublished

Что это даёт: за минуту ты видишь, есть ли у твоей страницы разметка вообще, ещё до любой платной проверки

Исходный код живой страницы: тег application/ld+json, объект @graph с типом Article
Моя собственная разметка в исходном коде живой статьи theivansergeev.com, снят 06.09.2026: тег <script type="application/ld+json">, внутри объект @graph с 9 полями подряд, включая headline, description, url, datePublished

У меня на этой конкретной странице разметка начинается с типа Article - в нём сразу видны поля headline (заголовок), description (краткое описание), url (адрес страницы), datePublished и dateModified (даты публикации и последнего изменения). Дальше в том же объекте @graph идут ещё несколько блоков подряд - об этом в следующем шаге

Шаг 2. Пойми, что означают три главных типа разметки

Куда нажать: никуда нажимать не нужно, это шаг понимания - вернись к найденному в прошлом шаге коду и поищи внутри него слово @type

Что писать внутри: у меня в одном блоке @graph объединено несколько разных элементов разметки сразу, но три главных типа закрывают почти любую статью новичка:

  1. Article - сама статья: заголовок, описание, даты публикации и изменения, автор, язык. Это база, без неё машина не поймёт даже то, что перед ней текстовый материал, а не, например, карточка товара
  2. FAQPage - блок вопросов-ответов. Каждый вопрос и каждый ответ здесь дублируются ровно тем же текстом, что виден человеку на странице. Независимые разборы рынка структурированных данных сходятся в одном выводе: страницы с полной FAQPage-разметкой получают заметно больше цитирований в ответах ИИ-систем, чем страницы без неё - разметка снимает у машины работу по извлечению готового ответа из сплошного текста
  3. HowTo - пошаговая инструкция. Каждый шаг статьи (как в этой самой статье) описывается отдельным полем с названием и текстом действия, машина сразу видит: это гайд из N шагов, а не просто рассуждение

Что увидишь: если открыть @graph целиком, каждый тип идёт отдельным блоком в фигурных скобках, с собственным полем @type внутри - "@type": "Article", дальше "@type": "FAQPage" и так далее

Что это даёт: три этих типа закрывают структуру подавляющего большинства статей - тебе не нужно осваивать весь словарь Schema.org, чтобы начать показывать машине структуру своей страницы

Шаг 3. Проверь разметку бесплатным официальным валидатором

Куда нажать: открой в браузере страницу validator.schema.org - это официальный публичный инструмент от самой организации Schema.org, работает без регистрации и без установки чего-либо на компьютер. Вставь в поле адрес своей статьи и нажми кнопку запуска проверки

Что увидишь: слева появится код твоей страницы, справа - панель с найденными типами разметки. Наверху панели три числа: количество ошибок, количество предупреждений и количество найденных элементов (items)

Что это даёт: это не гадание на глаз, а прямая проверка тем же словарём, которым пользуется сама индустрия. За минуту видно, действительно ли твоя разметка читается машиной так, как задумано, или где-то в коде опечатка

Проверка валидатором Schema.org: 0 ошибок, найдены элементы Article и FAQPage
Официальный валидатор Schema.org, прогон на моей живой статье theivansergeev.com, снят 06.09.2026: 0 fouten (ошибок), 1 waarschuwing (предупреждение), найдены 2 элемента - Article и FAQPage

Я прогнал через этот валидатор свою живую статью 6 сентября 2026 года: инструмент нашёл структурированные данные Article и FAQPage - с нулём ошибок и одним предупреждением на весь прогон. Нажав на карточку Article, я получил полный разбор извлечённых машиной полей: заголовок, описание, адрес, обе даты, язык страницы, ключевые слова и даже автоматически посчитанное количество слов в тексте - 3312

Развёрнутая карточка Article в валидаторе: headline, description, url, даты и wordCount
Развёрнутая карточка Article в том же валидаторе Schema.org, снята 06.09.2026: все поля, которые машина реально извлекла из моей страницы theivansergeev.com, включая автоматический подсчёт слов - 3312

Шаг 4. Убедись, что видимый текст и разметка говорят одно и то же

Куда нажать: снова открой код своей страницы и найди в нём блок FAQPage, а рядом на самой странице - тот же блок вопросов-ответов, который видит обычный посетитель. Способ открыть код страницы описан в Шаге 1

Что писать внутри: сверь текст ответа в коде и текст ответа на экране слово в слово, включая числа. Это не мелочь: если хотя бы одна цифра написана по-разному в двух местах, машина видит расхождение и может отбросить разметку целиком как недостоверную

Что это даёт: без этой сверки легко получить страницу, где разметка формально есть, но не работает - потому что не совпадает с тем, что видит человек

Независимый разбор частых ошибок такой разметки называет это расхождение отдельной категорией проблем - несовпадение видимого контента с заявленной разметкой, когда содержимое FAQPage или Article не подтверждается текстом страницы. У меня на практике был именно такой случай: сборщик страниц у меня на сайте оборачивал числа с разделителем тысяч (например «142 000») в специальный элемент с неразрывным пробелом внутри видимого текста - а в код разметки та же цифра попадала уже без этого пробела. Байт в байт два места расходились, и это уронило собственную проверку у меня на живой статье 5 сентября 2026 года. Починил заменой цифры на словоформу («142 тысячи») в тех местах, которые дублируются в разметку - расхождение исчезло

Три частые ошибки, которые ловит валидатор

Что чаще всего портит эту разметку у новичка

  • Пропущенная запятая или скобка обычная опечатка в фигурных скобках ломает весь блок разметки целиком - валидатор в этом случае обычно не находит ни одного типа вместо частичной ошибки
  • Неправильный регистр типа или поля типы разметки пишутся с заглавной буквы каждого слова (например Article, а не article), а поля - с маленькой первой буквы (datePublished, а не DatePublished); валидатор в этом случае помечает поле как нераспознанное, а не как синтаксическую ошибку
  • Разметка не совпадает с видимым текстом если в коде написано одно, а на экране человек видит другое - число, дату или формулировку - машина теряет доверие к такой разметке, это тот самый класс ошибки из шага 4 этой статьи

Что эта разметка не гарантирует

Честная оговорка, чтобы не продавать волшебную кнопку. Разметка помогает машине понять структуру страницы, но не покупает место в ответе нейросети напрямую - итоговый выбор источника решает ещё и качество самого текста, и то, насколько легко из него извлечь готовый факт. Официальная документация Google прямо говорит: обязательных технических требований для попадания в AI-ответы нет, работает обычная индексация плюс полезный контент. Разметка убирает у машины неоднозначность и упрощает выбор между твоей страницей и десятком похожих, а не гарантирует победу автоматически

Чем эта разметка отличается от остальной GEO-настройки

Она - только один из трёх слоёв настройки сайта под нейросети, и путать его с остальными двумя вредно:

СлойЧто делаетГде живёт
robots.txtпускает или не пускает ИИ-ботов на сайт вообщекорень сайта, обычный текстовый файл
файл-справочник сайтадаёт машине сжатый каталог всех страницкорень сайта, обычный текстовый файл
разметка страницыобъясняет структуру КАЖДОЙ отдельной страницыкод внутри самой страницы, невидим человеку

Таблица прокручивается вбок →

Если тема интересна шире одной разметки - три двери GEO целиком, включая открытость для ботов и файл-справочник сайта, уже разобраны в отдельном гайде про попадание в ответы нейросетей

Что делать, если у твоей страницы нет разметки вовсе

Три честных сценария, в зависимости от того, на чём собран сайт:

СценарийЧто делать
Сайт собирается в Claude Code или похожем ИИ-инструментепопроси добавить в конец страницы блок application/ld+json с типом Article, обязательно уточни, что все факты (даты, автор) должны быть настоящими, а не выдуманными
Сайт на конструкторе (Tilda, Wix и похожие)ищи в настройках страницы или SEO-блока пункт про структурированные данные или Schema - многие конструкторы добавляют базовую Article-разметку автоматически
Сайт на WordPressбольшинство SEO-расширений (Yoast, Rank Math) добавляют разметку автоматически, проверь Шагом 1 этой статьи, что она уже стоит

Таблица прокручивается вбок →

Ни один из трёх сценариев не требует написания кода руками - разметка добавляется через готовый инструмент или через простую текстовую команду. Если сайта для проверки ещё нет вовсе, сначала собери его - например, через Claude Code, без кода или любым из четырёх ИИ-путей - и возвращайся к этому шагу

Твой набор бесплатных инструментов

Три бесплатных инструмента для самопроверки, без установки чего-либо на компьютер:

ИнструментЧто показываетНужна ли регистрация
validator.schema.orgнайденные типы разметки, число ошибок и предупрежденийнет
«Просмотр кода страницы» в браузересырой код твоей страницы, включая тег application/ld+jsonнет
поиск по странице (Cmd+F / Ctrl+F)быстрый способ найти нужный блок в длинном коденет

Таблица прокручивается вбок →

Частые грабли

Три вещи, которые чаще всего путают новичка при первой разметке

  • Разметка кажется невидимой поломкой, если её нет вовсе страница при этом продолжает открываться и выглядеть нормально - отсутствие JSON-LD не ломает сайт визуально, поэтому его легко не заметить месяцами
  • Скопированная разметка с чужого сайта без правки адреса, автор и даты остаются чужими - машина либо получит неверные данные, либо валидатор явно пометит поле ошибкой
  • Обновил текст статьи, а разметку забыл особенно с блоком FAQPage - поправил ответ на вопрос в видимом тексте, а в JSON-LD осталась старая версия, ровно та ошибка из Шага 4

Если тема интересна не с технической стороны разметки, а с точки зрения самого текста, который эта разметка описывает - формула такого текста разобрана отдельно в статье текст, который цитируют нейросети

Что ещё почитать про сайты и попадание в поиск

Источники

Источники проверены прямым запросом 6 сентября 2026 года; собственная разметка моего же сайта проверена живым запросом в тот же день.

Памятка: проверка JSON-LD за четыре шага

Четыре строки, которые закрывают всю самопроверку

Сохрани себе

  • Шаг 1: открой «Просмотр кода страницы» и найди строку application/ld+json
  • Шаг 2: узнай в коде три главных типа - Article (статья), FAQPage (вопросы-ответы), HowTo (инструкция)
  • Шаг 3: прогони адрес страницы через официальный validator.schema.org, ноль ошибок - хороший знак
  • Шаг 4: сверь текст FAQ в коде и на экране слово в слово, включая числа - расхождение рвёт разметку

Порог входа

Разметка одной статьи разобрана бесплатно, следующий шаг - тоже

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

Забрать путёвку в ИИ-Лагерь

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

Частые вопросы

Что такое JSON-LD простыми словами?

Невидимый блок кода внутри страницы, который прямым текстом объясняет машине структуру: где заголовок, где автор, где ответы на частые вопросы, откуда взяты факты. Человек этот код не видит на экране, а нейросети и поисковики читают его, чтобы точнее понять содержимое страницы

Обязательно ли добавлять JSON-LD на каждую страницу?

Формально нет, разметка не обязательна для попадания в обычный поиск. Но без неё машине приходится самой додумывать структуру страницы по обычному тексту, и она угадывает не всегда верно - особенно с блоками вопросов-ответов, где готовая разметка заметно повышает шанс, что именно твой ответ попадёт в готовую цитату нейросети

Как проверить, что моя разметка работает правильно?

Открой официальный бесплатный validator.schema.org, вставь адрес своей страницы и запусти проверку. Инструмент покажет число ошибок, число предупреждений и список найденных типов разметки - ноль ошибок означает, что код разметки записан правильно

Почему у меня в валидаторе ошибка, хотя код выглядит правильно?

Самая частая причина - расхождение между тем, что написано в разметке, и тем, что реально видно на странице: число, дата или формулировка отличаются хотя бы на символ. Вторая по частоте причина - неправильный регистр: типы разметки пишутся с заглавной буквы (Article), а поля - с маленькой (datePublished)

Нужно ли писать JSON-LD руками?

Нет, если сайт собирается в Claude Code или похожем ИИ-инструменте - попроси добавить разметку человеческим языком, уточнив, что все факты должны быть настоящими. На WordPress и большинстве конструкторов сайтов базовая разметка часто добавляется автоматически через SEO-расширение или настройки страницы

Чем эта разметка отличается от разметки Person для меня как эксперта?

Это разные предметы разметки. Здесь речь про то, как разметить САМУ СТАТЬЮ - её заголовок, даты, вопросы-ответы. Если задача другая - разметить именно ТЕБЯ как человека и эксперта, чтобы машина не путала с однофамильцами, это разбирается отдельно в гайде как сделать, чтобы нейросети советовали тебя клиентам