--- name: cars4me-irkutsk-rental-search description: Проверка наличия и стоимости аренды автомобилей Cars4me в Иркутске через публичный API или WebMCP с явными датами и отдельным залогом. --- # Cars4me — инструкция по API поиска автомобилей Выпуск документации 1.5.5; API 1.5.0. Обзор: https://cars4me.ru/developers/ · OpenAPI: https://cars4me.ru/openapi.json · Краткая навигация: https://cars4me.ru/llms.txt Публичные действия расчёта только читают наличие и стоимость. Они не создают бронь, не принимают оплату и не передают контакты. WebMCP работает внутри совместимого браузера; отдельный серверный MCP-эндпоинт этим выпуском не заявлен. Этот API используется для проверки наличия и расчёта аренды на cars4me.ru, Иркутск. Для поиска используйте c4m_public_booking_quote (один автомобиль) или c4mcat_quote_batch (пакет автомобилей). Полные правила бронирования: https://cars4me.ru/llms-full.txt. ## Подтверждённая готовность для ИИ — 16 ноября 2026 Agentic Browsing: 6/6 оцениваемых проверок пройдены. Справочная проверка WebMCP tools registered показывает четыре инструмента и не входит в знаменатель. PageSpeed Insights, главная https://cars4me.ru/, мобильный замер 2026-11-16T05:42:15+08:00: Lighthouse 13.6.0, Moto G Power, Slow 4G. Performance, Accessibility, Best Practices и SEO — 100/100 каждый; Speed Index 2,1 с, LCP 1,2 с, Total Blocking Time 0 мс, CLS 0. Отчёт: https://pagespeed.web.dev/analysis/https-cars4me-ru/vxpag2v290?form_factor=mobile Обнаружены четыре инструмента: search_available_cars, get_rental_quote, search_selected_rental_period и request_callback_home. Поиск и расчёт не создают бронь; request_callback_home отправляет контакты только после согласия и подтверждения пользователя. На домене установлен токен WebMCP Origin Trial для https://cars4me.ru и его поддоменов. Срок токена — до 30 марта 2027, 00:00 UTC; испытание может завершиться раньше. Доступность WebMCP зависит от версии и поддержки браузера. Публичный HTTP API доступен независимо от WebMCP. Результат относится к указанной странице и замеру; это техническая проверка, а не сертификация или гарантия позиций в поиске. Speed Index измеряет визуальную загрузку, а не скорость индексации поисковиками. ## Шаг 1. Подготовьте период аренды Уточните у клиента даты и время получения и возврата. Часовой пояс: Asia/Irkutsk (UTC+08:00). Формат: YYYY-MM-DDTHH:MM. Пример: 2026-11-24T12:00. Передавайте местное время без Z и без перевода в UTC. Получение должно быть не в прошлом, возврат — позже получения. Максимальный период текущего интерфейса — 370 суток. ## Шаг 2. Получите JSON-каталог GET https://cars4me.ru/wp-admin/admin-ajax.php?action=c4m_agent_catalog_v1 Проверьте HTTP 200 и success=true. В data должны быть api_version="1", origin="https://cars4me.ru", timezone="Asia/Irkutsk", environment="production", test_only=false. data.cars содержит car_id, name, url, brand, transmission, seats, drive, year, category и image (url/alt/width/height либо null). count должен совпадать с длиной cars. Каталог использует тот же источник, что и сайт; фотографии — публичные обложки. Внутренние данные автомобиля не публикуются. Каталог не утверждает наличие на даты и не содержит итоговой цены. Для этого обязателен расчёт. При ошибке наличие неизвестно. Используйте только ID и URL этой среды. ## Шаг 3. Получите nonce в JSON POST https://cars4me.ru/wp-admin/admin-ajax.php Content-Type: application/x-www-form-urlencoded action=c4m_agent_quote_context_v1 При success=true возьмите data.nonce и data.quote_url. Разрешённые действия data.quote_actions: c4m_public_booking_quote и c4mcat_quote_batch. Это nonce существующего публичного расчёта, а не ключ аккаунта. Вход в аккаунт не требуется. Токен связан с действием и текущим сеансом WordPress. Сохраняйте одну cookie-сессию для контекста и расчёта; при смене сеанса получите новый токен. Не переносите nonce между доменами. Токен не одноразовый. refresh_after_seconds=300 — рекомендация обновления, а не гарантия срока действия. Перед новым циклом или спустя 5 минут получите свежий контекст. При HTTP 403 обновите nonce и повторите один раз. При повторной ошибке остановитесь; не подменяйте ошибку выдуманным наличием. Каталог: до 120 запросов/минуту с IP; контекст: до 60 запросов/минуту с IP. При 429 новые точки возвращают Retry-After. Лимит существующего калькулятора остаётся отдельным. Ответы контекста не кэшируются. Прежний способ получения nonce из публичной карточки сохранён для совместимости, но новым интеграциям разбор HTML не требуется. ## Шаг 4. Отправьте запрос расчёта Метод: POST на ajaxUrl. Адрес: https://cars4me.ru/wp-admin/admin-ajax.php Content-Type: application/x-www-form-urlencoded Accept: application/json Передайте: | Параметр | Значение | | --- | --- | | action | c4m_public_booking_quote | | nonce | data.nonce из JSON-контекста | | car_id | Идентификатор из каталога | | price_id | 0 для первоначального расчёта | | pickup_at | Дата и время получения | | return_at | Дата и время возврата | | pickup_delivery | 1 — платная подача при получении; 0 — офис | | return_pickup | 1 — платный забор при возврате; 0 — офис | | optional_ids[] | Повторяемый параметр с ID услуги из optionals; не CSV. Без параметра — без дополнительных опций | Пример запроса. Замените CURRENT_NONCE значением data.nonce из JSON-контекста, а автомобиль и период — данными клиента: ```bash curl 'https://cars4me.ru/wp-admin/admin-ajax.php' \ -H 'Accept: application/json' \ --data-urlencode 'action=c4m_public_booking_quote' \ --data-urlencode 'nonce=CURRENT_NONCE' \ --data-urlencode 'car_id=10' \ --data-urlencode 'price_id=0' \ --data-urlencode 'pickup_at=2026-11-24T12:00' \ --data-urlencode 'return_at=2026-11-26T12:00' ``` Прочитайте выбранный тариф в tariff_name. Чтобы рассчитать другой тариф, возьмите его price_id из массива tariffs и повторите запрос. Для услуг сначала получите массив optionals, сопоставьте название услуги с просьбой клиента, затем повторите расчёт с выбранными optional_ids[]. Например, детское кресло выбирайте по name и id текущего автомобиля. Для нескольких услуг передайте optional_ids[]=1&optional_ids[]=2, а не optional_ids=1,2. Проверьте, что selected_optionals точно совпадает с запросом, а selected_price_id — с запрошенным тарифом. Публичный расчёт может игнорировать неизвестный ID; такой ответ нельзя считать подтверждением выбора. Для выдачи у терминала аэропорта задайте pickup_delivery=1; для возврата там же — return_pickup=1. Сам текст адреса без этих флагов не включает платный выезд в расчёт. Точное место и адрес добавляются в ссылку. Доплаты за вечер, ночь, выходной/праздник рассчитываются сервером отдельно для каждой операции по pickup_at и return_at. Не прибавляйте их к total повторно. ## Шаг 5. Прочитайте результат Принимайте успешный HTTP-ответ с JSON и success=true. Данные расчёта находятся в data. Сверьте car_id, pickup_at и return_at с запросом. Затем проверьте available: - true — автомобиль доступен на этот период; - false — автомобиль недоступен; - значение отсутствует или ответ некорректен — наличие не установлено. Цена может присутствовать и при available=false. Такой автомобиль не предлагайте как свободный. Для доступного автомобиля прочитайте: | Поле data | Значение | | --- | --- | | car_name | Название автомобиля | | days | Расчётные сутки | | tariff_name | Выбранный тариф | | daily_mileage | Лимит пробега в сутки | | rental_total | Аренда за весь период | | service_lines | Учтённые услуги: label и amount | | services_total | Сумма выездов и доплат за время/день | | tariffs, selected_price_id | Доступные тарифы и выбранный тариф | | optionals, selected_optionals | Доступные дополнительные опции и подтверждённые ID | | optional_lines, optionals_total | Названия и стоимость выбранных опций | | total | Итог аренды и учтённых услуг | | deposit | Залог отдельно | Суммы должны быть конечными неотрицательными числами. Все суммы — в рублях. Не прибавляйте услуги повторно к total. Не включайте deposit в стоимость аренды и не называйте его аккредитивом. Аккредитив указывайте по условиям сайта. Для каждого другого автомобиля или изменённого периода выполняйте новый расчёт. Пакетный запрос возвращает отдельный результат для каждого автомобиля. Сохраняйте время получения результата. ## Шаг 6. Сформируйте ссылку клиенту Берите готовый `url` из успешного `get_rental_quote`: он содержит весь подтверждённый выбор. Для ручной сборки используйте адрес карточки из текущего каталога и URLSearchParams. Передавайте по одному значению каждого параметра: | Параметр URL | Значение | | --- | --- | | first_date, first_time | Дата YYYY-MM-DD и время HH:MM получения, Asia/Irkutsk | | second_date, second_time | Дата и время возврата в том же формате | | c4m_selection | 1 — полный набор выбора; отсутствующие услуги не наследуются из старых настроек браузера | | pickup_place | office, airport или address | | return_place | office, airport или address | | pickup_delivery | 0 для офиса; 1 для аэропорта/доставки по адресу | | return_pickup | 0 для офиса; 1 для аэропорта/забора по адресу | | pickup_address, return_address | Адрес соответствующего выезда; пусто для офиса. Для airport автоматически подставляется «Аэропорт Иркутска, у терминала прилёта» | | selection_car | car_id выбранного автомобиля | | price_id | selected_price_id из успешного расчёта | | optional_ids | selected_optionals из расчёта через запятую; пустая строка означает отсутствие допуслуг | Пример формата (не подтверждение наличия): Kia Rio, получение 24.11.2026 в 22:00 у терминала аэропорта, возврат 26.11.2026 в 12:00 в офисе, тариф 6, детское кресло с ID 1: https://cars4me.ru/prokat-avto/kia-rio/?first_date=2026-11-24&first_time=22%3A00&second_date=2026-11-26&second_time=12%3A00&c4m_selection=1&pickup_place=airport&return_place=office&pickup_delivery=1&return_pickup=0&selection_car=3&price_id=6&optional_ids=1 Замените автомобиль, период, тариф и ID услуг данными свежего расчёта. ID услуг не угадывайте и не переносите без проверки на другой автомобиль. При смене автомобиля общие места сохраняются, а тариф и услуги другого автомобиля сбрасываются. Откройте готовую ссылку: проверьте автомобиль, обе даты и время, места, адреса, выбранный тариф, галочки услуг и новый итог. Ссылка восстанавливает выбор, но не фиксирует цену и наличие и не создаёт бронь. Неверный или недоступный тариф/услуга требует исправления выбора; не выдавайте такой результат за подтверждённый. Для каталога используйте тот же период и места, добавив c4m_search=1. Не включайте в ссылку nonce, имя, телефон, email, паспортные данные или платёжные данные. Адрес доставки включайте только когда клиент сам выбрал его и согласовал передачу ссылки; для аэропорта достаточно airport. ## Шаг 7. Передайте клиенту предложение Укажите: - автомобиль и подходящие характеристики; - период по местному времени Иркутска; - места получения и возврата; - итог total и включённые услуги; - залог deposit отдельно; - аккредитив по условиям сайта; - время проверки; - ссылку с полным выбором. Доступность действует на момент проверки и не закрепляет автомобиль. Подтверждение брони выполняется по правилам https://cars4me.ru/llms.txt. ## Если расчёт не получен Если сервер предлагает обновить страницу, заново получите nonce через JSON-контекст и повторите запрос один раз. Если расчёт не получен, используйте поиск через сайт. Если наличие проверить не удалось, сообщите это клиенту и передайте ссылку с полным выбором. Не подменяйте ошибку утверждением, что автомобиль занят. Соблюдайте ограничение частоты запросов и Retry-After, если сервер его передаёт. При неполной проверке автомобилей сообщите, что сравнение выполнено не по всему списку. ## Пакетный поиск через c4mcat_quote_batch Тот же публичный endpoint, сеанс и nonce. Передавайте action=c4mcat_quote_batch, car_ids (идентификаторы через запятую, не более 20 в одном запросе), pickup_at, return_at, pickup_delivery и return_pickup (0 или 1), nonce. Необязательны price_id и повторяемый optional_ids[]. selection_car ограничивает этот тариф и услуги одним автомобилем пакета; места действуют на все автомобили. Получайте nonce через POST action=c4m_agent_quote_context_v1 в том же сеансе. При success=true данные находятся в data. Сверьте pickup_at и return_at. data.results должен содержать по одному результату для каждого запрошенного car_id, без повторений и посторонних идентификаторов. В каждом результате поле quote содержит обычный расчёт, проверяемый по шагу 5. Поле error означает, что наличие этого автомобиля не установлено. Не объявляйте такой автомобиль занятым. Неполный пакет не подтверждает проверку всего списка. При 403 обновите nonce один раз; при 429 соблюдайте Retry-After, не повторяйте запросы в цикле. ## Инструменты браузера WebMCP Используйте только инструменты, объявленные текущей страницей. Они доступны при наличии document.modelContext либо совместимого navigator.modelContext. Обычные браузеры продолжают использовать формы и API. | Инструмент | Обязательные параметры | Необязательные параметры | | --- | --- | --- | | search_available_cars | pickup_at, return_at | brand, min_seats, max_total, pickup_place, return_place, pickup_address, return_address, pickup_delivery, return_pickup | | get_rental_quote | car_id, pickup_at, return_at | price_id, optional_ids, pickup_place, return_place, pickup_address, return_address, pickup_delivery, return_pickup | Даты — YYYY-MM-DDTHH:MM, Asia/Irkutsk, в будущем, возврат позже получения, максимум 370 суток. brand — точное название марки без учёта регистра. min_seats — минимальное число мест. max_total — бюджет в RUB за весь период без залога. price_id=0 выбирает основной тариф; иной ID берите из текущего расчёта. Места задавайте pickup_place/return_place: office (по умолчанию), airport или address. airport автоматически включает соответствующий платный выезд и адрес терминала. address требует pickup_address/return_address. Необязательные boolean pickup_delivery/return_pickup должны соответствовать местам. Не выбирайте выезды без просьбы клиента. optional_ids — массив целых ID из optionals (в отличие от CSV в URL); [] сбрасывает услуги. Выполните get_rental_quote сначала без опций, затем повторно с нужными ID и тарифом. Результат — JSON-строка. Успех: ok=true, pickup_at, return_at, timezone, checked_at, booking_created=false. Поиск возвращает available (список предложений), checked_count, unavailable_count, errors и complete. complete=false означает, что часть кандидатов не удалось проверить. Расчёт одного автомобиля возвращает quote. В предложении total — аренда и учтённые услуги, deposit — залог отдельно, currency=RUB, url — карточка с полным выбором; selection — переданные места, адреса, тариф и услуги; tariffs и optionals — доступные варианты. Проверяйте available; цена для недоступного автомобиля не является предложением свободной машины. Ошибка: ok=false, availability=unknown, пояснение и ссылка на обычный поиск. Не заменяйте ошибку выдуманной ценой или наличием. Инструменты не создают бронь, не отправляют заявки, не запрашивают контакты, не принимают платежи и не меняют период в интерфейсе. Дополнительные опции, точное место выдачи, возврата и выбранный тариф подтвердите в карточке. Доступность и стоимость проверяются на момент вызова. Декларативная форма search_selected_rental_period использует текущий период интерфейса; её скрытые поля не являются интерфейсом передачи новых дат агентом. Для новых дат вызывайте search_available_cars. Формы request_callback_home, request_callback и request_selected_car предназначены для подготовки заявки. Отправка контактов требует разрешения клиента и подтверждения кнопкой; toolautosubmit не используется. Подготовленная или отправленная заявка не является подтверждённой бронью. Обнаружение: https://cars4me.ru/.well-known/ard.json и совместимый https://cars4me.ru/.well-known/ai-catalog.json. Общие условия и порядок подтверждения брони: https://cars4me.ru/llms.txt. Выпуск API: 1.5.0. Документация актуализирована 15 ноября 2026. ## Проверка примера с аэропортом и временем На период 24.11.2026 22:00 → 26.11.2026 12:00 получение в аэропорту включает подачу 3 000 ₽ и ночную выдачу 4 000 ₽; возврат в офисе в рабочий день в 12:00 не включает выезд. При возврате в аэропорту добавляется отдельный забор 3 000 ₽. Стоимость аренды, кресла и итог берите из свежего расчёта выбранной машины. Выдача/приём 18:01–20:59 — 2 500 ₽, 21:00–08:59 — 4 000 ₽; нерабочий день — ещё 2 500 ₽ за каждую соответствующую операцию. Передача у терминала и номер рейса уточняются с клиентом и компанией; ссылка не гарантирует согласование.