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
Что это даёт: за минуту ты видишь, есть ли у твоей страницы разметка вообще, ещё до любой платной проверки
<script type="application/ld+json">, внутри объект @graph с 9 полями подряд, включая headline, description, url, datePublishedУ меня на этой конкретной странице разметка начинается с типа Article - в нём сразу видны поля headline (заголовок), description (краткое описание), url (адрес страницы), datePublished и dateModified (даты публикации и последнего изменения). Дальше в том же объекте @graph идут ещё несколько блоков подряд - об этом в следующем шаге
Шаг 2. Пойми, что означают три главных типа разметки
Куда нажать: никуда нажимать не нужно, это шаг понимания - вернись к найденному в прошлом шаге коду и поищи внутри него слово @type
Что писать внутри: у меня в одном блоке @graph объединено несколько разных элементов разметки сразу, но три главных типа закрывают почти любую статью новичка:
Article- сама статья: заголовок, описание, даты публикации и изменения, автор, язык. Это база, без неё машина не поймёт даже то, что перед ней текстовый материал, а не, например, карточка товараFAQPage- блок вопросов-ответов. Каждый вопрос и каждый ответ здесь дублируются ровно тем же текстом, что виден человеку на странице. Независимые разборы рынка структурированных данных сходятся в одном выводе: страницы с полнойFAQPage-разметкой получают заметно больше цитирований в ответах ИИ-систем, чем страницы без неё - разметка снимает у машины работу по извлечению готового ответа из сплошного текстаHowTo- пошаговая инструкция. Каждый шаг статьи (как в этой самой статье) описывается отдельным полем с названием и текстом действия, машина сразу видит: это гайд из N шагов, а не просто рассуждение
Что увидишь: если открыть @graph целиком, каждый тип идёт отдельным блоком в фигурных скобках, с собственным полем @type внутри - "@type": "Article", дальше "@type": "FAQPage" и так далее
Что это даёт: три этих типа закрывают структуру подавляющего большинства статей - тебе не нужно осваивать весь словарь Schema.org, чтобы начать показывать машине структуру своей страницы
Шаг 3. Проверь разметку бесплатным официальным валидатором
Куда нажать: открой в браузере страницу validator.schema.org - это официальный публичный инструмент от самой организации Schema.org, работает без регистрации и без установки чего-либо на компьютер. Вставь в поле адрес своей статьи и нажми кнопку запуска проверки
Что увидишь: слева появится код твоей страницы, справа - панель с найденными типами разметки. Наверху панели три числа: количество ошибок, количество предупреждений и количество найденных элементов (items)
Что это даёт: это не гадание на глаз, а прямая проверка тем же словарём, которым пользуется сама индустрия. За минуту видно, действительно ли твоя разметка читается машиной так, как задумано, или где-то в коде опечатка
Я прогнал через этот валидатор свою живую статью 6 сентября 2026 года: инструмент нашёл структурированные данные Article и FAQPage - с нулём ошибок и одним предупреждением на весь прогон. Нажав на карточку Article, я получил полный разбор извлечённых машиной полей: заголовок, описание, адрес, обе даты, язык страницы, ключевые слова и даже автоматически посчитанное количество слов в тексте - 3312
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
Если тема интересна не с технической стороны разметки, а с точки зрения самого текста, который эта разметка описывает - формула такого текста разобрана отдельно в статье текст, который цитируют нейросети
Что ещё почитать про сайты и попадание в поиск
- Как попасть в ответы нейросетей: 3 двери GEO - если нужна не только разметка отдельной страницы, а вся техническая настройка сайта целиком
- Как сделать, чтобы нейросети советовали тебя клиентам - если задача не разметить статью, а разметить СЕБЯ как эксперта через тип Person
- Текст, который цитируют нейросети: формула из 4 частей - если вопрос не в коде разметки, а в том, что писать внутри неё
- Claude Code: что это и как пользоваться - если разметку для своего сайта будешь собирать в Claude Code
- Как установить Claude Code - если самого инструмента ещё нет на компьютере
- SEO-скилл для Клода: 5 шагов к плану страниц - если дальше нужен план и семантика будущих статей, а не только их разметка
- Как выложить сайт в интернет бесплатно в 2026 - если сайта для проверки ещё нет и его нужно сначала опубликовать
- Как создать сайт с помощью ИИ: 4 пути - если файлов сайта ещё нет вовсе
- No code в 2026: когда хватит конструктора, а когда нужен код - если сайт ещё только выбираешь, на чём собирать
- Timeweb: купить домен и привязать сайт - если своего домена ещё нет, а без него часть проверок не имеет смысла
- Контент и продвижение на ИИ: разборы и гайды - если тема продвижения через нейросети интересна шире одной разметки
- 8 бесплатных ИИ-инструментов Google - если интересны и другие бесплатные инструменты Google, не только валидатор разметки
- ChatGPT Plus 2026: цена и оплата из России - если хочешь сам проверять, как ChatGPT цитирует твой сайт, на платном тарифе
- Сколько стоит сделать сайт в 2026 - если считаешь бюджет сайта целиком, включая техническую настройку
Источники
Источники проверены прямым запросом 6 сентября 2026 года; собственная разметка моего же сайта проверена живым запросом в тот же день.
- Google Search Central: Intro to structured data - официальная позиция Google про JSON-LD как рекомендуемый формат, необязательность для базового поиска, требование совпадения с видимым текстом
- Schema.org: официальная документация - три формата структурированных данных (Microdata, RDFa, JSON-LD), общий словарь
- Schema.org: официальный валидатор структурированных данных - публичная проверка разметки без регистрации, использована в own-run этой статьи
- Разбор частых ошибок такой разметки - типичные ошибки записи кода, регистра типов и полей, несовпадение разметки с видимым текстом
- llms.txt: официальное описание стандарта - смежный стандарт машиночитаемости сайта, упомянутый как параллельный слой GEO-настройки
- Живая статья https://theivansergeev.com с полным набором JSON-LD-разметки - использована в own-run этого материала
Памятка: проверка 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 для меня как эксперта?
Это разные предметы разметки. Здесь речь про то, как разметить САМУ СТАТЬЮ - её заголовок, даты, вопросы-ответы. Если задача другая - разметить именно ТЕБЯ как человека и эксперта, чтобы машина не путала с однофамильцами, это разбирается отдельно в гайде как сделать, чтобы нейросети советовали тебя клиентам