# LIMCARS для AI-агентов

Публичные машиночитаемые интерфейсы LIMCARS: Markdown, llms.txt, Schema.org и MCP с безопасными квотами.

Canonical: https://limcars.ru/docs/ai-agents
Source: https://limcars.ru/docs/ai-agents
Language: ru-RU

Публичные интерфейсы предназначены для пользовательских запросов, безопасного поиска каталога и расчёта импорта. Массовая выгрузка внешних площадок намеренно отсутствует.

## Markdown и discovery

- [Краткий llms.txt](https://limcars.ru/llms.txt)
- [Полное руководство](https://limcars.ru/llms-full.txt)
- [Канонические URL в sitemap](https://limcars.ru/sitemap.xml)

Любая публичная индексируемая HTML-страница поддерживает`Accept: text/markdown` и `?format=markdown`. Markdown-ответ не индексируется и ссылается обратно на канонический HTML.

## Публичный MCP

Канонический Streamable HTTP endpoint:[`https://limcars.ru/mcp`](https://limcars.ru/mcp). Он публикует карту сайта, чтение одной конкретной страницы и сопоставление полной ссылки Encar/Dongchedi с уже известной карточкой LIMCARS.

Описание endpoint также доступно как[JSON discovery](https://limcars.ru/.well-known/mcp.json). Адрес `https://limcars.ru/api/mcp/public` сохранён для совместимости с уже настроенными клиентами.

| Инструмент | Назначение |
| `public\_ping` | Проверить доступность |
| `site\_guide` | Получить карту публичных данных |
| `read\_public\_page` | Прочитать страницу в Markdown |
| `resolve\_source\_vehicle\_url` | Сопоставить полную ссылку источника |
| `begin\_user\_registration` | Начать безопасную регистрацию |
| `search\_vehicle\_inventory` | Искать автомобили Кореи и Китая |
| `calculate\_import\_cost` | Рассчитать импорт текстом или PNG |

| Операция | Квота |
| Все MCP-запросы | 60/мин, 500/сутки |
| Обычный инструмент | 30/час, 120/сутки |
| Чтение страницы | 12/час, 60/сутки |
| Ссылка Encar/Dongchedi | 3/час, 8/сутки; глобально 100/сутки |

## OAuth MCP

Персональный endpoint: `https://limcars.ru/api/mcp`. Он поддерживает OAuth discovery, CIMD и динамическую регистрацию MCP-клиента (DCR). Для Codex предпочтителен CIMD, а DCR остаётся fallback для клиентов, которые не поддерживают metadata documents. Клиент получает только свой профиль и связанные процессы импорта; сотрудник — только инструменты и записи, разрешённые его ролью и активными назначениями.

Неавторизованный запрос к этому endpoint намеренно получает`401` и заголовок `WWW-Authenticate`. Именно по нему Codex обнаруживает OAuth; JSON-описание обоих режимов находится в[MCP discovery](https://limcars.ru/.well-known/mcp.json).

- Клиент: профиль, процессы импорта, этапы, автомобиль, разрешённые документы и видимая геопозиция.
- Сотрудник: обзор требующей внимания работы, глобальный поиск, клиенты, полные карточки сделок, задачи, документы и полный фильтр каталога.
- Калькулятор KR/CN/JP/UAE использует актуальные курсы и активные настройки LIMCARS и умеет возвращать PNG.
- Зарегистрированные клиенты: 120 запросов/мин и 2000/сутки. Для сотрудников MCP rate limit отсутствует.

Регистрация начинается публичным инструментом`begin\_user\_registration`. Пользователь самостоятельно подтверждает телефон в браузере; агент не должен запрашивать код, cookie или OAuth token.

## Границы доступа

OAuth подтверждает личность, но не расширяет роль. Клиентская сделка проверяется через активную связь аккаунта с карточкой клиента. Для сотрудников дополнительно применяются RBAC, участие в сделке, document policy, scan status, финансовые разрешения и окна видимости GPS. Поэтому недоступная запись не подтверждает агенту даже факт своего существования.

## Почему нельзя массово перебирать ID

Инструмент сопоставления источника принимает только полную HTTPS-ссылку на разрешённый домен, не имеет batch или диапазонов и не обращается к каталогу внешней площадки. Поиск выполняется только по собственной базе LIMCARS и имеет ролевые размеры страницы.