sitemap, метаданные и JSON-LD: как агент понимает, кто вы
Прежде чем рекомендовать продукт, агент выясняет, что это, кто его делает и где документация. Часть ответов он берёт из разметки, а не из текста.
Зачем
- JSON-LD с типом Organization или SoftwareApplication даёт факты в машиночитаемом виде: название, сайт, контакты. Без него агент угадывает по тексту.
- sitemap.xml в robots.txt — карта сайта, по которой агент находит нужные страницы, не обходя всё.
- Ссылка с главной на документацию API — самый короткий путь для агента, который пришёл интегрироваться.
Что сделать
- 1
JSON-LD на главной
Добавьте Organization (или SoftwareApplication для продукта) с name, url, description и контактами.
<script type="application/ld+json"> {"@context":"https://schema.org","@type":"Organization", "name":"Компания","url":"https://example.ru", "description":"Что делаем","contactPoint":{"@type":"ContactPoint","email":"sales@example.ru"}} </script> - 2
sitemap в robots.txt
Укажите адрес карты сайта строкой Sitemap: в robots.txt.
Sitemap: https://example.ru/sitemap.xml - 3
Метаданные и ссылка на документацию
У главной — title, meta description, canonical и lang у <html>. В шапке или подвале — ссылка на документацию API, если она есть.
Что проверяет сканер
Есть карта сайта
sitemap.xml — список страниц. По нему агент находит разделы, до которых не добрался по ссылкам.
Заполнены метаданные главной
Заголовок, описание, основной адрес страницы и язык. По ним агент понимает, что это за сайт.
Есть разметка о компании или продукте
JSON-LD — данные о компании в формате для программ: название, адрес сайта, тип продукта.
С главной есть ссылка на документацию API
Если агента просят настроить интеграцию, он ищет документацию от главной страницы.
Заполнены данные для превью страницы
Заголовок, описание, картинка и тип страницы (Open Graph). Ассистент берёт их, когда показывает ссылку на вас.
В разметке компании есть описание и контакты
По описанию, логотипу и контактам в разметке ассистент убеждается, что это настоящая компания, прежде чем её советовать.
Разметка ссылается на официальные профили
Ссылки sameAs на GitHub, соцсети и магазины приложений. По ним ассистент понимает, что упоминания в разных местах — про вас.
С главной видны страницы о компании, контакты и политика
Агент проверяет эти страницы, чтобы убедиться, что сайту можно доверять.
В карте сайта указаны даты обновления
По датам агент и поиск понимают, какие страницы изменились и что стоит перечитать.
Цены есть в разметке
Цена и валюта в данных для программ. Ассистент берёт их оттуда точно, а не вычитывает из текста страницы.
Вопросы и ответы размечены
Блок частых вопросов в разметке — готовые пары «вопрос — ответ», которые ассистент может процитировать.
Проверьте свой сайт
Вставьте адрес и получите такой же разбор за полминуты.
Источники
Другие гайды
- Сайт открывается агенту: без капчи, без JavaScript, с честным 404
- robots.txt для нейросетей: YandexAdditional, GPTBot, ClaudeBot и Content-Signal
- llms.txt и llms-full.txt: что это и нужно ли вашему сайту
- Markdown для ИИ-агентов: .md-версии страниц и Accept: text/markdown
- API и MCP для агентов: OpenAPI, MCP Server Card, OAuth discovery