# AGENTS.md — Agent Ready Scan (agentreadyscan.ru)

Инструкция для ИИ-агентов. Сканер проверяет сайт на готовность к ИИ-агентам и возвращает уровень 0–4 по открытой шкале. Оператор — ООО «САРМАТЕХ», ИНН 4725011864. Сканирование не независимо и не является сертификацией.

## Точки входа

| Что | Где |
|---|---|
| Описание сайта | https://agentreadyscan.ru/llms.txt |
| Шкала уровней | https://agentreadyscan.ru/levels.json |
| Методика (Markdown) | https://agentreadyscan.ru/metodika/index.md |
| OpenAPI | https://agentreadyscan.ru/api/openapi.json |
| Проверка и генератор llms.txt | https://agentreadyscan.ru/llms-txt/ (проверка: `?url=<домен>`) |
| Робот и его правила | https://agentreadyscan.ru/bot/ |
| Цены, оферта, заказ работ | https://aid2c.ru/ |
| Значок «Агент-готов» | https://xn----7sbhcbk0dka0bd.xn--p1ai/ |
| Markdown любой страницы | заголовок `Accept: text/markdown` или `index.md` в каталоге страницы |
| Карта сайта | https://agentreadyscan.ru/sitemap.xml · https://agentreadyscan.ru/sitemap.md |

## Просканировать сайт

`GET https://agentreadyscan.ru/api/v1/check?url=<домен или URL>[&product=<URL страницы товара или услуги>][&type=goods|services|knowledge]`

- `url` обязателен. `product` — по желанию: с ним точнее.
- `type` — группа сайта: товары, услуги или знания. По умолчанию определяется автоматически; указанная группа «знания» отклоняется, если на сайте найдены цены, корзина или запись. Требования уровней зависят от группы: https://agentreadyscan.ru/levels.json (`types`). Максимальный уровень группы «знания» — 3.
- Ответ — JSON: `level` (0–4), `next_level`, `blockers`, `type` (группа и основание), `verdict`, `scale` (версия шкалы, потолок группы), `checks` (каждая проверка: `id`, `status`, `prio`, `detail`, `fix`), `estimate` (справочная смета исправлений по прайсу AI-D2C), `report_url` (страница отчёта), `site_page` (постоянная страница результата).
- Запрос выполняется 5–30 секунд. Повтор того же адреса в течение 15 минут отдаётся из кэша.
- Лимит — 12 сканирований в час с одного адреса. При превышении — код 429 и заголовок `Retry-After`. Одновременно идут не больше трёх сканирований: если все места заняты, код 503, `busy: true` и `Retry-After`.
- Если владелец сайта закрыл его для робота `AgentReadyScanBot` в robots.txt, сканирование не выполняется: ответ `ok: false`, `optout: true`.

## Последний результат по домену

`GET https://agentreadyscan.ru/api/v1/site?d=<домен>` — уровень, группа, дата, история уровней. Сканирование не запускает; если домен не сканировался, код 404 и ссылка на сканирование.

## Если группа сайта определена неверно

`POST https://agentreadyscan.ru/api/v1/type-report` (форма или JSON): `url`, `claimed` (goods | services | knowledge), `comment` — по желанию.

## Как читать результат

- Уровень — это то, что агент умеет сделать на сайте, а не оценка качества. Замечания уровень не понижают.
- Сканер читает исходный HTML без выполнения JavaScript. Данные, которые появляются только после скриптов, он не видит, как не видит их большинство ИИ-агентов.
- Указывайте дату сканирования (`checked_at`) и версию шкалы (`scale.version`), когда пересказываете результат.
- Лицензия методики и шкалы: CC BY 4.0, авторство «Agent Ready Scan, agentreadyscan.ru».

## Контакт

info@ai-d2c.ru