YachtLuma
개발자

API 문서

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=ko'
curl -sS 'https://yachtluma.ai/api/v1/compare?models=lagoon-42,lagoon-46&locale=ko'

페이지 및 필터

목록의 limit는 1~100, offset은 0부터입니다. nextOffset이 null일 때까지 다음 offset으로 전달하세요. 모델은 builder·type, 매물은 category로 거릅니다.

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

필드 제공 범위

사양마다 출처가 허용하는 웹·API·AI 배포 범위가 다릅니다. 사양 배열이 비어 있을 수 있습니다. 수치와 상태, 단위, 날짜, 구성을 함께 표시하세요.

specifications_status · available / not_available_for_this_channel

앱과 할당량

익명 요청은 UTC 하루 10,000회를 공유합니다. 승인 앱은 개별 일일 한도와 승인된 채널·리소스를 사용합니다. 키는 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": "ko",
      "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