# sitemap, метаданные и JSON-LD: как агент понимает, кто вы

> sitemap.xml, title, description, canonical, lang и JSON-LD Organization: базовая разметка, по которой ИИ-агент понимает, что за компания и продукт перед ним.

Источник: https://pachca.com/agent-ready/guide/structured-data

Прежде чем рекомендовать продукт, агент выясняет, что это, кто его делает и где документация. Часть ответов он берёт из разметки, а не из текста.

## Зачем

- JSON-LD с типом Organization или SoftwareApplication даёт факты в машиночитаемом виде: название, сайт, контакты. Без него агент угадывает по тексту.
- sitemap.xml в robots.txt — карта сайта, по которой агент находит нужные страницы, не обходя всё.
- Ссылка с главной на документацию API — самый короткий путь для агента, который пришёл интегрироваться.

## Что сделать

1.  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.  2

    ### sitemap в robots.txt

    Укажите адрес карты сайта строкой Sitemap: в robots.txt.

    ```
    Sitemap: https://example.ru/sitemap.xml
    ```

3.  3

    ### Метаданные и ссылка на документацию

    У главной — title, meta description, canonical и lang у <html>. В шапке или подвале — ссылка на документацию API, если она есть.

## Что проверяет сканер

- Есть карта сайта

    sitemap.xml — список страниц. По нему агент находит разделы, до которых не добрался по ссылкам.

- Заполнены метаданные главной

    Заголовок, описание, основной адрес страницы и язык. По ним агент понимает, что это за сайт.

- Есть разметка о компании или продукте

    JSON-LD — данные о компании в формате для программ: название, адрес сайта, тип продукта.

- С главной есть ссылка на документацию API

    Если агента просят настроить интеграцию, он ищет документацию от главной страницы.

- Заполнены данные для превью страницы

    Заголовок, описание, картинка и тип страницы (Open Graph). Ассистент берёт их, когда показывает ссылку на вас.

- В разметке компании есть описание и контакты

    По описанию, логотипу и контактам в разметке ассистент убеждается, что это настоящая компания, прежде чем её советовать.

- Разметка ссылается на официальные профили

    Ссылки sameAs на GitHub, соцсети и магазины приложений. По ним ассистент понимает, что упоминания в разных местах — про вас.

- С главной видны страницы о компании, контакты и политика

    Агент проверяет эти страницы, чтобы убедиться, что сайту можно доверять.

- В карте сайта указаны даты обновления

    По датам агент и поиск понимают, какие страницы изменились и что стоит перечитать.

- Цены есть в разметке

    Цена и валюта в данных для программ. Ассистент берёт их оттуда точно, а не вычитывает из текста страницы.

- Вопросы и ответы размечены

    Блок частых вопросов в разметке — готовые пары «вопрос — ответ», которые ассистент может процитировать.

Проверьте свой сайт

Вставьте адрес и получите такой же разбор за полминуты.

[Проверить сайт →](https://pachca.com/agent-ready)

## Источники

- [schema.org: Organization](https://schema.org/Organization)
- [sitemaps.org](https://www.sitemaps.org/protocol.html)

## Другие гайды

- [Сайт открывается агенту: без капчи, без JavaScript, с честным 404](https://pachca.com/agent-ready/guide/site-access)
- [robots.txt для нейросетей: YandexAdditional, GPTBot, ClaudeBot и Content-Signal](https://pachca.com/agent-ready/guide/robots-txt)
- [llms.txt и llms-full.txt: что это и нужно ли вашему сайту](https://pachca.com/agent-ready/guide/llms-txt)
- [Markdown для ИИ-агентов: .md-версии страниц и Accept: text/markdown](https://pachca.com/agent-ready/guide/markdown)
- [API и MCP для агентов: OpenAPI, MCP Server Card, OAuth discovery](https://pachca.com/agent-ready/guide/api-mcp)