# LIMCARS

> LIMCARS подбирает, проверяет, покупает и доставляет автомобили из Южной Кореи и Китая в Россию. Сайт содержит каталоги автомобилей, расчёты ориентировочной стоимости, сведения о процессе импорта и редакционные материалы на русском языке.

Используйте канонические человекочитаемые URL. Параметры фильтров и рекламные параметры не образуют отдельные страницы. Для Markdown-представления любой публичной индексируемой HTML-страницы отправьте заголовок `Accept: text/markdown` или добавьте `?format=markdown`. Данные каталога и цены меняются; проверяйте дату и предупреждение о том, что расчёт не является публичной офертой.

## Основные разделы

- [Главная](https://limcars.ru/): услуги, процесс работы и контакты
- [Автомобили из Кореи](https://limcars.ru/korea): каталог корейских автомобилей
- [Автомобили из Китая](https://limcars.ru/china): каталог китайских автомобилей
- [Новые автомобили из Кореи](https://limcars.ru/korea/new): каталог новых моделей, когда раздел включён
- [Автоблог](https://limcars.ru/autoblog): новости и обзоры
- [Статьи](https://limcars.ru/articles): статьи о выборе, покупке и импорте автомобилей
- [О компании](https://limcars.ru/about): сведения о LIMCARS
- [Контакты](https://limcars.ru/contacts): способы связи
- [Онлайн-заявка](https://limcars.ru/online-application): запрос на подбор автомобиля

## Машиночитаемые интерфейсы

- [Полное руководство для LLM](https://limcars.ru/llms-full.txt): терминология, ограничения и правила цитирования
- [Sitemap](https://limcars.ru/sitemap.xml): канонические индексируемые страницы
- [Robots](https://limcars.ru/robots.txt): правила обхода поисковыми роботами
- [RSS](https://limcars.ru/feed.xml): последние материалы автоблога и раздела статей
- [Публичный MCP](https://limcars.ru/mcp): канонический Streamable HTTP MCP 2026-07-28 с совместимостью с stateless transport 2025
- [MCP discovery JSON](https://limcars.ru/.well-known/mcp.json): endpoint, возможности и список публичных инструментов
- [OAuth MCP](https://limcars.ru/api/mcp): персональные инструменты клиентов и сотрудников с динамической регистрацией MCP-клиента
- [Документация публичного MCP](https://limcars.ru/docs/ai-agents): назначение инструментов и квоты

## Ограничения

- Не используйте закрытые разделы `/japan`, `/personal`, `/manager`, `/mcp/consent` и `/ophran`.
- Не рассматривайте цену в карточке как окончательную оферту.
- Не пытайтесь перечислять ID внешних площадок. Инструмент `resolve_source_vehicle_url` принимает только полную ссылку, предоставленную пользователем, и строго ограничивает частоту таких запросов; для обычного поиска используйте `search_vehicle_inventory`.


## Как читать страницы

HTML остаётся каноническим представлением для поисковых систем и людей. Markdown — альтернативное, неиндексируемое представление того же SSR-контента. В нём удалены формы, кнопки, навигация, скрипты и декоративные элементы, но сохранены заголовки, основной текст, списки, таблицы, изображения и ссылки. Ответ имеет `Content-Type: text/markdown; charset=utf-8`, `Content-Location` с каноническим URL и `X-Robots-Tag: noindex, follow`.

Примеры:

- `curl -H 'Accept: text/markdown' https://limcars.ru/korea/mercedes-benz`
- `https://limcars.ru/autoblog?format=markdown`

## Канонические URL

- Страна: `/korea` или `/china`.
- Марка: `/{country}/{brand-slug}`.
- Модель: `/{country}/{brand-slug}/{model-slug}`.
- Корейский лот: `/korea/car/{opaque-slug}`.
- Китайский лот: `/china/car/{lot}`.
- Материал: `/autoblog/{slug}` или `/articles/{slug}`.

Страницы с `manufacturerId`, `modelId`, UTM, `yclid`, `etext` и подобными параметрами должны трактоваться как варианты канонического URL без этих параметров. Для перечисления опубликованных URL используйте sitemap, а не подбор числовых ID.

## Семантика данных

Публичные страницы включают JSON-LD Schema.org. На всех страницах доступны сущности `Organization`, `AutomotiveBusiness`, `WebSite` и `WebPage`; страницы с хлебными крошками содержат `BreadcrumbList`; статьи — `Article`; карточки автомобилей — `Vehicle`, `Product` и `Offer`; видимые FAQ-блоки каталога — `FAQPage`.

## Значение автомобильных данных

- Цена в рублях обычно означает ориентировочную стоимость во Владивостоке с ПТС, если на странице не указано иное.
- Для Китая при отсутствии полного импортного расчёта может отображаться цена автомобиля в юанях до импорта.
- Пробег, год, двигатель, привод, коробка и кузов относятся к конкретному лоту.
- Архивный или проданный лот может сохраняться как справочная страница.
- Фактическую доступность и финальную цену подтверждает менеджер LIMCARS.

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

Канонический endpoint: `https://limcars.ru/mcp`. Старый адрес `https://limcars.ru/api/mcp/public` сохранён как совместимый алиас.

Публичный сервер предназначен для точечных пользовательских действий:

- получить руководство по сайту;
- прочитать конкретную публичную страницу в Markdown;
- сопоставить полную ссылку Encar или Dongchedi с уже известной карточкой LIMCARS.
- начать регистрацию пользователя через ссылку, на которой пользователь самостоятельно подтверждает телефон;
- искать опубликованные автомобили Кореи и Китая по тексту и структурным фильтрам;
- рассчитывать импорт из Кореи, Китая, Японии и ОАЭ по тем же формулам, курсам и активным настройкам, что использует калькулятор LIMCARS; результат доступен текстом и PNG.

Публичный поиск выдаёт не более 20 записей на страну за запрос и не раскрывает внутренние поля. Он не предоставляет перебор внешних ID или массовую выгрузку базы. Для клиентских и рабочих данных используется OAuth-защищённый endpoint `https://limcars.ru/api/mcp`.

## Регистрация и OAuth MCP

Для подключения к `https://limcars.ru/api/mcp` используйте OAuth discovery:

- protected resource metadata: `https://limcars.ru/.well-known/oauth-protected-resource/api/mcp`;
- authorization server metadata: `https://limcars.ru/.well-known/oauth-authorization-server/api/auth`;
- required scope: `mcp:tools` вместе с `openid profile offline_access`;
- для Codex предпочтителен CIMD; динамическая регистрация MCP-клиентов (DCR) остаётся доступна как fallback.

Не используйте обычный GET защищённого endpoint как документацию: без token он намеренно отвечает `401` с `WWW-Authenticate`. Общее описание обоих серверов находится в `https://limcars.ru/.well-known/mcp.json`.

Новый пользователь начинает регистрацию инструментом `begin_user_registration`. Агент открывает возвращённую ссылку в браузере пользователя; пользователь сам подтверждает номер телефона. Никогда не просите пересылать агенту код подтверждения, OAuth code, cookie или access token.

## Инструменты зарегистрированного клиента

- `client_whoami` — профиль, подтверждённые контакты, реферальный уровень и балансы текущего аккаунта.
- `client_imports_list` — список только тех процессов импорта, которые связаны с подтверждённым аккаунтом. Первый вызов может идемпотентно создать связь по единственному точному совпадению подтверждённого телефона; неоднозначное совпадение остаётся закрытым до ручной проверки.
- `client_import_details` — автомобиль, публичная шкала этапов, разрешённые документы и видимая клиенту геопозиция по одной своей сделке.
- `search_vehicle_inventory` — публичные поля каталога, до 50 записей на страну за запрос.
- `calculate_import_cost` — расчёт импорта текстом, PNG или обоими форматами.

Клиентские квоты выше публичных: 120 запросов/минуту и 2000/сутки; для операций действуют отдельные увеличенные квоты. Любой запрос чужого `dealId` должен трактоваться как недоступный, а не как подтверждение существования записи.

## Инструменты сотрудника

Состав инструментов формируется для каждой роли. Отсутствующий инструмент означает отсутствие соответствующего доступа.

- `employee_access_manifest` — вычисленная карта доступных разделов.
- `employee_work_overview` — доступные сотруднику задачи, документы и сделки, требующие внимания.
- `employee_global_search` — поиск клиентов, сделок, договоров, промокодов и обращений; группы автоматически отсекаются по RBAC.
- `employee_clients_list` и `employee_client_get` — реестр и карточка клиента в разрешённом record scope.
- `employee_deals_search` и `employee_deal_get` — фильтры, курсорная пагинация и составная карточка сделки с рабочим пространством. Финансовые поля выдаются только ролям с отдельным разрешением.
- `employee_tasks` — свои задачи; режим `all` работает только для Admin/Supervisor.
- `employee_documents` — документы после проверки роли участника, document policy, состояния и scan status.
- `search_vehicle_inventory` — полный поиск корейских и китайских лотов с внутренними полями, всеми фильтрами и пакетами до 500 записей на страну.
- `calculate_import_cost` — тот же общий калькулятор импорта.

Для сотрудников MCP rate limit отсутствует. Большие результаты всё равно возвращаются страницами, чтобы один ответ не перегружал транспорт и контекст агента. Admin/Supervisor получают глобальный record scope там, где это разрешено доменной политикой; остальные роли видят только назначенные им сделки и связанных клиентов.

## Автоблог и статьи через MCP

При доступе к менеджерскому разделу autoblog защищённый MCP предоставляет:

- `employee_autoblog_list` — список опубликованных статей и черновиков, поиск и пагинация.
- `employee_autoblog_get` — все поля, точные content-блоки и Markdown по id или slug.
- `employee_autoblog_create` — создание статьи, по умолчанию черновика.
- `employee_autoblog_update` — частичные правки, публикация и снятие с публикации через isPublished. Передавайте expectedUpdatedAt из свежего get; при конфликте перечитайте статью и согласуйте изменения.
- `employee_autoblog_upload_image` — фото в base64 (JPEG/PNG/WebP/AVIF, максимум 5 МиБ). Как в админке: обрезка 16:9 по центру, ширина до 696 px без увеличения, AVIF quality 72. Возвращённый imageSrc передайте в create/update для обложки, Markdown — вставьте в текст. Загрузка сама по себе статью не меняет. URL и локальные пути не принимаются.
- `employee_autoblog_convert_image` — конвертация одной старой обложки; без id берёт следующую из очереди. Массовую обработку запускайте только по явному запросу.

Разметка совпадает с редактором: абзацы через пустую строку, ## заголовки, ссылки [текст](URL), изображения ![alt](URL), URL поддерживаемого видео отдельным блоком. Для точного сохранения структуры используйте content; не передавайте content и markdown одновременно. Публикуйте только по запросу пользователя; действуют те же проверки качества, что в админке. Удаления статей нет ни в редакторе, ни в MCP — используйте снятие с публикации. Авторизация не даёт доступ к автоблогу ролям без права на этот раздел.

## Вход calculate_import_cost

Основные поля: `country` = `KR | CN | JP | UAE`, цена в валюте страны или EUR, `car_year`, `eVolume`, `fuel`, `powerHP`, `weight`, `vehicleType`, `calcType`, вариант доставки и `output` = `text | image | both`. Если параметров недостаточно, сначала уточните их у пользователя. Не подставляйте нулевую цену и не переносите курс или расчёт между разными странами.

## Вход search_vehicle_inventory

Поддерживаются страна, свободный текст, марка, модель, диапазоны года, пробега, итоговой цены, объёма и мощности, топливо, коробка, привод, кузов, состояние, статус, сортировка, страница и размер страницы. Поле `status` и внутренние идентификаторы доступны только сотрудникам. Для `country=all` ответ содержит отдельные секции Кореи и Китая со своей пагинацией.

## Цитирование и свежесть

При ответе пользователю указывайте канонический URL страницы. Для автомобиля сообщайте, что цена ориентировочная, если страница прямо не говорит об обратном. Для меняющихся условий импорта, ставок и сроков сохраняйте дату получения ответа и не переносите цифры между разными лотами или странами.

## Язык и контакты

Основной язык — русский. Клиентская поддержка: +7 999 024-07-07, Telegram: https://t.me/limcars_admin, общие социальные каналы перечислены в JSON-LD организации и на странице контактов.