中文中文

開發者與 AI 助理

供 AI 代理與助理使用的 Precellence

AI 代理或助理可以用 GET /api/public/quote 取得我們每輛車的含稅價格，用 GET /api/public/conditions 讀取服務條件，再把旅客引導至預先填好的預訂連結。唯讀，無需金鑰或帳號，不含個人資料，免費並由所有助理共用（合理使用規則見下方）。預訂與付款一律在我們的網站上完成。

公開端點

方法路徑用途快取
GET/api/public/quote各車型含稅價格、需另行報價時的明確原因、預訂連結10 分鐘
GET/api/public/conditions車型、固定價格區域、計時費率、附加選項、等候、取消、預訂提前時間、聯絡方式1 小時
GET/openapi.jsonOpenAPI 3.1 說明（結構描述、範例、限制）—
GET/llms.txt供 AI 助理閱讀的網站簡介—
POST/mcp供 AI 助理使用的唯讀 MCP 伺服器（報價與服務條件工具）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 至 7 人2
class預先選定的車型：business (賓士 E-Class), electric (賓士 EQE), first (賓士 S-Class), van (賓士 V-Class), ev (賓士 EQV)first
lang訊息與連結的語言：fr, en, ar, es, tr, ru, zh（tr, ru, zh：訊息為英文；預訂連結提供 fr, en, ar, es 版本，其他語言為英文）zh
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 伺服器）免費，並由所有 AI 助理共用。為了維持免費，地址與路線運算每月對所有助理合計設有上限，短時間的大量請求也受到限制（API 每個 IP 位址每分鐘 60 筆計算報價，整個 MCP 伺服器每分鐘 30 筆）。

即使達到每月上限也一律可以回覆的行程：附郵遞區號的巴黎地址（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=zh"
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）乘客（上限）後車廂行李箱（上限）
賓士 E-Class business32
賓士 EQE electric32
賓士 S-Class first32
賓士 V-Class van77
賓士 EQV ev74

取消（銷售條款第 5 條）

付款

語言

時限

版本

狀態與故障

使用條款

MCP 伺服器（AI 助理）

位址：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 (賓士 E-Class), electric (賓士 EQE), first (賓士 S-Class), van (賓士 V-Class), ev (賓士 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":"zh"}}}'
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":{}}}}'

進一步了解

預訂行程 →