CruiseHops
Search Carnival and Royal Caribbean cruises, compare fare history and find Viator port experiences.
사용해야 할까요
품질 및 안전성
A
발견 사항 (1)
- LOWTool 'compare_sailings' description lacks action verbcompare_sailings에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~15,180토큰 (도구 정의)
~14.9 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 11.86%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"cruisehops": {
"url": "https://cruisehops.com/mcp"
}
}
}원격 엔드포인트
https://cruisehops.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (11)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢search_cruises(q, terms, departureTerms, nightsMin, nightsMax, ...)
Find cruise recommendations and deals on CruiseHops across Carnival and Royal Caribbean by destination, departure port, dates, cabin and budget. Returns sailing links for further exploration on CruiseHops. Research only; no widget. Default three choices. Do not add cabin or budget constraints the user did not give. Search captured cruise sailings using typed filters. Prices are USD cents per person for two guests, not live or family quotes. Filter before grouping and choosing lowest cabin price. Use term IDs from suggest_cruise_terms for precise names.
입력 스키마
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Free-text cruise search; use suggest_cruise_terms to resolve precise entity names."
},
"terms": {
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Complete suggestion item ID including ship:, port:, destination:, or line: prefix."
},
"description": "Stable term IDs from suggest_cruise_terms; prefer these for entity-name filtering."
},
"departureTerms": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"pattern": "^port:[a-f0-9]{24}$"
},
"description": "Port IDs from suggest_cruise_terms, matching departure only (OR within this list). General terms ports also match visited ports. Other filters still apply."
},
"nightsMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum nights. Uses advertised nights, otherwise calendar nights between captured departure and return dates. Unknown durations cannot match."
},
"nightsMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum nights, inclusive. Prefer nightsMin/nightsMax for cruise trip lengths; legacy durationMin/durationMax are days-only."
},
"returnBy": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest disembarkation date, YYYY-MM-DD; excludes unknown return dates. This deadline never expands with dateFlexDays."
},
"dateFlexDays": {
"type": "integer",
"minimum": 0,
"maximum": 30,
"description": "Optional departure flexibility, 0–30 days before dateFrom and after dateTo. Requires both dates when positive. Exact matches stay in items; outside-window options are separate dateAlternatives. All other filters remain strict. Use only when the user permits flexible dates."
},
"source": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source ID: carnival or royal_caribbean."
},
"departurePort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Departure port selection: shared port suggestion ID or source-native items[].departurePort.id. Reviewed equivalent ports match across cruise lines; source still restricts the line. Different embarkation ports remain distinct."
},
"visitedPort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Visited port selection: shared port suggestion ID or source-native items[].visitedPorts[].id. Reviewed equivalent ports match across cruise lines; source still restricts the line."
},
"ship": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source-native ship ID from items[].ship.id, not a suggestion term ID. Prefer terms for names."
},
"destination": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Shared destination suggestion ID or destination label. Umbrella destinations such as Caribbean include mapped subregions across cruise lines. Specific regions remain strict; generic Caribbean does not imply Eastern Caribbean. Prefer suggest_cruise_terms to resolve names."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"dateFrom": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive earliest departure date (YYYY-MM-DD)."
},
"dateTo": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest departure date (YYYY-MM-DD)."
},
"durationMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum normalized duration in days, not advertised nights."
},
"durationMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum normalized duration in days, not advertised nights."
},
"priceMaxCents": {
"type": "integer",
"minimum": 0,
"maximum": 999999999,
"description": "Maximum captured USD cents per person for two guests; 50000 means USD 500/person. Not a party total."
},
"roundtrip": {
"type": "boolean"
},
"amenity": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact captured amenity name from get_sailing ship.amenities[].name."
},
"includeUnavailable": {
"type": "boolean"
},
"sort": {
"type": "string",
"enum": [
"price",
"departure",
"duration",
"relevance"
]
},
"view": {
"type": "string",
"enum": [
"groups",
"sailings"
],
"description": "Default groups combines departures for each ship itinerary; sailings returns one row per unique dated sailing. Event-specific fares remain available within each sailing."
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 1000000,
"description": "One-based result page; default 1."
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Items per page, 1–50; default 3."
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "search"
},
"selectedDepartureTerms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"ship",
"port",
"destination",
"line"
]
},
"label": {
"type": "string"
},
"unavailable": {
"type": "boolean"
}
},
"required": [
"id",
"kind",
"label",
"unavailable"
],
"additionalProperties": false
}
},
"dateAlternatives": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"totalSailings": {
"type": "number"
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"requestedDateFrom": {
"type": "string"
},
"requestedDateTo": {
"type": "string"
},
"dateFrom": {
"type": "string"
},
"dateTo": {
"type": "string"
},
"flexibilityDays": {
"type": "number"
}
},
"required": [
"items",
"total",
"totalSailings",
"page",
"pageSize",
"requestedDateFrom",
"requestedDateTo",
"dateFrom",
"dateTo",
"flexibilityDays"
],
"additionalProperties": false
},
"recovery": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"count": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"changes": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"null"
]
}
}
},
"required": [
"id",
"label",
"count",
"changes"
],
"additionalProperties": false
}
},
"selectedTerms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"ship",
"port",
"destination",
"line"
]
},
"label": {
"type": "string"
},
"unavailable": {
"type": "boolean"
}
},
"required": [
"id",
"kind",
"label",
"unavailable"
],
"additionalProperties": false
}
},
"view": {
"type": "string",
"enum": [
"groups",
"sailings"
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
}
},
"totalSailings": {
"type": "number"
},
"total": {
"type": "number"
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
}
},
"required": [
"kind",
"selectedTerms",
"view",
"items",
"totalSailings",
"total",
"page",
"pageSize",
"priceContext"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢suggest_cruise_terms(q, terms, departureTerms, nightsMin, nightsMax, ...)
Suggest matching ship, port, destination and cruise line names, including suffix words. Returns stable term IDs for search filters.
입력 스키마
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"terms": {
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Complete suggestion item ID including ship:, port:, destination:, or line: prefix."
},
"description": "Stable term IDs from suggest_cruise_terms; prefer these for entity-name filtering."
},
"departureTerms": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"pattern": "^port:[a-f0-9]{24}$"
},
"description": "Port IDs from suggest_cruise_terms, matching departure only (OR within this list). General terms ports also match visited ports. Other filters still apply."
},
"nightsMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum nights. Uses advertised nights, otherwise calendar nights between captured departure and return dates. Unknown durations cannot match."
},
"nightsMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum nights, inclusive. Prefer nightsMin/nightsMax for cruise trip lengths; legacy durationMin/durationMax are days-only."
},
"returnBy": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest disembarkation date, YYYY-MM-DD; excludes unknown return dates. This deadline never expands with dateFlexDays."
},
"dateFlexDays": {
"type": "integer",
"minimum": 0,
"maximum": 30,
"description": "Optional departure flexibility, 0–30 days before dateFrom and after dateTo. Requires both dates when positive. Exact matches stay in items; outside-window options are separate dateAlternatives. All other filters remain strict. Use only when the user permits flexible dates."
},
"source": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source ID: carnival or royal_caribbean."
},
"departurePort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Departure port selection: shared port suggestion ID or source-native items[].departurePort.id. Reviewed equivalent ports match across cruise lines; source still restricts the line. Different embarkation ports remain distinct."
},
"visitedPort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Visited port selection: shared port suggestion ID or source-native items[].visitedPorts[].id. Reviewed equivalent ports match across cruise lines; source still restricts the line."
},
"ship": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source-native ship ID from items[].ship.id, not a suggestion term ID. Prefer terms for names."
},
"destination": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Shared destination suggestion ID or destination label. Umbrella destinations such as Caribbean include mapped subregions across cruise lines. Specific regions remain strict; generic Caribbean does not imply Eastern Caribbean. Prefer suggest_cruise_terms to resolve names."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"dateFrom": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive earliest departure date (YYYY-MM-DD)."
},
"dateTo": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest departure date (YYYY-MM-DD)."
},
"durationMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum normalized duration in days, not advertised nights."
},
"durationMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum normalized duration in days, not advertised nights."
},
"priceMaxCents": {
"type": "integer",
"minimum": 0,
"maximum": 999999999,
"description": "Maximum captured USD cents per person for two guests; 50000 means USD 500/person. Not a party total."
},
"roundtrip": {
"type": "boolean"
},
"amenity": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact captured amenity name from get_sailing ship.amenities[].name."
},
"includeUnavailable": {
"type": "boolean"
},
"sort": {
"type": "string",
"enum": [
"price",
"departure",
"duration",
"relevance"
]
},
"view": {
"type": "string",
"enum": [
"groups",
"sailings"
],
"description": "Default groups combines departures for each ship itinerary; sailings returns one row per unique dated sailing. Event-specific fares remain available within each sailing."
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 1000000,
"description": "One-based result page; default 1."
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Items per page, 1–50; default 3."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20
},
"cursor": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"q"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "suggestions"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"ship",
"port",
"destination",
"line"
]
},
"label": {
"type": "string"
},
"unavailable": {
"type": "boolean"
},
"sailingCount": {
"type": "number"
},
"resultCount": {
"type": "number"
},
"countUnit": {
"type": "string",
"enum": [
"groups",
"sailings"
]
}
},
"required": [
"id",
"kind",
"label",
"unavailable",
"sailingCount",
"resultCount",
"countUnit"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"nextCursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"kind",
"items",
"total",
"nextCursor"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_departures(q, terms, departureTerms, nightsMin, nightsMax, ...)
List bounded, paginated unique dated sailings for a public ship-itinerary group ID. Preserves cabin/date filters; older event-specific group IDs remain supported.
입력 스키마
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Free-text cruise search; use suggest_cruise_terms to resolve precise entity names."
},
"terms": {
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Complete suggestion item ID including ship:, port:, destination:, or line: prefix."
},
"description": "Stable term IDs from suggest_cruise_terms; prefer these for entity-name filtering."
},
"departureTerms": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"pattern": "^port:[a-f0-9]{24}$"
},
"description": "Port IDs from suggest_cruise_terms, matching departure only (OR within this list). General terms ports also match visited ports. Other filters still apply."
},
"nightsMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum nights. Uses advertised nights, otherwise calendar nights between captured departure and return dates. Unknown durations cannot match."
},
"nightsMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum nights, inclusive. Prefer nightsMin/nightsMax for cruise trip lengths; legacy durationMin/durationMax are days-only."
},
"returnBy": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest disembarkation date, YYYY-MM-DD; excludes unknown return dates. This deadline never expands with dateFlexDays."
},
"dateFlexDays": {
"type": "integer",
"minimum": 0,
"maximum": 30,
"description": "Optional departure flexibility, 0–30 days before dateFrom and after dateTo. Requires both dates when positive. Exact matches stay in items; outside-window options are separate dateAlternatives. All other filters remain strict. Use only when the user permits flexible dates."
},
"source": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source ID: carnival or royal_caribbean."
},
"departurePort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Departure port selection: shared port suggestion ID or source-native items[].departurePort.id. Reviewed equivalent ports match across cruise lines; source still restricts the line. Different embarkation ports remain distinct."
},
"visitedPort": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Visited port selection: shared port suggestion ID or source-native items[].visitedPorts[].id. Reviewed equivalent ports match across cruise lines; source still restricts the line."
},
"ship": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Source-native ship ID from items[].ship.id, not a suggestion term ID. Prefer terms for names."
},
"destination": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Shared destination suggestion ID or destination label. Umbrella destinations such as Caribbean include mapped subregions across cruise lines. Specific regions remain strict; generic Caribbean does not imply Eastern Caribbean. Prefer suggest_cruise_terms to resolve names."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"dateFrom": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive earliest departure date (YYYY-MM-DD)."
},
"dateTo": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest departure date (YYYY-MM-DD)."
},
"durationMin": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Minimum normalized duration in days, not advertised nights."
},
"durationMax": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "Maximum normalized duration in days, not advertised nights."
},
"priceMaxCents": {
"type": "integer",
"minimum": 0,
"maximum": 999999999,
"description": "Maximum captured USD cents per person for two guests; 50000 means USD 500/person. Not a party total."
},
"roundtrip": {
"type": "boolean"
},
"amenity": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact captured amenity name from get_sailing ship.amenities[].name."
},
"includeUnavailable": {
"type": "boolean"
},
"sort": {
"type": "string",
"enum": [
"price",
"departure",
"duration",
"relevance"
]
},
"view": {
"type": "string",
"enum": [
"groups",
"sailings"
],
"description": "Default groups combines departures for each ship itinerary; sailings returns one row per unique dated sailing. Event-specific fares remain available within each sailing."
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 1000000,
"description": "One-based result page; default 1."
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Items per page, 1–50; default 3."
},
"groupId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Public ship-itinerary group ID from search_cruises items[].groupId; this is not a sailing ID. Older event-specific group IDs remain supported."
}
},
"required": [
"groupId"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "departures"
},
"dateAlternatives": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"totalSailings": {
"type": "number"
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"requestedDateFrom": {
"type": "string"
},
"requestedDateTo": {
"type": "string"
},
"dateFrom": {
"type": "string"
},
"dateTo": {
"type": "string"
},
"flexibilityDays": {
"type": "number"
}
},
"required": [
"items",
"total",
"totalSailings",
"page",
"pageSize",
"requestedDateFrom",
"requestedDateTo",
"dateFrom",
"dateTo",
"flexibilityDays"
],
"additionalProperties": false
},
"groupId": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
}
},
"required": [
"kind",
"groupId",
"items",
"total",
"page",
"pageSize",
"priceContext"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_sailing(sailingId, cabinClass, offerId, eventSelector, includeAmenities, ...)
Explore a CruiseHops sailing page: itinerary, cabin fares, price-history context and links to the website and official provider. Research only; no widget. Read sailing itinerary, cabin-filtered offers and booking URLs. Amenities and media are omitted by default; request them explicitly only when needed. No live availability or party total is guaranteed.
입력 스키마
{
"type": "object",
"properties": {
"sailingId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Normalized cabin class: inside, oceanview, balcony, suite, or other, as captured on the offer."
},
"offerId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact current available two-adult offer ID from get_sailing offers[].id; must belong to this sailing/event."
},
"eventSelector": {
"type": "string",
"maxLength": 200,
"description": "Exact source eventSelector from a search result or offer; empty string is a valid standard event."
},
"includeAmenities": {
"type": "boolean",
"description": "Default false. Set true only when the user asks about on-board facilities or opens the amenities section."
},
"includeMedia": {
"type": "boolean",
"description": "Default false. Set true only when media is requested."
}
},
"required": [
"sailingId"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "sailing"
},
"selection": {
"type": "object",
"properties": {
"cabinClass": {
"type": [
"string",
"null"
]
},
"offerId": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
}
},
"required": [
"cabinClass",
"offerId",
"eventSelector"
],
"additionalProperties": false
},
"sailing": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
},
"itinerary": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sequence": {
"type": "number"
},
"dayNumber": {
"type": [
"number",
"null"
]
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"portId": {
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"arrival": {
"type": [
"string",
"null"
]
},
"arrivalDate": {
"type": [
"string",
"null"
]
},
"departure": {
"type": [
"string",
"null"
]
},
"departureDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"sequence",
"dayNumber",
"kind",
"name",
"portId",
"date",
"arrival",
"arrivalDate",
"departure",
"departureDate"
],
"additionalProperties": false
}
},
"offers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"contextKey": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"isCurrent": {
"type": "boolean"
},
"id": {
"type": "string"
},
"revisionId": {
"type": "string"
},
"cabinClass": {
"type": "string"
},
"sourceName": {
"type": "string"
},
"availability": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"observedAt": {
"type": "string"
},
"bookingUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"guestCount": {
"type": "number"
},
"passengerTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"fareCode": {
"type": [
"string",
"null"
]
},
"market": {
"type": [
"string",
"null"
]
}
},
"required": [
"contextKey",
"firstSeenAt",
"lastCheckedAt",
"isCurrent",
"id",
"revisionId",
"cabinClass",
"sourceName",
"availability",
"price",
"observedAt",
"bookingUrl",
"eventSelector",
"guestCount",
"passengerTypes",
"fareCode",
"market"
],
"additionalProperties": false
}
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"amenityCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"amenitiesIncluded": {
"type": "boolean"
},
"amenities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"costTreatment": {
"type": "string"
},
"sourceUrl": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"category",
"costTreatment",
"sourceUrl"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"amenityCount",
"amenitiesIncluded",
"amenities"
],
"additionalProperties": false
},
"media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"caption": {
"type": [
"string",
"null"
]
}
},
"required": [
"url"
],
"additionalProperties": false
}
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
}
},
"required": [
"kind",
"selection",
"sailing",
"itinerary",
"offers",
"ship",
"media",
"priceContext"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_price_history(sailingId, contextKey, dateFrom, dateTo, maxPoints)
Read one exact captured offer context's price history. contextKey is required from get_sailing offers. Never blends cabins, fares, markets, guest counts or events. Dates select overlapping captured observation spans; maxPoints retains the latest points.
입력 스키마
{
"type": "object",
"properties": {
"sailingId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"contextKey": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact offers[].contextKey from get_sailing, identifying cabin/fare/occupancy/market/event; never infer or combine contexts."
},
"dateFrom": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive earliest observation date; includes captured spans that overlap this date."
},
"dateTo": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Inclusive latest observation date (YYYY-MM-DD)."
},
"maxPoints": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"description": "Retain latest matching observations, default 100, maximum 200."
}
},
"required": [
"sailingId",
"contextKey"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "history"
},
"sailingId": {
"type": "string"
},
"series": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"cabinClass": {
"type": "string"
},
"sourceName": {
"type": "string"
},
"fareCode": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"guestCount": {
"type": "number"
},
"market": {
"type": [
"string",
"null"
]
},
"isCurrent": {
"type": "boolean"
},
"lastCheckedAt": {
"type": "string"
},
"points": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"amountCents": {
"type": [
"number",
"null"
]
},
"availability": {
"type": "string"
}
},
"required": [
"id",
"firstSeenAt",
"lastCheckedAt",
"amountCents",
"availability"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"cabinClass",
"sourceName",
"fareCode",
"eventSelector",
"guestCount",
"market",
"isCurrent",
"lastCheckedAt",
"points"
],
"additionalProperties": false
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
},
"truncated": {
"type": "boolean"
}
},
"required": [
"kind",
"sailingId",
"series",
"priceContext",
"truncated"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢present_cruises(sailings)
Present the final shortlist of one to three selected sailings in ONE interactive widget. Call once after research, preserving exact offer IDs, cabin classes and event selectors. Research tools do not render widgets. Do not repeat all widget details in prose.
입력 스키마
{
"type": "object",
"properties": {
"sailings": {
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"sailingId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Preserve the requested cabin class; never substitute another cabin when unavailable."
},
"offerId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact current available two-adult offer ID from get_sailing offers[].id; must belong to this sailing/event."
},
"eventSelector": {
"type": "string",
"maxLength": 200,
"description": "Exact source eventSelector from a search result or offer; empty string is a valid standard event."
}
},
"required": [
"sailingId"
],
"additionalProperties": false
}
}
},
"required": [
"sailings"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "shortlist"
},
"items": {
"minItems": 1,
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"sailing": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
},
"itinerary": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sequence": {
"type": "number"
},
"dayNumber": {
"type": [
"number",
"null"
]
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"portId": {
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"arrival": {
"type": [
"string",
"null"
]
},
"arrivalDate": {
"type": [
"string",
"null"
]
},
"departure": {
"type": [
"string",
"null"
]
},
"departureDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"sequence",
"dayNumber",
"kind",
"name",
"portId",
"date",
"arrival",
"arrivalDate",
"departure",
"departureDate"
],
"additionalProperties": false
}
},
"selectedOffer": {
"anyOf": [
{
"type": "object",
"properties": {
"contextKey": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"isCurrent": {
"type": "boolean"
},
"id": {
"type": "string"
},
"revisionId": {
"type": "string"
},
"cabinClass": {
"type": "string"
},
"sourceName": {
"type": "string"
},
"availability": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"observedAt": {
"type": "string"
},
"bookingUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"guestCount": {
"type": "number"
},
"passengerTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"fareCode": {
"type": [
"string",
"null"
]
},
"market": {
"type": [
"string",
"null"
]
}
},
"required": [
"contextKey",
"firstSeenAt",
"lastCheckedAt",
"isCurrent",
"id",
"revisionId",
"cabinClass",
"sourceName",
"availability",
"price",
"observedAt",
"bookingUrl",
"eventSelector",
"guestCount",
"passengerTypes",
"fareCode",
"market"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"sailing",
"itinerary",
"selectedOffer"
],
"additionalProperties": false
}
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
}
},
"required": [
"kind",
"items",
"priceContext"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢compare_sailings(sailings)
Compare two to four distinct sailings and optional exact offer IDs. Defaults to lowest current captured two-adult offer; occupancy is explicit per offer. No live or family quote.
입력 스키마
{
"type": "object",
"properties": {
"sailings": {
"minItems": 2,
"maxItems": 4,
"type": "array",
"items": {
"type": "object",
"properties": {
"sailingId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Stable sailing ID from search_cruises items[].id or list_departures items[].id."
},
"cabinClass": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Preserve the requested cabin class; never substitute another cabin when unavailable."
},
"offerId": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact current available two-adult offer ID from get_sailing offers[].id; must belong to this sailing/event."
},
"eventSelector": {
"type": "string",
"maxLength": 200,
"description": "Exact source eventSelector from a search result or offer; empty string is a valid standard event."
}
},
"required": [
"sailingId"
],
"additionalProperties": false
}
}
},
"required": [
"sailings"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}출력 스키마
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "comparison"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sailing": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"id": {
"type": "string"
},
"groupId": {
"type": "string"
},
"title": {
"type": "string"
},
"ship": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departurePort": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
},
"departureDate": {
"type": "string"
},
"returnDate": {
"type": [
"string",
"null"
]
},
"durationDays": {
"type": [
"number",
"null"
]
},
"durationNights": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationNightsSource": {
"anyOf": [
{
"type": "string",
"enum": [
"advertised_nights",
"sailing_dates"
]
},
{
"type": "null"
}
]
},
"dateOffsetDays": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"advertisedDuration": {
"anyOf": [
{
"type": "object",
"properties": {
"value": {
"type": "number"
},
"unit": {
"type": "string",
"enum": [
"days",
"nights"
]
}
},
"required": [
"value",
"unit"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"destinations": {
"type": "array",
"items": {
"type": "string"
}
},
"visitedPorts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"additionalProperties": false
}
},
"roundtrip": {
"type": [
"boolean",
"null"
]
},
"unavailable": {
"type": "boolean"
},
"itineraryCompleteness": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"imageUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"searchRank": {
"type": "number"
},
"deepLink": {
"type": "string"
},
"firstDepartureDate": {
"type": "string"
},
"departureCount": {
"type": "number"
},
"lastDepartureDate": {
"type": "string"
}
},
"required": [
"source",
"id",
"groupId",
"title",
"ship",
"departurePort",
"departureDate",
"returnDate",
"durationDays",
"durationNights",
"durationNightsSource",
"advertisedDuration",
"destinations",
"visitedPorts",
"roundtrip",
"unavailable",
"itineraryCompleteness",
"price",
"imageUrl",
"eventSelector",
"deepLink"
],
"additionalProperties": false
},
"itinerary": {
"type": "array",
"items": {
"type": "object",
"properties": {
"sequence": {
"type": "number"
},
"dayNumber": {
"type": [
"number",
"null"
]
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"portId": {
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"arrival": {
"type": [
"string",
"null"
]
},
"arrivalDate": {
"type": [
"string",
"null"
]
},
"departure": {
"type": [
"string",
"null"
]
},
"departureDate": {
"type": [
"string",
"null"
]
}
},
"required": [
"sequence",
"dayNumber",
"kind",
"name",
"portId",
"date",
"arrival",
"arrivalDate",
"departure",
"departureDate"
],
"additionalProperties": false
}
},
"selectedOffer": {
"anyOf": [
{
"type": "object",
"properties": {
"contextKey": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"isCurrent": {
"type": "boolean"
},
"id": {
"type": "string"
},
"revisionId": {
"type": "string"
},
"cabinClass": {
"type": "string"
},
"sourceName": {
"type": "string"
},
"availability": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amountCents": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"observedAt": {
"type": "string"
},
"firstSeenAt": {
"type": "string"
},
"lastCheckedAt": {
"type": "string"
},
"cabinClass": {
"type": "string"
}
},
"required": [
"amountCents",
"currency",
"basis",
"observedAt",
"cabinClass"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"observedAt": {
"type": "string"
},
"bookingUrl": {
"type": [
"string",
"null"
]
},
"eventSelector": {
"type": "string"
},
"guestCount": {
"type": "number"
},
"passengerTypes": {
"type": "array",
"items": {
"type": "string"
}
},
"fareCode": {
"type": [
"string",
"null"
]
},
"market": {
"type": [
"string",
"null"
]
}
},
"required": [
"contextKey",
"firstSeenAt",
"lastCheckedAt",
"isCurrent",
"id",
"revisionId",
"cabinClass",
"sourceName",
"availability",
"price",
"observedAt",
"bookingUrl",
"eventSelector",
"guestCount",
"passengerTypes",
"fareCode",
"market"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"sailing",
"itinerary",
"selectedOffer"
],
"additionalProperties": false
}
},
"priceContext": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "USD"
},
"basis": {
"type": "string",
"const": "per_person"
},
"guestCount": {
"type": "number",
"const": 2
},
"passengerTypes": {
"anyOf": [
{
"type": "array",
"items": [
{
"type": "string",
"const": "adult"
},
{
"type": "string",
"const": "adult"
}
],
"additionalItems": false,
"minItems": 2,
"maxItems": 2
},
{
"type": "null"
}
]
},
"quoteType": {
"type": "string",
"const": "captured"
},
"partyTotal": {
"type": "null"
},
"caveat": {
"type": "string"
}
},
"required": [
"currency",
"basis",
"guestCount",
"passengerTypes",
"quoteType",
"partyTotal",
"caveat"
],
"additionalProperties": false
}
},
"required": [
"kind",
"items",
"priceContext"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢present_excursions(portId, date, q, page)
Open ONE interactive port-experience browser when the user wants excursions, tours or activities. Omit portId to let the user choose a port without calling Viator. Supply a supported local portId and optional visit date and activity keywords q to show matching experiences. This makes a fresh on-demand search; use the returned data as the current result. Preserve requested filters. Do not fetch details for every result. Users can change ports, dates, keywords and pages, inspect one selected experience and open Viator booking links. Suggestions are not verified to fit time ashore; no live availability. Use only on an experience request, never automatically for every cruise search.
입력 스키마
{
"type": "object",
"properties": {
"portId": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"q": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 833
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢list_excursion_ports
List local cruise ports and whether excursion searches are supported. No Viator product request. Use the returned port ID for find_port_excursions.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢find_port_excursions(portId, date, q, page)
Search Viator on demand only when the user asks for activities or excursions. Use a port ID from list_excursion_ports or get_sailing itinerary.portId. Pass the port visit date, not the cruise departure date. Optional q searches activity keywords such as snorkeling or food tours within that port; preserve it across pagination. Returns suggestions near the port, NOT verified time-ashore matches or live availability. Prices are indicative, may differ for the date/party, and are not cruise fares. Preserve complete affiliate URLs. No reviews or protected unique content. No widget.
입력 스키마
{
"type": "object",
"properties": {
"portId": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"q": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 833
}
},
"required": [
"portId"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_excursion(productCode)
Fetch details only for a Viator product the user selected from find_port_excursions. Returns allowed product content and an affiliate booking URL; no reviews, protected content or live availability. Verify meeting point, return timing and availability on Viator.
입력 스키마
{
"type": "object",
"properties": {
"productCode": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,80}$"
}
},
"required": [
"productCode"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 11개