YachtLuma
開發者

介面文件

透過 REST 或 MCP 查詢已發布的艇型、船廠、地點與市場資料。串接前可先查看所選語言的實際回應。

資源

遊艇型號
GET /api/v1/models
包船與共乘航班
GET /api/v1/departures
服務供應商
GET /api/v1/providers
授權媒體
GET /api/v1/media
curl -sS 'https://yachtluma.ai/api/v1/models/lagoon-42?locale=zh-tw'
curl -sS 'https://yachtluma.ai/api/v1/compare?models=lagoon-42,lagoon-46&locale=zh-tw'

分頁與篩選

清單的 limit 為 1 至 100,offset 從 0 開始。用回傳的 nextOffset 請求下一頁,直到其為 null。型號支援 builder、type,掛牌支援 category。

curl -sS 'https://yachtluma.ai/api/v1/models?q=Lagoon&locale=zh-tw&limit=2&offset=0'
curl -sS 'https://yachtluma.ai/api/v1/listings?category=charter&locale=zh-tw&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/departures?mode=seat&guests=2&location=Palma&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/providers?service=maintenance&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/media?entityType=model&entityId=lagoon-46&locale=zh-tw'

欄位可用範圍

參數按來源分別核定網頁、API 與 AI 分發權限。型號可能回傳空參數陣列。展示數值時請保留狀態、單位、日期與配置。

specifications_status · available / not_available_for_this_channel

應用程式與配額

匿名請求共用每日 10,000 次配額(UTC)。核准應用程式使用獨立日配額,並依核准管道與資源存取。在 Authorization 標頭中傳入應用金鑰。

Authorization: Bearer <APPLICATION_KEY>
我的應用程式

MCP

MCP 客戶端以 Streamable HTTP 連線至端點。先初始化 initialize,再呼叫 tools/list 查看目前的工具結構。工具讀取已發布紀錄。

POST https://yachtluma.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_models",
    "arguments": {
      "q": "Lagoon",
      "locale": "zh-tw",
      "limit": 3
    }
  }
}
  • search_models
  • search_builders
  • search_listings
  • find_marinas
  • search_equipment
  • search_knowledge
  • get_model
  • get_listing
  • get_equipment
  • get_care_guide
  • compare_models
  • search_yacht_pages
  • get_market_counts
  • search_departures
  • get_departure
  • search_providers
  • get_provider
  • search_media
  • get_media
  • estimate_charter_budget