YachtLuma
开发者

接口文档

通过 REST 或 MCP 查询已发布的艇型、船厂、地点与市场资料。接入前可先查看所选语言的真实响应。

资源

游艇型号
GET /api/v1/models
包船与拼艇班次
GET /api/v1/departures
授权媒体
GET /api/v1/media
curl -sS 'https://yachtluma.ai/api/v1/models/lagoon-42?locale=zh'
curl -sS 'https://yachtluma.ai/api/v1/compare?models=lagoon-42,lagoon-46&locale=zh'

分页与筛选

列表的 limit 为 1 至 100,offset 从 0 开始。用返回的 nextOffset 请求下一页,直到其为 null。型号支持 builder、type,挂牌支持 category。

curl -sS 'https://yachtluma.ai/api/v1/models?q=Lagoon&locale=zh&limit=2&offset=0'
curl -sS 'https://yachtluma.ai/api/v1/listings?category=charter&locale=zh&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'

字段可用范围

参数按来源分别核定网页、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",
      "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