ИИ-агент правит шаблон, переносит блоки, меняет структуру страницы — и незаметно ломает schema.org-разметку, которую вы настраивали вручную или добавляли тем же вайбкодингом раньше. Поисковики перестают показывать звёздочки, цены и хлебные крошки в выдаче. В этой статье — конкретный порядок проверки микроразметки после каждой итерации с ИИ-агентом, типичные места поломок и как их чинить без глубокого погружения в код.
Почему вайбкодинг ломает микроразметку чаще, чем кажется
ИИ-агент работает с кодом файл за файлом. Он видит текущий контекст, но не всегда «помнит», что вы добавляли разметку schema.org три сессии назад в другом шаблоне. Claude Code, Cursor и подобные инструменты умеют делать согласованные правки по многим файлам, но только если явно попросить их следить за структурой JSON-LD или микроданными (Хабр). Без такой инструкции агент спокойно перепишет <div itemscope> в семантический <section>, потеряв атрибут, или перенесёт блок цены так, что itemprop="price" окажется вне родительского itemscope.
Ещё одна причина — рефакторинг после вайбкодинга. Как только проект набирает массу, появляется запрос на «почистить код». Разработчик или агент удаляет «лишние» атрибуты, не понимая, что они нужны поисковику, а не браузеру. Результат — страница визуально не изменилась, зато расширенный сниппет в Google пропал.
Что именно ломается: три самых частых места
Первое — JSON-LD в <head>. Агент переносит скрипты, меняет порядок тегов или дублирует блок при слиянии шаблонов. Поисковик получает два конкурирующих объекта Product или LocalBusiness на одной странице.
Второе — microdata-атрибуты на HTML-элементах. При переходе с таблиц на flexbox или при адаптивной вёрстке агент часто перекидывает содержимое в новые теги, забывая перенести itemprop. Цена остаётся в коде, но уже не внутри itemscope — поисковик её не видит.
Третье — Open Graph и Twitter Card. Это не schema.org, но поисковики и ИИ-боты тоже читают эти мета-теги. ИИ-агент при работе с <head> нередко удаляет «непонятные» og:image или меняет og:type на дефолтный website, убирая более точный тип.
Как проверить микроразметку: пошаговый порядок
Проверку удобно встроить прямо в рабочий цикл с агентом — до коммита, а не после деплоя.
- Rich Results Test от Google. Вставьте URL страницы или HTML-код. Инструмент покажет, какие объекты schema.org он нашёл, какие поля заполнены корректно, а какие вызывают предупреждение. Удобно проверять прямо на staging-версии.
- Schema Markup Validator (validator.schema.org). Строже, чем тест Google. Проверяет соответствие спецификации schema.org без поправки на то, что «Google всё равно поймёт». Используйте для финальной проверки перед публикацией.
- Поиск по коду через grep или поиск в IDE. После каждой сессии с агентом выполните поиск по строкам
itemscope,itemprop,application/ld+json. Убедитесь, что количество вхождений совпадает с тем, что было до правок. Если агент что-то удалил — сразу видно. - Diff перед коммитом. Просматривайте изменения в файлах шаблонов целиком, а не только в той части, которую агент пометил как изменённую. Микроразметка часто живёт в соседних строках с правками.
Если вы работаете с Claude Code — сохраняйте чекпоинты перед каждым сообщением агенту. При поломке можно откатиться к нужному состоянию через /rewind, выбрать сообщение, с которого всё пошло не так, и вернуть файлы или весь разговор (smyslokod.ru). Это занимает меньше минуты и страхует от ситуации, когда правки уже в трёх файлах и вручную не разобраться.
Как объяснить агенту, чтобы он не трогал разметку
Самый надёжный способ — явно запретить в системных инструкциях. В файле CLAUDE.md можно указать правила, которые агент будет соблюдать при каждой правке: не удалять атрибуты itemprop и itemscope, не переносить блоки с JSON-LD без явной команды, не трогать содержимое тегов <script type="application/ld+json">.
Пример инструкции для CLAUDE.md:
## Микроразметка
- Не удалять и не изменять атрибуты itemscope, itemprop, itemtype.
- Не трогать теги <script type="application/ld+json"> без явной команды.
- При переносе HTML-блока сохранять все data-атрибуты и атрибуты schema.org.
Это не гарантия на сто процентов, но агент начнёт спрашивать перед удалением, а не молча чистить «лишнее».
Таблица: чем проверять и что ловит каждый инструмент
| Инструмент | Что проверяет | Когда использовать |
|---|---|---|
| Google Rich Results Test | Schema.org, пригодность к расширенным сниппетам | После каждой сессии агента на страницах с товарами, отзывами, событиями |
| Schema Markup Validator | Соответствие спецификации schema.org | Финальная проверка перед публикацией |
| Open Graph Debugger (Facebook) | og: теги, og:image, og:type | При правках в <head> или шаблоне мета-тегов |
| grep / поиск в IDE | Количество и положение атрибутов в коде | Сразу после diff, до коммита |
| /rewind в Claude Code | Возврат к чекпоинту до правок агента | Когда разметка сломана и непонятно в каком файле |
Типичные ошибки при работе с ИИ-агентом и микроразметкой
- Проверять разметку только визуально — браузер отображает страницу корректно даже без
itemscope. - Давать агенту задачу «оптимизируй шаблон» без ограничений — агент считает атрибуты schema.org устаревшим мусором.
- Не делать чекпоинт перед сессией с агентом и потом тратить час на ручной откат.
- Забывать про страницы с динамической разметкой: карточки товаров, посты блога, страницы услуг — агент правит шаблон, и поломка попадает сразу на все страницы.
- Доверять только одному валидатору — Google Rich Results Test и Schema Markup Validator иногда расходятся в оценке одного и того же кода.
Перед тем как отдавать агенту крупную задачу с переработкой шаблонов, стоит подготовить откат сайта заранее — это занимает пять минут и снимает риск часовой отладки после деплоя.
3 шага, которые можно сделать сегодня:
- Откройте Google Rich Results Test и проверьте три главные страницы сайта — главную, карточку товара или услуги, страницу контактов. Запишите, какие объекты schema.org сейчас распознаются.
- Добавьте в CLAUDE.md (или аналогичный файл инструкций вашего инструмента) явный запрет трогать атрибуты itemscope, itemprop и блоки JSON-LD без команды.
- Настройте grep-поиск по ключевым строкам микроразметки и запускайте его как часть проверки diff перед каждым коммитом после сессии с агентом.



