РусскийRU

Разработчикам и ИИ-ассистентам

Precellence для ИИ-агентов и ассистентов

ИИ-агент или ассистент может получить наши цены с НДС за автомобиль через GET /api/public/quote, прочитать наши условия через GET /api/public/conditions, а затем направить путешественника по заранее заполненной ссылке на бронирование. Только чтение, без ключа и учётной записи, без персональных данных, бесплатно и общее для всех ассистентов (правила добросовестного использования — ниже). Бронирование и оплата всегда происходят на нашем сайте.

Публичные адреса

МетодАдресНазначениеКэш
GET/api/public/quoteЦены с НДС по классам, понятная причина, если цена «по запросу», ссылка на бронирование10 мин
GET/api/public/conditionsКлассы, зоны с фиксированной ценой, почасовые тарифы, опции, ожидание, отмена, срок бронирования, контакты1 ч
GET/openapi.jsonОписание OpenAPI 3.1 (схемы, примеры, ограничения)—
GET/llms.txtОбзор сайта для ИИ-ассистентов—
POST/mcpMCP-сервер только для чтения для ИИ-ассистентов (инструменты расчёта цены и условий)10 мин

Параметры (те же, что в ссылке на бронирование)

ПараметрФорматПример
fromМесто подачи текстом: номер дома и улица, отель, вокзал, аэропорт, терминал15 Avenue Montaigne, Paris
toМесто назначения текстом (не нужно при почасовой аренде)Aéroport CDG
dateДата по Парижу, YYYY-MM-DD2026-11-20
timeВремя по Парижу, HH:MM (принимаются 9:30 и 9h30)09:30
paxПассажиры, от 1 до 72
classКласс для предварительного выбора: business (Mercedes E-класс), electric (Mercedes EQE), first (Mercedes S-класс), van (Mercedes V-класс), ev (Mercedes EQV)first
langЯзык сообщений и ссылки: fr, en, ar, es, tr, ru, zh (tr, ru, zh: сообщения на английском; ссылка на бронирование — на языках fr, en, ar, es, для остальных — на английском)ru
typeoneway (трансфер, по умолчанию) или hourly (почасовая аренда с водителем)hourly
durationЧасы, от 3 до 12, с type=hourly4

Заранее заполненная ссылка на бронирование

https://precellence-service.com/reservation?from={from}&to={to}&date={YYYY-MM-DD}&time={HH:MM}&pax={1-7}&class={business|electric|first|van|ev}&lang={fr|en|ar|es}
https://precellence-service.com/reservation?type=hourly&duration={3-12}&from={address}&date={YYYY-MM-DD}&time={HH:MM}&lang={fr|en|ar|es}

Открывает форму бронирования с заполненным маршрутом и выбранным классом; цена заново запрашивается у сервера. Ничего не сохраняется, пока путешественник не нажмёт «Continue» (форма на английском).

Правила и ограничения

Добросовестное использование

Расчёт цены для ассистентов (публичный API и MCP-сервер) бесплатен и общий для всех ассистентов. Чтобы он оставался бесплатным, расчёты адресов и маршрутов ежемесячно ограничены для всех ассистентов вместе, а всплески запросов ограничены (60 рассчитанных предложений в минуту с одного IP-адреса для API, 30 в минуту для всего MCP-сервера).

Всегда обслуживаются, даже при достижении месячного лимита: поездки по фиксированной цене между парижским адресом с почтовым индексом (от 75001 до 75020, 75116) и аэропортом, крупным парижским вокзалом, Диснейлендом, Ла-Дефанс или Версалем. Места из тарифа (аэропорты, вокзалы, направления) распознаются по названию, а французские адреса с почтовым индексом определяются через Base Adresse Nationale (IGN Géoplateforme, Licence Ouverte).

При достижении месячного лимита: обычный ответ, а не ошибка, со статусом «quota_reached», понятной фразой, заранее заполненной ссылкой на бронирование (booking_url) и, если у поездки фиксированная цена, этой ценой. При всплеске запросов: HTTP 429 (API) или ошибка JSON-RPC -31429 (MCP) со временем ожидания (Retry-After) и той же ссылкой.

Что делать: указывайте полный почтовый адрес с индексом (например, «15 avenue Montaigne, 75008 Paris»), а не название отеля, затем направляйте путешественника по ссылке booking_url: сайт сразу рассчитает точную цену. Блокировка никогда не означает сбой: сайт и ссылка на бронирование работают всегда.

Примеры

curl "https://precellence-service.com/api/public/quote?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=first&lang=en"
curl "https://precellence-service.com/api/public/conditions?lang=ru"
https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=first&lang=en

Пример полного ответа (GET /api/public/quote)

{
  "ok": true,
  "status": "priced",
  "quote_id": "pq_0123456789abcdef",
  "currency": "EUR",
  "prices_include_vat": true,
  "lang": "en",
  "lang_requested": "en",
  "trip": {
    "type": "oneway",
    "from": "15 Avenue Montaigne, Paris",
    "to": "Aéroport CDG",
    "date": "2026-11-20",
    "time": "09:30",
    "timezone": "Europe/Paris",
    "pickup_at": "2026-11-20T08:30:00.000Z",
    "passengers": 2,
    "duration_hours": null,
    "distance_km": 32.4,
    "duration_min": 45
  },
  "selected_class": "first",
  "from_price_ttc": 115,
  "classes": [
    {
      "id": "business",
      "name": "Mercedes E-Class",
      "category": "Business",
      "passengers": "1-3",
      "passengers_max": 3,
      "luggage": "2",
      "luggage_hold": 2,
      "luggage_cabin": 2,
      "luggage_text": "2 suitcases in the boot and 2 pieces of hand luggage",
      "fits_passengers": true,
      "selected": false,
      "status": "priced",
      "price_ttc": 115,
      "price_ttc_cents": 11500,
      "price_type": "forfait",
      "reason": null,
      "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=business&lang=en"
    },
    {
      "id": "electric",
      "name": "Mercedes EQE",
      "category": "Electric",
      "passengers": "1-3",
      "passengers_max": 3,
      "luggage": "2",
      "luggage_hold": 2,
      "luggage_cabin": 2,
      "luggage_text": "2 suitcases in the boot and 2 pieces of hand luggage",
      "fits_passengers": true,
      "selected": false,
      "status": "priced",
      "price_ttc": 115,
      "price_ttc_cents": 11500,
      "price_type": "forfait",
      "reason": null,
      "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=electric&lang=en"
    },
    {
      "id": "first",
      "name": "Mercedes S-Class",
      "category": "First Class",
      "passengers": "1-3",
      "passengers_max": 3,
      "luggage": "2",
      "luggage_hold": 2,
      "luggage_cabin": 2,
      "luggage_text": "2 suitcases in the boot and 2 pieces of hand luggage",
      "fits_passengers": true,
      "selected": true,
      "status": "priced",
      "price_ttc": 240,
      "price_ttc_cents": 24000,
      "price_type": "forfait",
      "reason": null,
      "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=first&lang=en"
    },
    {
      "id": "van",
      "name": "Mercedes V-Class",
      "category": "Van / SUV",
      "passengers": "1-7",
      "passengers_max": 7,
      "luggage": "7",
      "luggage_hold": 7,
      "luggage_cabin": null,
      "luggage_hold_detail": {
        "large": 4,
        "medium": 2,
        "stroller_or_cabin_case": 1
      },
      "luggage_fewer_passengers": {
        "up_to_passengers": 5,
        "luggage_hold": "8-9"
      },
      "luggage_to_declare": [
        "stroller",
        "golfBag",
        "foldedBike"
      ],
      "luggage_text": "4 large suitcases in the boot + 2 medium ones + a pushchair or a cabin suitcase, plus hand luggage; with fewer passengers, more suitcases (up to 5 passengers: 8 to 9 suitcases); pushchair, golf bag, folded bike: please tell us",
      "fits_passengers": true,
      "selected": false,
      "status": "priced",
      "price_ttc": 159,
      "price_ttc_cents": 15900,
      "price_type": "forfait",
      "reason": null,
      "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=van&lang=en"
    },
    {
      "id": "ev",
      "name": "Mercedes EQV",
      "category": "Electric Van",
      "passengers": "1-7",
      "passengers_max": 7,
      "luggage": "4",
      "luggage_hold": 4,
      "luggage_cabin": 3,
      "luggage_text": "4 suitcases in the boot and 3 pieces of hand luggage",
      "fits_passengers": true,
      "selected": false,
      "status": "priced",
      "price_ttc": 159,
      "price_ttc_cents": 15900,
      "price_type": "forfait",
      "reason": null,
      "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=ev&lang=en"
    }
  ],
  "reason": null,
  "booking_url": "https://precellence-service.com/en/reservation?from=15+Avenue+Montaigne%2C+Paris&to=A%C3%A9roport+CDG&date=2026-11-20&time=09%3A30&pax=2&class=first&lang=en",
  "included": {
    "tolls": true,
    "fuel": true,
    "child_seat": true,
    "name_board": true,
    "flight_tracking": true,
    "no_surcharge_night_weekend_holiday": true,
    "free_waiting_minutes": {
      "airport": 60,
      "station": 30,
      "address": 15
    },
    "airport_waiting_counts_from": "actual_landing"
  },
  "conditions": {
    "min_lead_minutes": 120,
    "price_guaranteed_minutes_once_opened_on_site": 20,
    "payment": {
      "when": "full_amount_at_booking",
      "where": "website_only"
    },
    "details_url": "https://precellence-service.com/api/public/conditions?lang=en",
    "terms_url": "https://precellence-service.com/en/cgv"
  },
  "contact": {
    "phone": "+33158963943",
    "whatsapp": "+33769700020",
    "email": "[email protected]",
    "quote_form_url": "https://precellence-service.com/en/devis"
  },
  "notice": "Prices include VAT, per vehicle, computed by the website pricing engine. Booking and payment happen on the website only, through booking_url: the same price is recomputed there, then guaranteed for 20 min. No payment through the assistant.",
  "generated_at": "2026-10-17T10:00:00.000Z",
  "valid_until": "2026-10-17T10:20:00.000Z",
  "tariff_version": "precellence-2026-11b",
  "engine_version": "precellence-engine-1",
  "api_version": "1.0.0"
}

Формат ответов и ошибок

Правила цен в том виде, в каком они приходят в ответах

География

Классы и вместимость

Класс (id)Пассажиров (не более)Чемоданов в багажнике (не более)
Mercedes E-класс business32
Mercedes EQE electric32
Mercedes S-класс first32
Mercedes V-класс van77
Mercedes EQV ev74

Отмена (статья 5 условий продажи)

Оплата

Языки

Сроки

Версии

Состояние и сбои

Условия использования

MCP-сервер (ИИ-ассистенты)

Адрес: https://precellence-service.com/mcp. Удалённый MCP-сервер (Model Context Protocol, транспорт «Streamable HTTP», без состояния), только для чтения и без аутентификации: без ключа, без учётной записи, без персональных данных. Его инструменты (2) вызывают те же функции, что и API выше: те же цены, те же условия, та же ссылка на бронирование.

https://precellence-service.com/mcp

Подключить к ассистенту

Инструменты

Входные и выходные данные инструментов

У каждого инструмента есть понятное название (title) и аннотации readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false: он только читает, ничего не записывает и не удаляет. Каждый ответ содержит понятный текст и то же содержимое в формате JSON (structuredContent).

obtenir_devis — Get a quote — Precellence Service (Paris chauffeur)

Входные данные

from (обязательно)
Место подачи текстом: номер дома и улица, отель, вокзал, аэропорт, терминал
to (обязательно, если type не равен hourly)
Место назначения текстом (не нужно при почасовой аренде)
date (обязательно)
Дата по Парижу, YYYY-MM-DD
time (обязательно)
Время по Парижу, HH:MM (принимаются 9:30 и 9h30)
pax (необязательно)
Пассажиры, от 1 до 7
class (необязательно)
Класс для предварительного выбора: business (Mercedes E-класс), electric (Mercedes EQE), first (Mercedes S-класс), van (Mercedes V-класс), ev (Mercedes EQV)
lang (необязательно)
Язык сообщений и ссылки: fr, en, ar, es, tr, ru, zh (tr, ru, zh: сообщения на английском; ссылка на бронирование — на языках fr, en, ar, es, для остальных — на английском)
type (необязательно)
oneway (трансфер, по умолчанию) или hourly (почасовая аренда с водителем)
duration (обязательно, если type равен hourly)
Часы, от 3 до 12, с type=hourly

Выходные данные

status (priced, on_request или quota_reached), currency, trip (поездка так, как её понял сервер), classes[] (id, name, passengers, luggage, status, price_ttc, price_is_estimate, exact_address_required, booking_url), reason (code, message, candidates), если цена не указана, address_estimate, booking_url, included, conditions, contact, quote_id, valid_until.

voir_conditions — Service conditions — Precellence Service

Входные данные

lang (необязательно)
Язык сообщений и ссылки: fr, en, ar, es, tr, ru, zh (tr, ru, zh: сообщения на английском; ссылка на бронирование — на языках fr, en, ar, es, для остальных — на английском)

Выходные данные

classes (пассажиры, багаж, минимальная стоимость поездки, почасовой тариф), fixed_price_zones, long_distance, hourly_hire, options, waiting, cancellation (уровни возврата), booking (срок, действие цены, оплата), contact, links.

Отклонённый параметр или прошедшая дата: результат с isError: true и списком отклонённых параметров (details). Слишком много запросов одновременно: ошибка JSON-RPC -31429 с retry_after_seconds и booking_url.

Ограничения MCP-сервера

Примеры JSON-RPC (curl)

curl -s https://precellence-service.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
curl -s https://precellence-service.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -H "MCP-Protocol-Version: 2025-06-18" -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
curl -s https://precellence-service.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -H "MCP-Protocol-Version: 2025-06-18" -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"obtenir_devis","arguments":{"from":"15 Avenue Montaigne, Paris","to":"Aéroport CDG","date":"2026-11-20","time":"09:30","pax":2,"class":"first","lang":"ru"}}}'
curl -s https://precellence-service.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -H "MCP-Protocol-Version: 2026-07-28" -H "Mcp-Method: server/discover" -d '{"jsonrpc":"2.0","id":4,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'

Подробнее

Забронировать поездку →