← Гайды

text/markdown для ИИ-агентов: чистая версия страницы товара

Обновлено 2026-08-03

Что видит ИИ-агент вместо вашего товара

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

text/markdown решает это в лоб: вы отдаёте агенту чистую текстовую версию той же страницы — заголовок, описание, цену, наличие, условия доставки — без единого тега меню и без скриптов.

Почему чистый markdown работает лучше HTML

Боты делятся на два типа. Те, что исполняют JavaScript, ведут себя как люди в браузере. Те, что не исполняют — краулеры вроде GPTBot, ClaudeBot или PerplexityBot, — берут то, что сервер отдал сразу, без рендеринга. Для них весь ваш интерфейс это шум, а не помощь.

Чистый markdown даёт три вещи:

• Плотность смысла. На один товар вместо 300 КБ HTML уходит пара килобайт текста. Модель читает суть, а не вёрстку.
• Однозначную структуру. Заголовки, списки и таблица характеристик парсятся надёжнее, чем <div>-суп с классами.
• Ноль скриптов и попапов. Нечему ломаться при рендере, нечего пропускать.

В аудите Botmetria markdown это отдельная категория весом 20% — столько же, сколько весит обнаружение сайта, и больше, чем логистика или гигиена. Её проще всего поднять с нуля: почти никто markdown пока не отдаёт.

Как это работает: контент-негоциация

Механизм называется контент-негоциация (content negotiation). Агент присылает в запросе заголовок:

GET /product/nachos-crunch HTTP/1.1
Accept: text/markdown

Сервер видит Accept: text/markdown и вместо HTML отдаёт markdown с заголовком Content-Type: text/markdown. Тот же URL — другое представление. Обычный браузер просит text/html и получает привычную страницу. Это не клоакинг: контент один и тот же, отличается только формат.

Второй способ проще — .md-зеркала. Рядом с /product/nachos-crunch живёт /product/nachos-crunch.md с тем же содержимым в markdown. Такое зеркало легко открыть в браузере, проверить глазами и указать ссылкой в llms.txt.

Идеально сделать оба: негоциацию для агентов, которые умеют слать Accept, и .md-зеркало как запасной путь.

Мы отдаём markdown сами — и держим 100/100

Правило простое: не советуй того, чего не делаешь сам. botmetria.com отдаёт text/markdown по контент-негоциации на своих страницах. И в нашем же аудите категория markdown (те самые 20%) у нас показывает 100/100. Это dogfood-пруф — механизм рабочий, мы живём на нём сами.

Для контекста: по 63 магазинам Молдовы и Румынии медианный AI-readiness всего 38 из 100 — это красная зона (≤40). markdown в этой картине одна из самых недооценённых категорий: отдать чистый текст дешевле, чем переписывать всю логистику или чинить скорость.

Как включить за 20 минут

На WooCommerce проще всего через плагин Botmetria: он собирает markdown-версию каждой карточки товара и настраивает и негоциацию, и .md-зеркало автоматически, из тех же данных, что уже есть в товаре.

На кастомном сайте добавьте эндпоинт или сниппет, который на каждую карточку отдаёт markdown:

1. Соберите текст: # Название, абзац описания, строки Цена, Наличие, Доставка/возврат.
2. Отдавайте его при Accept: text/markdown и по адресу с суффиксом .md.
3. Ставьте заголовок ответа Content-Type: text/markdown; charset=utf-8.

Вот что должен получить агент:

# Начос Crunch 200 г
Кукурузные чипсы с морской солью.

**Цена:** 39 MDL
**Наличие:** в наличии
**Доставка:** 1–2 дня по Кишинёву, возврат 14 дней

Ту же цену и наличие полезно продублировать в JSON-LD Product: markdown агент читает как текст, а разметку — как машинные данные. Вместе они закрывают вопрос надёжно.

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

• Откройте .md-зеркало в браузере — должен быть чистый текст без шапки и меню.
• Проверьте негоциацию из терминала: curl -H "Accept: text/markdown" https://вашсайт/product/.... В ответе ждите Content-Type: text/markdown, а не text/html.
• Запустите бесплатный аудит Botmetria — категория markdown покажет балл и что именно чинить. Сравнить себя с рынком можно в рейтинге.

Частые ошибки

• Переименовать HTML в .md. Внутри всё та же вёрстка — толку ноль. Markdown должен быть настоящим текстом.
• Разный контент в HTML и markdown. Если цена в markdown отстала от страницы, агент назовёт неверную. Источник данных должен быть один.
• Забыть Content-Type. Без правильного заголовка агент не поймёт, что перед ним markdown, и обработает ответ как обычный текст или HTML.
• Заблокировать ботов, которым отдаёте markdown. Отдавать GPTBot markdown и тут же резать его в robots.txt — противоречие. Классические Googlebot/Bingbot при этом не трогайте никогда.

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