Trips from Italy: flights, hotels and car hire with real prices, creator itineraries, booking link.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Come stato_viaggio, ma se il viaggio si sta ancora componendo aspetta sul server fino a circa 20 secondi il pezzo successivo (volo, una tappa, l'auto o la chiusura). Solo lettura. Chiamalo dopo componi_viaggio finché status è searching: di solito bastano 2 o 3 chiamate.
Il quote_id restituito da componi_viaggio.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http one2trip https://mcp.one2trip.it/mcp
Come stato_viaggio, ma se il viaggio si sta ancora componendo aspetta sul server fino a circa 20 secondi il pezzo successivo (volo, una tappa, l'auto o la chiusura). Solo lettura. Chiamalo dopo componi_viaggio finché status è searching: di solito bastano 2 o 3 chiamate.
| Argument | Type | Description |
|---|---|---|
| quote_id* | string | Il quote_id restituito da componi_viaggio. |
{
"type": "object",
"required": [
"quote_id"
],
"properties": {
"quote_id": {
"type": "string",
"description": "Il quote_id restituito da componi_viaggio."
}
},
"additionalProperties": false
}Solo per residenti in Italia con partenza dall'Italia: se il cliente dice il contrario, spiegalo con garbo e non avviare il viaggio; la residenza non si chiede. Compone un viaggio con il volo a pezzi, sul server: con azione avvia salva il viaggio (stessi limiti di quote_trip: al massimo 3 viaggi per conversazione) e risponde subito con status searching e quote_id; volo, date degli hotel dagli orari veri del volo, hotel e auto si cercano in background (attendi_viaggio). Arrivo fra mezzanotte e le 6: la prima notte è quella prima dell'arrivo. Se la prima o l'ultima tappa resta senza notti (zero_nights) non si cerca: proponi al cliente di allungare il viaggio o togliere la tappa e avvia un nuovo viaggio. Con azione cambia_tappa (quote_id, stop_index, stop) cerchi un'altra località per una tappa no_availability, no_suitable_hotel o error, con le stesse date, solo dopo il sì del cliente: volo, altre tappe e auto restano; per una tappa timeout (il fornitore degli hotel non ha risposto in tempo) o error (errore del servizio) puoi anche ripetere la stessa località con le stesse coordinate, se il cliente lo chiede: si riprova solo quella tappa, mai il viaggio né la ricerca del volo; al massimo 3 volte per tappa (changes_left), una ricerca per richiesta. Con azione testi (quote_id, testi), solo a viaggio completo, scrivi i testi della pagina pubblica del viaggio: title, summary, description e days come in quote_trip, con le stesse regole e lunghezze (un giorno per ogni notte chiesta con avvia, più uno); sotto le soglie risponde con i motivi da correggere. Gestisce anche le preferenze del volo (preferences.flight: scali, bagaglio in stiva, orari): con la ricerca unica del volo il server sceglie il volo più economico che le rispetta e le date degli hotel seguono quel volo; se nessun volo le rispetta propone il più economico e lo dice in preference_notes. Uscite col solo totale a persona, a viaggio completo, con booking_url. Usalo sempre per un viaggio con il volo: quote_trip lo rifiuta. Mai per un viaggio senza volo (usa quote_trip). Con azione conferma_aeroporto (quote_id, accetta) il cliente accetta (true) o rifiuta (false) l'aeroporto diverso da quello chiesto quando lo stato è needs_review con review_reason airport_substitute: con il sì il viaggio si chiude senza nuove ricerche, con il no il viaggio finisce con errore airport_declined.
| Argument | Type | Description |
|---|---|---|
| stop | object | |
| testi | object | |
| azione* | string | avvia: nuovo viaggio (serve viaggio). cambia_tappa: un'altra località per una tappa senza strutture, o la stessa per una tappa timeout o error (servono quote_id, stop_index, stop). testi: i testi della pagina del viaggio, solo a viaggio completo (servono quote_id e testi). conferma_aeroporto: la risposta del cliente all'aeroporto sostituto, solo con status needs_review e review_reason airport_substitute (servono quote_id e accetta). |
| accetta | boolean | Per conferma_aeroporto: true = il cliente accetta l'aeroporto proposto, false = lo rifiuta. |
| viaggio | object | |
| quote_id | string | Per cambia_tappa e testi: il quote_id restituito da avvia. |
| stop_index | integer | Per cambia_tappa: la tappa da cambiare (da 0, come stops[].stop_index). |
{
"type": "object",
"required": [
"azione"
],
"properties": {
"stop": {
"type": "object",
"required": [
"label",
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitudine del CENTRO della località (non dell'aeroporto), gradi decimali, diversa da 0."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitudine del CENTRO della località, gradi decimali, diversa da 0."
},
"label": {
"type": "string",
"pattern": "\\S",
"maxLength": 120,
"description": "Nome della località (per esempio Lisbona)."
},
"country": {
"type": "string",
"pattern": "\\S",
"maxLength": 60,
"description": "Facoltativo: il paese della tappa, solo se diverso da country (viaggio su più paesi, per esempio Croazia per Motovun in un viaggio in Slovenia)."
}
},
"additionalProperties": false
},
"testi": {
"type": "object",
"required": [
"title",
"summary",
"description",
"days"
],
"properties": {
"days": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"description"
],
"properties": {
"title": {
"type": "string",
"pattern": "\\S",
"maxLength": 200,
"description": "Titolo del giorno, in italiano."
},
"description": {
"type": "string",
"pattern": "\\S",
"maxLength": 5000,
"description": "Programma del giorno in italiano, almeno 300 caratteri: in seconda persona, frasi brevi, cosa vedi e fai, sapori e consigli pratici; nomina i punti di interesse. Pagina pubblica: niente nomi né riferimenti a chi viaggia."
},
"points_of_interest": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitudine del luogo stesso, gradi decimali, diversa da 0; da dare sempre, insieme a lng. Mostra il luogo sulla mappa; ignorata se a più di 50 km dalla tappa del giorno."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitudine del luogo stesso, gradi decimali, diversa da 0; da dare sempre, insieme a lat."
},
"name": {
"type": "string",
"pattern": "\\S",
"maxLength": 200,
"description": "Nome di un luogo vero da vedere."
},
"note": {
"type": "string",
"maxLength": 160,
"description": "Una frase, al massimo 160 caratteri, che dice perché vale la pena (per esempio «Grotta naturale sul mare dove ci si tuffa d'estate»); appare sulla mappa. Testo semplice: niente nomi di persone, link o contatti."
}
},
"additionalProperties": false
},
"maxItems": 10,
"description": "Luoghi veri da vedere quel giorno (monumenti, quartieri, musei, panorami, borghi e luoghi meno noti; non la città della tappa), ognuno con lat, lng e note, entro circa 20 km dalla tappa del giorno (oltre solo in un giorno di escursione), mai ripetuti: almeno 1, 2–4 consigliati in ogni giorno, al massimo 10."
}
},
"additionalProperties": false
},
"maxItems": 61,
"minItems": 2,
"description": "Un elemento per giorno di viaggio: esattamente somma delle nights + 1 (5 notti = 6 giorni)."
},
"title": {
"type": "string",
"pattern": "\\S",
"maxLength": 200,
"description": "Titolo del viaggio, in italiano: evocativo, per una pagina pubblica, senza nomi di persone né occasioni personali. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»)."
},
"summary": {
"type": "string",
"pattern": "\\S",
"maxLength": 500,
"description": "Una frase in italiano che invogli a leggere, in seconda persona. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»)."
},
"description": {
"type": "string",
"pattern": "\\S",
"maxLength": 5000,
"description": "Racconto del viaggio in italiano, almeno 800 caratteri: in seconda persona, frasi brevi, dettagli concreti (luoghi, esperienze, sapori, consigli pratici), mai un elenco. Pagina pubblica: niente nomi, occasioni personali o riferimenti a chi viaggia. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»)."
}
},
"additionalProperties": false
},
"azione": {
"enum": [
"avvia",
"cambia_tappa",
"testi",
"conferma_aeroporto"
],
"type": "string",
"description": "avvia: nuovo viaggio (serve viaggio). cambia_tappa: un'altra località per una tappa senza strutture, o la stessa per una tappa timeout o error (servono quote_id, stop_index, stop). testi: i testi della pagina del viaggio, solo a viaggio completo (servono quote_id e testi). conferma_aeroporto: la risposta del cliente all'aeroporto sostituto, solo con status needs_review e review_reason airport_substitute (servono quote_id e accetta)."
},
"accetta": {
"type": "boolean",
"description": "Per conferma_aeroporto: true = il cliente accetta l'aeroporto proposto, false = lo rifiuta."
},
"viaggio": {
"type": "object",
"required": [
"country",
"origin",
"flight",
"travelers",
"start_date",
"stops"
],
"properties": {
"car": {
"type": "boolean",
"default": false,
"description": "true = auto dall'aeroporto di arrivo a quello di ritorno; solo con transport \"flight\". Mettilo quando le tappe sono lontane fra loro o fuori dalle città."
},
"stops": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"lat",
"lng",
"nights"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitudine del CENTRO della località (non dell'aeroporto), gradi decimali, diversa da 0."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitudine del CENTRO della località, gradi decimali, diversa da 0."
},
"label": {
"type": "string",
"pattern": "\\S",
"maxLength": 120,
"description": "Nome della località (per esempio Lisbona)."
},
"nights": {
"type": "integer",
"maximum": 60,
"minimum": 1,
"description": "Notti nella tappa, almeno 1 (meglio più notti)."
},
"country": {
"type": "string",
"pattern": "\\S",
"maxLength": 60,
"description": "Facoltativo: il paese della tappa, solo se diverso da country (viaggio su più paesi, per esempio Croazia per Motovun in un viaggio in Slovenia)."
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1,
"description": "Tappe in ordine di viaggio, da 1 a 10; al massimo 60 notti in tutto. Ogni tappa ha un hotel, cercato vicino alle coordinate: entro 3 km in città, entro 10 km in campagna, con un giudizio degli ospiti di almeno 7 su 10."
},
"flight": {
"type": "object",
"required": [
"from",
"to",
"return_from"
],
"properties": {
"to": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "Aeroporto di arrivo, vicino alla prima tappa. Milano: LIN solo se il cliente ha detto Linate, BGY solo se ha detto Bergamo, altrimenti MXP. Codice IATA di 3 lettere maiuscole di un aeroporto principale con voli di linea."
},
"from": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "Aeroporto di partenza, vicino a origin. Milano: LIN solo se il cliente ha detto Linate, BGY solo se ha detto Bergamo, altrimenti MXP. Codice IATA di 3 lettere maiuscole di un aeroporto principale con voli di linea."
},
"return_from": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "Aeroporto del volo di ritorno, vicino all'ultima tappa; può differire da to. Milano: LIN solo se il cliente ha detto Linate, BGY solo se ha detto Bergamo, altrimenti MXP. Codice IATA di 3 lettere maiuscole di un aeroporto principale con voli di linea."
}
},
"description": "Obbligatorio con transport \"flight\"; assente con transport \"none\". Il ritorno arriva a from.",
"additionalProperties": false
},
"origin": {
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Gradi decimali, diversa da 0."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Gradi decimali, diversa da 0."
}
},
"description": "Luogo di partenza del viaggiatore (la sua città).",
"additionalProperties": false
},
"region": {
"type": "string",
"pattern": "\\S",
"maxLength": 60,
"description": "Facoltativo ma da compilare quando il viaggio sta in una zona precisa: regione o zona del paese, solo il nome (per esempio Highlands, Toscana)."
},
"country": {
"type": "string",
"pattern": "\\S",
"maxLength": 60,
"description": "Paese principale del viaggio, quello con più notti (per esempio Portogallo). Un viaggio su più paesi va bene: le tappe in un altro paese lo dicono in stops[].country."
},
"travelers": {
"type": "object",
"required": [
"adults"
],
"properties": {
"adults": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "Adulti (18 anni o più), almeno 1."
},
"children_ages": {
"type": "array",
"items": {
"type": "integer",
"maximum": 17,
"minimum": 0
},
"maxItems": 8,
"description": "Età di ogni bambino al viaggio (0–17), una per bambino; vuoto se nessuno. Con il volo i neonati (meno di 2 anni) non possono essere più degli adulti."
}
},
"description": "Al massimo 9 viaggiatori in totale, adulti e bambini.",
"additionalProperties": false
},
"start_date": {
"type": "string",
"format": "date",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Data di partenza AAAA-MM-GG, da domani a 330 giorni da oggi compresi: è il check-in della prima tappa. Quella scritta nella proposta del giro (regola delle date); la data dell'esempio non va copiata."
},
"preferences": {
"type": "object",
"properties": {
"car": {
"type": "object",
"properties": {
"min_seats": {
"type": "integer",
"maximum": 9,
"minimum": 2,
"description": "Posti minimi."
},
"transmission": {
"enum": [
"manual",
"automatic"
],
"type": "string",
"description": "Cambio manuale o automatico."
}
},
"description": "Solo con car true.",
"additionalProperties": false
},
"hotel": {
"type": "object",
"properties": {
"breakfast": {
"type": "boolean",
"description": "true = colazione inclusa."
},
"min_stars": {
"type": "number",
"maximum": 5,
"minimum": 1,
"description": "Stelle minime dell'hotel."
},
"refundable": {
"type": "boolean",
"description": "true = tariffa rimborsabile."
}
},
"description": "Per l'hotel di ogni tappa.",
"additionalProperties": false
},
"flight": {
"type": "object",
"properties": {
"max_stops": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "Scali al massimo per tratta (0 = solo voli diretti)."
},
"checked_bag": {
"type": "boolean",
"description": "true = almeno un bagaglio in stiva incluso."
},
"depart_after": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Andata che parte da quest'ora. HH:MM, ora locale dell'aeroporto di partenza, estremo compreso."
},
"return_after": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Ritorno che parte da quest'ora. HH:MM, ora locale dell'aeroporto di partenza, estremo compreso."
},
"depart_before": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Andata che parte entro quest'ora. HH:MM, ora locale dell'aeroporto di partenza, estremo compreso."
},
"return_before": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Ritorno che parte entro quest'ora. HH:MM, ora locale dell'aeroporto di partenza, estremo compreso."
}
},
"description": "Solo con transport \"flight\".",
"additionalProperties": false
}
},
"description": "Facoltativo: solo le preferenze dette dal cliente, mai inventate. Per ogni voce il server sceglie la più economica che le rispetta tutte; se nessuna le rispetta, la più economica, con una nota in preference_notes. I booleani valgono solo con true.",
"additionalProperties": false
},
"travel_styles": {
"type": "array",
"items": {
"type": "string"
},
"description": "Facoltativo: i tipi di viaggio, al massimo 3, fra i valori elencati nella descrizione dello strumento (grandi-classici, fuori-rotta, on-the-road, natura, citta-e-cultura, mare-e-relax, enogastronomia, slow, famiglia, avventura); gli altri si ignorano."
},
"requested_days": {
"type": "integer",
"maximum": 61,
"minimum": 2,
"description": "La durata in GIORNI detta dal cliente o proposta da te (7 giorni = 6 notti: andata il giorno 1, ritorno il giorno 7). Le notti delle tappe devono essere esattamente questo numero meno uno, altrimenti il server rifiuta. Usa questo campo oppure requested_nights."
},
"requested_nights": {
"type": "integer",
"maximum": 60,
"minimum": 1,
"description": "La durata in NOTTI, se il cliente o tu l'avete detta in notti («una settimana» = 7 notti, «un weekend lungo» = le 2 o 3 notti proposte). Le notti delle tappe devono essere esattamente queste, altrimenti il server rifiuta. Usa questo campo oppure requested_days."
}
},
"additionalProperties": false
},
"quote_id": {
"type": "string",
"description": "Per cambia_tappa e testi: il quote_id restituito da avvia."
},
"stop_index": {
"type": "integer",
"maximum": 9,
"minimum": 0,
"description": "Per cambia_tappa: la tappa da cambiare (da 0, come stops[].stop_index)."
}
},
"additionalProperties": false
}Gli itinerari già pronti, pubblicati dai creator, che corrispondono alla richiesta: tutti, senza tetto, dal più vicino alla richiesta e a parità in ordine casuale (non è una classifica). Solo lettura: non quota e non prenota; il cliente vede e prenota l'itinerario sul sito del creator. Chiamalo appena il cliente nomina un paese o una destinazione, prima di fare domande su date, persone o durata, e ogni volta che chiede un itinerario già pronto o cambia paese o luoghi. Argomenti: country (il paese), places (lat e lng dei luoghi nominati dal cliente: corrisponde un itinerario con una tappa entro radius_km da uno di essi), days solo se il cliente ha già detto la durata (corrisponde entro 2 giorni); serve almeno country o places. Ogni itinerario ha title, author_name (il creator), days e nights (N giorni / N-1 notti), price_from (il prezzo più basso della vetrina, a persona, in euro) e url da mostrare così com'è; se l'interfaccia mostra le card non ripeterli, altrimenti scrivi l'elenco con i link. Se itineraries è vuoto non dirne nulla e prosegui con il viaggio su misura. Mai confronti o classifiche fra creator; se il cliente sceglie l'itinerario di un creator, non proporgli alternative a quello.
| Argument | Type | Description |
|---|---|---|
| days | integer | Durata in giorni (N giorni = N-1 notti), solo se il cliente l'ha già detta: corrisponde entro 2 giorni. |
| places | array | I luoghi che il cliente ha nominato (per esempio Kyoto): corrisponde un itinerario con una tappa vicina a uno di essi. Facoltativo. |
| country | string | Il paese di destinazione, in italiano o in inglese, per esempio Giappone. |
| radius_km | number |
Stato dell'auto di una quotazione di quote_trip, che il server cerca dopo la risposta. Solo lettura: non lancia ricerche e non consuma quotazioni. Chiamalo con il quote_id quando car_status è searching, dopo aver mostrato volo e hotel, rispettando retry_after, al massimo 4 volte in tutto. Di solito l'auto è pronta entro 20 secondi; dopo 30 secondi senza risultato la ricerca è considerata fallita (error). car_status: found = auto trovata, total e per_person comprendono l'auto; unavailable = nessuna auto per quelle date; error = ricerca fallita; flight_changed = il volo scelto in chat ha orari diversi e l'auto si sceglie dal booking_url. Senza auto il totale resta quello di quote_trip; booking_url non cambia. Segui il testo che accompagna il risultato (posti e bagagliaio, condizioni per uscire dal paese).
| Argument | Type | Description |
|---|---|---|
| quote_id* | string | quote_id restituito da quote_trip. |
{
"type": "object",
"required": [
"quote_id"
],
"properties": {
"quote_id": {
"type": "string",
"pattern": "^q_[A-Za-z0-9]{1,62}$",
"description": "quote_id restituito da quote_trip."
}
},
"additionalProperties": false
}Alternative già trovate da una quotazione di quote_trip: voli (type flight), hotel di una tappa (type hotel con stop_index, da 0 come stays[].stop_index) o auto (type car, solo dopo che get_trip_car l'ha trovata). Solo lettura: nessuna ricerca nuova, non consuma quotazioni. Tutte le alternative del tipo, a pagine di 40 righe (page da 1; total_options e pages dicono quante sono); la prima riga della pagina 1 è la scelta attuale (current), poi le altre dal prezzo più basso; i filtri valgono prima delle pagine. Hotel solo con una camera per tutti i viaggiatori. Voli: una riga per combinazione di voli con la tariffa meno cara; in other_fares le altre tariffe degli stessi voli (bagaglio, modifica, rimborso), ognuna con il suo option_id. delta_total è la differenza sul totale; per i voli delta_flight è quella del solo volo: con l'auto trovata, un volo con keeps_car false ha orari diversi e toglie l'auto dal totale (si ricalcola sul sito). Chiamalo quando il cliente chiede altri voli, hotel o auto per un viaggio già quotato, invece di rifare la quotazione, e senza aspettare dopo preference_notes o preference_note (con i filtri delle preferenze) o per controllare posti e bagagliaio dell'auto trovata. Proponi solo le righe più adatte a ciò che chiede, con prezzo e differenza sul totale, mai alternative inventate e senza codici (option_id resta per te). Restringi prima con i filtri: ogni pagina è una consultazione, al massimo 20 per quotazione. Per scegliere una riga: select_trip_option con il suo option_id.
| Argument | Type | Description |
|---|---|---|
| page | integer | Pagina da 1 (predefinita), 40 righe per pagina (o limit): chiedi le successive solo se servono, dopo aver ristretto con i filtri. |
| type* | string | flight = voli; hotel = hotel di una tappa (con stop_index); car = auto (solo con l'auto trovata). |
| limit |
Usa sempre componi_viaggio (azione avvia) per un viaggio con il volo: quote_trip lo rifiuta, anche con preferenze sul volo, e serve solo per un viaggio senza volo. Prezzo vero di un viaggio su misura: volo andata e ritorno (o nessun volo), un hotel per tappa, auto facoltativa (solo con il volo); restituisce totale, voli, hotel e booking_url. Non prenota e non addebita nulla: il cliente prenota e paga dal booking_url. Effetto: con i testi del viaggio il sito può pubblicare una pagina anonima dell'itinerario (viaggi uguali, stessa pagina). Usalo quando il cliente vuole il prezzo di un viaggio, dopo aver seguito queste regole: Servizio riservato a persone residenti in Italia, con partenza dall'Italia. Non chiedere la residenza: se il cliente dice di non risiedere in Italia o di voler partire da fuori Italia, spiega con garbo che One2Trip serve solo i residenti in Italia con partenza dall'Italia, e non quotare. Rispondi comunque nella lingua del cliente. Itinerari dei creator, prima di tutto: appena il cliente nomina un paese o una destinazione, o chiede un itinerario già pronto, PRIMA di fare domande su date, persone o durata chiama find_ready_itinerary con country (il paese), places (lat e lng dei luoghi che ha nominato) e days solo se ha già detto la durata. Se ne trova, mostrali tutti (come card o come elenco con i link) senza quotarli: si vedono e si prenotano sul sito del creator; poi chiedi se uno va bene o se preferisce un viaggio su misura da zero. Se non ne trova, non dirne nulla e prosegui con le domande e il giro. Il viaggio su misura parte solo se il cliente lo vuole. Richiamalo se il cliente cambia paese o luoghi. Mai confronti, classifiche o consigli fra creator; se il cliente sceglie l'itinerario di un creator, non proporgli alternative a quello. Dati: servono solo destinazione, periodo e durata, partenza (città o aeroporto), viaggiatori (adulti ed età dei bambini). Se ne mancano chiedili tutti in un solo messaggio proponendo tu un valore per ciascuno (periodo migliore, durata tipica, aeroporto di partenza, viaggiatori), così che basti confermare, per esempio «Vi propongo metà marzo, 7 giorni, partenza da Milano Malpensa: siete in 2?». Una risposta senza obiezioni accetta i valori proposti; mai richiedere ciò che il cliente ha già detto o che si capisce («io e un'altra persona» sono 2 adulti). Obiettivo: viaggio quotato al terzo messaggio del cliente, al secondo se dà subito tutto. Tipo di viaggio (travel_styles, al massimo 3), fra: grandi-classici (i luoghi iconici da non perdere), fuori-rotta (posti poco turistici e autentici), on-the-road (tante tappe, in auto), natura (parchi, trekking, paesaggi), citta-e-cultura (arte, musei, storia), mare-e-relax (spiagge, mare e riposo), enogastronomia (cibo, vino, mercati), slow (poche tappe, ritmo lento), famiglia (con bambini), avventura (attività e sport). Chiedilo nello stesso messaggio dei dati, mai a parte; se si capisce dalla richiesta deducilo, altrimenti sceglilo tu e scrivilo nella proposta del giro. Guida tappe, luoghi e tono dei testi. Giro: appena hai i dati proponi il giro in un solo messaggio, senza un riepilogo dei dati da confermare: tappe nell'ordine con le notti, in breve cosa si vede e perché è adatta al tipo di viaggio, auto sì o no, durata e date; chiedi solo se va bene o cosa cambiare. Direzioni e distanze devono tornare con le coordinate delle tappe: nel dubbio niente punti cardinali. Una risposta senza obiezioni sul giro (anche solo «va bene», o con dati in più) è la conferma: quota subito, senza chiederla di nuovo. Durata: quella detta dal cliente, o proposta da te e non contestata, è vincolante: N giorni sono N-1 notti (7 giorni = 6 notti), «una settimana» sono 7 notti, «un weekend lungo» 2 o 3 notti. La somma delle notti delle tappe deve coincidere esattamente: scrivi la durata in requested_days (se detta in giorni) o requested_nights (se detta in notti), il server rifiuta un giro che non torna. Nella proposta scrivi giorni, notti e date in modo coerente («7 giorni, 6 notti: partenza mercoledì 26 maggio, rientro martedì 1 giugno»). Date: sempre future, da domani a 330 giorni; una data detta senza anno e già passata quest'anno è dell'anno prossimo. Se il cliente dà solo un periodo («inizio giugno») scegli tu il giorno, dentro il periodo: martedì o mercoledì, oppure venerdì o sabato per un viaggio di 2 o 3 notti nel fine settimana. Scrivi la data nella proposta del giro col giorno della settimana: accettando il giro il cliente accetta la data, quindi dopo non chiederla più. Milano: MXP (Malpensa), LIN solo se il cliente ha detto Linate, BGY solo se ha detto Bergamo o Orio al Serio; con il solo «Milano» scrivi nella proposta che si parte da Malpensa e che, se preferisce, si può partire da Linate o da Bergamo. Camere: se ne prenota una sola per tappa, con tutti i viaggiatori; se il cliente ne chiede di più, digli che per ora se ne prenota una sola e proponi una camera unica adatta (familiare, quadrupla) o prenotazioni separate; mai promettere più camere. Preferenze: prima della quotazione non chiederle; scrivi in preferences solo quelle che il cliente ha già detto da sé (hotel: stelle, colazione, rimborsabile; volo: scali, bagaglio in stiva, orari; auto: cambio, posti), mai inventate: per ogni voce il server sceglie la più economica che le rispetta, e preference_notes dice dove non c'è riuscito. Quotazione: chiama componi_viaggio (azione avvia; quote_trip solo per un viaggio senza volo) solo dopo la conferma del giro, una volta per proposta, mai per provare; al massimo 3 quotazioni riuscite per conversazione (le quotazioni parziali e gli errori non contano). Dopo aver mostrato il viaggio invita in una frase a cambiare volo, hotel o auto se vuole: le alternative con list_trip_options, la scelta con select_trip_option, oppure dal booking_url prima di pagare. Si rifà la quotazione solo se cambiano tappe, notti, date, aeroporti o viaggiatori. Presenta solo prezzi, voli e hotel restituiti dagli strumenti, mai inventati; mostra booking_url così com'è, con price_note e taxes_at_property (tasse da pagare in hotel, non nel totale). Dopo ogni risultato segui i «Passi successivi» o il «Cosa fare» che lo accompagnano. Di' al cliente entro che ora aprire il link per ritrovare gli stessi prezzi: link_until, 30 minuti dalla quotazione, ora italiana; dopo il sito li ricalcola, ritrovando le scelte. Regole: mai chiedere nomi, email, documenti o dati di pagamento: si prenota dal link. Di' che sei un agente di intelligenza artificiale. Niente emoji. Rispondi nella lingua del cliente, ma scrivi in italiano i testi del viaggio. Errori: segui il «Cosa fare» del messaggio; mai ripetere una chiamata fallita con gli stessi argomenti, salvo busy e upstream_error: al massimo un nuovo tentativo in tutto per proposta, subito. timeout: non riprovare, la ricerca continua; di' al cliente che può chiederti di riprovare fra qualche minuto. Argomenti: tappe di più notti con lat e lng del centro della località, mai dell'aeroporto. country è il paese con più notti; per una tappa in un altro paese scrivi stops[].country (Motovun, Croazia, in un viaggio in Slovenia). I testi (title, summary, description, giorni) sono in italiano e vanno su una pagina pubblica: niente nomi di persone, occasioni personali (nozze, anniversari, compleanni) o riferimenti a chi viaggia; niente email, telefoni, link o @. Testi lunghi e coinvolgenti, in seconda persona, frasi brevi e dettagli concreti (luoghi, esperienze, sapori, consigli pratici), mai elenchi: description di almeno 800 caratteri; ogni giorno un titolo, una descrizione di almeno 300 caratteri e almeno 1 punto di interesse vero. Compila region (per esempio Highlands, Toscana) quando il viaggio sta in una zona precisa. Per ogni meta proponi almeno una tappa o un'esperienza fuori dai circuiti classici accanto ai luoghi più noti (in Sicilia Pantalica o Marzamemi accanto a Taormina) e spiega al cliente in una frase perché vale la pena; resta coerente con durata, ritmo e interessi e con spostamenti realistici. Punti di interesse: da 2 a 4 per giorno, primo e ultimo compresi, entro circa 20 km dalla tappa del giorno (oltre solo in un giorno di escursione dichiarato), lungo il percorso nei giorni di trasferimento, mai ripetuti; ognuno con lat e lng del luogo stesso (oltre 50 km dalla tappa vengono ignorate) e una note di al massimo 160 caratteri su perché vale la pena, senza nomi di persone, link o contatti. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, stopover, IATA, PNR o codici aeroporto (LIS, OPO) in title, summary e description; scrivi «arrivo a Lisbona, ripartenza da Porto». Risultato: con car_status searching l'auto si legge dopo con get_trip_car; con partial true alcune tappe non hanno strutture in quelle date (unavailable_stops): niente prezzi, totale né link, proponi di sostituire la tappa o cambiare le date e rifai la quotazione solo dopo la scelta del cliente. Traghetti e isole: porti, durate, operatori e auto a bordo dei traghetti solo dai fatti dati dal server (ferries nel risultato degli strumenti e i «Fatti sui traghetti»), mai indovinarli. Il traghetto va sempre prenotato a parte: dillo ogni volta che ne serve uno, e non dire mai che il prezzo del viaggio o il noleggio dell'auto comprendono il traghetto. Mai inventare orari o prezzi dei traghetti: il server non li ha. Se per una tratta il server non dà fatti sui traghetti, non dare porti, durate, orari né prezzi: se la tappa è su un'isola puoi dire solo che si raggiunge in traghetto, da prenotare a parte e non incluso nel prezzo. Con l'auto: se il server dice che resta in terraferma, di' sempre che lì non serve e resta in terraferma, anche se un traghetto porta le auto; se dice che per riportare l'auto serve un traghetto che la porti, dillo; se dice che il traghetto porta le auto, di' che va verificato con il noleggiatore se si può portare l'auto sul traghetto e che il costo del traghetto per l'auto non è incluso; se il server non dice nulla sull'auto, non affermare nulla.
Salva la scelta di un'alternativa di list_trip_options (volo, hotel di una tappa o auto) e ricalcola il totale con le stesse regole di quote_trip; nessuna ricerca nuova, non consuma quotazioni, non prenota nulla. Una sola camera per tappa. Restituisce il viaggio aggiornato (stessa forma di quote_trip) con changed, choices_left, car_note, link_note e link_until; booking_url non cambia. Chiamalo solo quando il cliente sceglie una riga di list_trip_options: quote_id, lo stesso type (con stop_index per gli hotel) e l'option_id della riga o di una sua other_fares. Poi mostra total e per_person_text (il totale a persona, così com'è) restituiti e ricordagli di aprire lo stesso booking_url entro link_until (30 minuti dalla quotazione) per ritrovare gli stessi prezzi. Al massimo 10 scelte per quotazione; scegliere l'opzione già attuale non cambia nulla e non consuma scelte. Con l'auto, prima di scegliere un volo con keeps_car false di' quanto cambia il solo volo (delta_flight) e che l'auto esce dal totale e si sceglie poi dal booking_url.
| Argument | Type | Description |
|---|---|---|
| type* | string | Lo stesso type di list_trip_options: flight, hotel (con stop_index) o car. |
| quote_id* | string | quote_id restituito da quote_trip. |
| option_id* | string | options[].option_id della riga scelta (o options[].other_fares[].option_id della tariffa scelta), così com'è in list_trip_options. |
| stop_index | integer | Solo con type hotel: la tappa, da 0, la stessa di list_trip_options. |
Stato di un viaggio di componi_viaggio, subito: volo, tappe, auto, e a viaggio completo il totale a persona e booking_url. Solo lettura: nessuna ricerca, non consuma viaggi. Per aspettare il pezzo successivo usa attendi_viaggio.
| Argument | Type | Description |
|---|---|---|
| quote_id* | string | Il quote_id restituito da componi_viaggio. |
{
"type": "object",
"required": [
"quote_id"
],
"properties": {
"quote_id": {
"type": "string",
"description": "Il quote_id restituito da componi_viaggio."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 19, 2026.
A very long tool description (over 4,000 characters) is hard to review and easy to hide instructions in.
Fix: Keep the description to what the tool does and when to use it; move reference material to resources or docs.
| Raggio in km per places, da 1 a 500; facoltativo (predefinito 100). |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Durata in giorni (N giorni = N-1 notti), solo se il cliente l'ha già detta: corrisponde entro 2 giorni."
},
"places": {
"type": "array",
"items": {
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitudine del luogo nominato dal cliente, gradi decimali."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitudine del luogo nominato dal cliente, gradi decimali."
}
},
"additionalProperties": false
},
"maxItems": 10,
"description": "I luoghi che il cliente ha nominato (per esempio Kyoto): corrisponde un itinerario con una tappa vicina a uno di essi. Facoltativo."
},
"country": {
"type": "string",
"maxLength": 120,
"description": "Il paese di destinazione, in italiano o in inglese, per esempio Giappone."
},
"radius_km": {
"type": "number",
"maximum": 500,
"minimum": 1,
"description": "Raggio in km per places, da 1 a 500; facoltativo (predefinito 100)."
}
},
"additionalProperties": false
}| integer |
| Facoltativo: righe per pagina, da 1 a 40 (predefinito 40). Più basso = risposta più corta. |
| filters | object | Facoltativi, pochi e solo quelli del tipo; i booleani filtrano solo con true. La scelta attuale resta sempre la prima riga. |
| quote_id* | string | quote_id restituito da quote_trip. |
| stop_index | integer | Solo con type hotel: la tappa, da 0 come stays[].stop_index. |
{
"type": "object",
"required": [
"quote_id",
"type"
],
"properties": {
"page": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Pagina da 1 (predefinita), 40 righe per pagina (o limit): chiedi le successive solo se servono, dopo aver ristretto con i filtri."
},
"type": {
"enum": [
"flight",
"hotel",
"car"
],
"type": "string",
"description": "flight = voli; hotel = hotel di una tappa (con stop_index); car = auto (solo con l'auto trovata)."
},
"limit": {
"type": "integer",
"maximum": 40,
"minimum": 1,
"description": "Facoltativo: righe per pagina, da 1 a 40 (predefinito 40). Più basso = risposta più corta."
},
"filters": {
"type": "object",
"properties": {
"airline": {
"type": "string",
"maxLength": 60,
"description": "Solo voli: parte del nome della compagnia (andata o ritorno)."
},
"breakfast": {
"type": "boolean",
"description": "Solo hotel: true = colazione inclusa."
},
"max_stops": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "Solo voli: scali al massimo in ciascuna direzione (0 = solo diretti)."
},
"min_seats": {
"type": "integer",
"maximum": 9,
"minimum": 2,
"description": "Solo auto: posti minimi."
},
"min_stars": {
"type": "number",
"maximum": 5,
"minimum": 1,
"description": "Solo hotel: stelle minime."
},
"refundable": {
"type": "boolean",
"description": "Solo hotel: true = solo tariffe rimborsabili."
},
"to_airport": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Solo voli: codice IATA dell'aeroporto di destinazione; l'andata arriva qui e il ritorno, se c'è, parte da qui (con la ripartenza da un'altra città, solo l'andata)."
},
"checked_bag": {
"type": "boolean",
"description": "Solo voli: true = almeno un bagaglio in stiva incluso."
},
"depart_after": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Solo voli: andata che parte da quest'ora, HH:MM ora locale dell'aeroporto."
},
"from_airport": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Solo voli: codice IATA dell'aeroporto di casa; l'andata parte da qui e il ritorno, se c'è, arriva qui. Per cercare fra i voli trovati quelli dall'aeroporto chiesto dal cliente."
},
"return_after": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Solo voli: ritorno che parte da quest'ora, HH:MM ora locale dell'aeroporto."
},
"transmission": {
"enum": [
"manual",
"automatic"
],
"type": "string",
"description": "Solo auto: cambio manuale o automatico."
},
"depart_before": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Solo voli: andata che parte entro quest'ora, HH:MM ora locale dell'aeroporto."
},
"return_before": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Solo voli: ritorno che parte entro quest'ora, HH:MM ora locale dell'aeroporto."
}
},
"description": "Facoltativi, pochi e solo quelli del tipo; i booleani filtrano solo con true. La scelta attuale resta sempre la prima riga.",
"additionalProperties": false
},
"quote_id": {
"type": "string",
"pattern": "^q_[A-Za-z0-9]{1,62}$",
"description": "quote_id restituito da quote_trip."
},
"stop_index": {
"type": "integer",
"maximum": 9,
"minimum": 0,
"description": "Solo con type hotel: la tappa, da 0 come stays[].stop_index."
}
},
"additionalProperties": false
}| Argument | Type | Description |
|---|---|---|
| car | boolean | true = auto dall'aeroporto di arrivo a quello di ritorno; solo con transport "flight". Mettilo quando le tappe sono lontane fra loro o fuori dalle città. |
| days* | array | Un elemento per giorno di viaggio: esattamente somma delle nights + 1 (5 notti = 6 giorni). |
| stops* | array | Tappe in ordine di viaggio, da 1 a 10; al massimo 60 notti in tutto. Ogni tappa ha un hotel, cercato vicino alle coordinate: entro 3 km in città, entro 10 km in campagna, con un giudizio degli ospiti di almeno 7 su 10. |
| title* | string | Titolo del viaggio, in italiano: evocativo, per una pagina pubblica, senza nomi di persone né occasioni personali. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»). |
| flight | object | Obbligatorio con transport "flight"; assente con transport "none". Il ritorno arriva a from. |
| origin* | object | Luogo di partenza del viaggiatore (la sua città). |
| region | string | Facoltativo ma da compilare quando il viaggio sta in una zona precisa: regione o zona del paese, solo il nome (per esempio Highlands, Toscana). |
| country* | string | Paese principale del viaggio, quello con più notti (per esempio Portogallo). Un viaggio su più paesi va bene: le tappe in un altro paese lo dicono in stops[].country. |
| summary* | string | Una frase in italiano che invogli a leggere, in seconda persona. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»). |
| transport* | string | "flight" = volo andata e ritorno (serve flight); "none" = senza volo (niente flight e car: false). |
| travelers* | object | Al massimo 9 viaggiatori in totale, adulti e bambini. |
| start_date* | string | Data di partenza AAAA-MM-GG, da domani a 330 giorni da oggi compresi: è il check-in della prima tappa. Quella scritta nella proposta del giro (regola delle date); la data dell'esempio non va copiata. |
| description* | string | Racconto del viaggio in italiano, almeno 800 caratteri: in seconda persona, frasi brevi, dettagli concreti (luoghi, esperienze, sapori, consigli pratici), mai un elenco. Pagina pubblica: niente nomi, occasioni personali o riferimenti a chi viaggia. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»). |
| preferences | object | Facoltativo: solo le preferenze dette dal cliente, mai inventate. Per ogni voce il server sceglie la più economica che le rispetta tutte; se nessuna le rispetta, la più economica, con una nota in preference_notes. I booleani valgono solo con true. |
| travel_styles | array | Facoltativo: i tipi di viaggio, al massimo 3, fra i valori elencati nella descrizione dello strumento (grandi-classici, fuori-rotta, on-the-road, natura, citta-e-cultura, mare-e-relax, enogastronomia, slow, famiglia, avventura); gli altri si ignorano. |
| requested_days | integer | La durata in GIORNI detta dal cliente o proposta da te (7 giorni = 6 notti: andata il giorno 1, ritorno il giorno 7). Le notti delle tappe devono essere esattamente questo numero meno uno, altrimenti il server rifiuta. Usa questo campo oppure requested_nights. |
| requested_nights | integer | La durata in NOTTI, se il cliente o tu l'avete detta in notti («una settimana» = 7 notti, «un weekend lungo» = le 2 o 3 notti proposte). Le notti delle tappe devono essere esattamente queste, altrimenti il server rifiuta. Usa questo campo oppure requested_days. |
{
"type": "object",
"examples": [
{
"car": false,
"days": [
{
"title": "Arrivo a Lisbona e l'Alfama",
"description": "Lasci i bagagli in hotel e scendi subito nell'Alfama, il quartiere più antico. Cammini fra vicoli stretti, panni stesi e piccole chiese, finché arrivi al Miradouro de Santa Luzia: da qui vedi i tetti rossi e il Tago che si apre verso l'oceano. Al tramonto cerchi una taverna di fado e ordini sardine alla brace. Consiglio: il tram 28 è comodo ma affollato, prendilo presto al mattino.",
"points_of_interest": [
{
"lat": 38.7114,
"lng": -9.13,
"name": "Alfama",
"note": "Il quartiere più antico, fra vicoli, panni stesi e taverne di fado"
},
{
"lat": 38.7119,
"lng": -9.1302,
"name": "Miradouro de Santa Luzia",
"note": "Belvedere fra azulejos e bougainville, con i tetti rossi che scendono al Tago"
}
]
},
{
"title": "Belém, fra torri e pasticcini",
"description": "Al mattino prendi il tram 15 verso Belém. La Torre di Belém sembra galleggiare sul fiume, e a pochi passi il Monastero dos Jerónimos ti sorprende con il suo chiostro di pietra lavorata come un merletto. Poi la tappa che nessuno salta: i pastéis de nata ancora tiepidi, con zucchero a velo e cannella. Nel pomeriggio torni in centro e sali al Bairro Alto per l'aperitivo.",
"points_of_interest": [
{
"lat": 38.6916,
"lng": -9.216,
"name": "Torre di Belém",
"note": "Torre del Cinquecento che sembra galleggiare sul fiume"
},
{
"lat": 38.6979,
"lng": -9.2068,
"name": "Monastero dos Jerónimos",
"note": "Chiostro di pietra lavorata come un merletto"
}
]
},
{
"title": "In treno verso Porto",
"description": "Il treno da Santa Apolónia ti porta a Porto in circa tre ore, fra vigneti e piccoli paesi. Appena arrivi entri nella Stazione di São Bento, con le pareti coperte di azulejos bianchi e blu che raccontano la storia del Portogallo. Poi scendi a piedi verso la Ribeira, fra case colorate affacciate sul fiume, e ceni con una francesinha, il panino ricco e sostanzioso della città.",
"points_of_interest": [
{
"lat": 41.1456,
"lng": -8.6107,
"name": "Stazione di São Bento",
"note": "Atrio coperto da ventimila azulejos che raccontano il Portogallo"
},
{
"lat": 41.1408,
"lng": -8.6131,
"name": "Ribeira",
"note": "Case colorate sul Douro, il cuore più vivace di Porto"
}
]
},
{
"title": "Il Douro e le cantine del Porto",
"description": "Attraversi il Ponte Dom Luís I sul livello alto, dove passa la metro, e ti godi la vista più bella sulla città. Dall'altra parte, a Vila Nova de Gaia, visiti una cantina: vedi le botti di rovere, impari la differenza fra ruby e tawny e assaggi il vino con un pezzo di formaggio. Nel pomeriggio puoi fare una breve crociera sul Douro. Consiglio: prenota la visita alla cantina il giorno prima.",
"points_of_interest": [
{
"lat": 41.1399,
"lng": -8.6094,
"name": "Ponte Dom Luís I",
"note": "Dal livello alto la vista più bella sulla città"
},
{
"lat": 41.137,
"lng": -8.614,
"name": "Vila Nova de Gaia",
"note": "Le cantine dove il Porto invecchia in botti di rovere"
}
]
},
{
"title": "Ultima passeggiata e rientro",
"description": "Prima del volo ti resta una mattina per le ultime meraviglie. Fai la coda presto alla Livraria Lello, con la sua scala rossa di legno intagliato, poi sali i gradini della Torre dos Clérigos per salutare Porto dall'alto. Un ultimo caffè con un dolce di pasta sfoglia, e vai all'aeroporto, che dal centro raggiungi in metro in circa mezz'ora.",
"points_of_interest": [
{
"lat": 41.1469,
"lng": -8.615,
"name": "Livraria Lello",
"note": "Libreria con una scala rossa di legno intagliato"
},
{
"lat": 41.1457,
"lng": -8.6146,
"name": "Torre dos Clérigos",
"note": "Campanile barocco da cui saluti Porto dall'alto"
}
]
}
],
"stops": [
{
"lat": 38.7223,
"lng": -9.1393,
"label": "Lisbona",
"nights": 2
},
{
"lat": 41.1579,
"lng": -8.6291,
"label": "Porto",
"nights": 2
}
],
"title": "Lisbona e Porto in 5 giorni",
"flight": {
"to": "LIS",
"from": "MXP",
"return_from": "OPO"
},
"origin": {
"lat": 45.4642,
"lng": 9.19
},
"country": "Portogallo",
"summary": "Dai tram gialli di Lisbona alle cantine sul Douro: cinque giorni di luce, azulejos e vino di Porto.",
"transport": "flight",
"travelers": {
"adults": 2,
"children_ages": [
7
]
},
"start_date": "2027-01-01",
"description": "Atterri a Lisbona e la città ti accoglie con la sua luce dorata, che rimbalza sulle facciate di azulejos e sul Tago. Ti perdi nei vicoli dell'Alfama, sali sul tram 28 che arranca fra le colline e ti fermi nei belvedere per guardare i tetti rossi scendere verso il fiume. La sera ascolti il fado in una taverna, con un bicchiere di vinho verde e un piatto di sardine alla brace. Il secondo giorno vai a Belém, fra la torre sul fiume e il monastero dei Jerónimos, e assaggi i pastéis de nata ancora tiepidi, spolverati di cannella. Poi prendi il treno verso nord: in tre ore sei a Porto, la città del vino che porta il suo nome. Scendi a piedi verso la Ribeira, attraversi il ponte Dom Luís I e, dall'altra parte, a Vila Nova de Gaia, entri nelle cantine dove il Porto invecchia in botti di rovere. Un consiglio pratico: scarpe comode, perché entrambe le città sono fatte di salite, scalinate e sampietrini. E tieni da parte l'ultima sera per un tramonto sul Douro.",
"requested_days": 5
}
],
"required": [
"title",
"summary",
"description",
"country",
"origin",
"start_date",
"travelers",
"stops",
"days",
"transport"
],
"properties": {
"car": {
"type": "boolean",
"default": false,
"description": "true = auto dall'aeroporto di arrivo a quello di ritorno; solo con transport \"flight\". Mettilo quando le tappe sono lontane fra loro o fuori dalle città."
},
"days": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"description"
],
"properties": {
"title": {
"type": "string",
"pattern": "\\S",
"maxLength": 200,
"description": "Titolo del giorno, in italiano."
},
"description": {
"type": "string",
"pattern": "\\S",
"maxLength": 5000,
"description": "Programma del giorno in italiano, almeno 300 caratteri: in seconda persona, frasi brevi, cosa vedi e fai, sapori e consigli pratici; nomina i punti di interesse. Pagina pubblica: niente nomi né riferimenti a chi viaggia."
},
"points_of_interest": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitudine del luogo stesso, gradi decimali, diversa da 0; da dare sempre, insieme a lng. Mostra il luogo sulla mappa; ignorata se a più di 50 km dalla tappa del giorno."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitudine del luogo stesso, gradi decimali, diversa da 0; da dare sempre, insieme a lat."
},
"name": {
"type": "string",
"pattern": "\\S",
"maxLength": 200,
"description": "Nome di un luogo vero da vedere."
},
"note": {
"type": "string",
"maxLength": 160,
"description": "Una frase, al massimo 160 caratteri, che dice perché vale la pena (per esempio «Grotta naturale sul mare dove ci si tuffa d'estate»); appare sulla mappa. Testo semplice: niente nomi di persone, link o contatti."
}
},
"additionalProperties": false
},
"maxItems": 10,
"description": "Luoghi veri da vedere quel giorno (monumenti, quartieri, musei, panorami, borghi e luoghi meno noti; non la città della tappa), ognuno con lat, lng e note, entro circa 20 km dalla tappa del giorno (oltre solo in un giorno di escursione), mai ripetuti: almeno 1, 2–4 consigliati in ogni giorno, al massimo 10."
}
},
"additionalProperties": false
},
"maxItems": 61,
"minItems": 2,
"description": "Un elemento per giorno di viaggio: esattamente somma delle nights + 1 (5 notti = 6 giorni)."
},
"stops": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"lat",
"lng",
"nights"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitudine del CENTRO della località (non dell'aeroporto), gradi decimali, diversa da 0."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitudine del CENTRO della località, gradi decimali, diversa da 0."
},
"label": {
"type": "string",
"pattern": "\\S",
"maxLength": 120,
"description": "Nome della località (per esempio Lisbona)."
},
"nights": {
"type": "integer",
"maximum": 60,
"minimum": 1,
"description": "Notti nella tappa, almeno 1 (meglio più notti)."
},
"country": {
"type": "string",
"pattern": "\\S",
"maxLength": 60,
"description": "Facoltativo: il paese della tappa, solo se diverso da country (viaggio su più paesi, per esempio Croazia per Motovun in un viaggio in Slovenia)."
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1,
"description": "Tappe in ordine di viaggio, da 1 a 10; al massimo 60 notti in tutto. Ogni tappa ha un hotel, cercato vicino alle coordinate: entro 3 km in città, entro 10 km in campagna, con un giudizio degli ospiti di almeno 7 su 10."
},
"title": {
"type": "string",
"pattern": "\\S",
"maxLength": 200,
"description": "Titolo del viaggio, in italiano: evocativo, per una pagina pubblica, senza nomi di persone né occasioni personali. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»)."
},
"flight": {
"type": "object",
"required": [
"from",
"to",
"return_from"
],
"properties": {
"to": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "Aeroporto di arrivo, vicino alla prima tappa. Milano: LIN solo se il cliente ha detto Linate, BGY solo se ha detto Bergamo, altrimenti MXP. Codice IATA di 3 lettere maiuscole di un aeroporto principale con voli di linea."
},
"from": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "Aeroporto di partenza, vicino a origin. Milano: LIN solo se il cliente ha detto Linate, BGY solo se ha detto Bergamo, altrimenti MXP. Codice IATA di 3 lettere maiuscole di un aeroporto principale con voli di linea."
},
"return_from": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "Aeroporto del volo di ritorno, vicino all'ultima tappa; può differire da to. Milano: LIN solo se il cliente ha detto Linate, BGY solo se ha detto Bergamo, altrimenti MXP. Codice IATA di 3 lettere maiuscole di un aeroporto principale con voli di linea."
}
},
"description": "Obbligatorio con transport \"flight\"; assente con transport \"none\". Il ritorno arriva a from.",
"additionalProperties": false
},
"origin": {
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Gradi decimali, diversa da 0."
},
"lng": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Gradi decimali, diversa da 0."
}
},
"description": "Luogo di partenza del viaggiatore (la sua città).",
"additionalProperties": false
},
"region": {
"type": "string",
"pattern": "\\S",
"maxLength": 60,
"description": "Facoltativo ma da compilare quando il viaggio sta in una zona precisa: regione o zona del paese, solo il nome (per esempio Highlands, Toscana)."
},
"country": {
"type": "string",
"pattern": "\\S",
"maxLength": 60,
"description": "Paese principale del viaggio, quello con più notti (per esempio Portogallo). Un viaggio su più paesi va bene: le tappe in un altro paese lo dicono in stops[].country."
},
"summary": {
"type": "string",
"pattern": "\\S",
"maxLength": 500,
"description": "Una frase in italiano che invogli a leggere, in seconda persona. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»)."
},
"transport": {
"enum": [
"flight",
"none"
],
"type": "string",
"description": "\"flight\" = volo andata e ritorno (serve flight); \"none\" = senza volo (niente flight e car: false)."
},
"travelers": {
"type": "object",
"required": [
"adults"
],
"properties": {
"adults": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "Adulti (18 anni o più), almeno 1."
},
"children_ages": {
"type": "array",
"items": {
"type": "integer",
"maximum": 17,
"minimum": 0
},
"maxItems": 8,
"description": "Età di ogni bambino al viaggio (0–17), una per bambino; vuoto se nessuno. Con il volo i neonati (meno di 2 anni) non possono essere più degli adulti."
}
},
"description": "Al massimo 9 viaggiatori in totale, adulti e bambini.",
"additionalProperties": false
},
"start_date": {
"type": "string",
"format": "date",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Data di partenza AAAA-MM-GG, da domani a 330 giorni da oggi compresi: è il check-in della prima tappa. Quella scritta nella proposta del giro (regola delle date); la data dell'esempio non va copiata."
},
"description": {
"type": "string",
"pattern": "\\S",
"maxLength": 5000,
"description": "Racconto del viaggio in italiano, almeno 800 caratteri: in seconda persona, frasi brevi, dettagli concreti (luoghi, esperienze, sapori, consigli pratici), mai un elenco. Pagina pubblica: niente nomi, occasioni personali o riferimenti a chi viaggia. Linguaggio naturale: mai termini tecnici come open-jaw, multi-city, IATA, PNR o codici aeroporto («arrivo a Lisbona, ripartenza da Porto»)."
},
"preferences": {
"type": "object",
"properties": {
"car": {
"type": "object",
"properties": {
"min_seats": {
"type": "integer",
"maximum": 9,
"minimum": 2,
"description": "Posti minimi."
},
"transmission": {
"enum": [
"manual",
"automatic"
],
"type": "string",
"description": "Cambio manuale o automatico."
}
},
"description": "Solo con car true.",
"additionalProperties": false
},
"hotel": {
"type": "object",
"properties": {
"breakfast": {
"type": "boolean",
"description": "true = colazione inclusa."
},
"min_stars": {
"type": "number",
"maximum": 5,
"minimum": 1,
"description": "Stelle minime dell'hotel."
},
"refundable": {
"type": "boolean",
"description": "true = tariffa rimborsabile."
}
},
"description": "Per l'hotel di ogni tappa.",
"additionalProperties": false
},
"flight": {
"type": "object",
"properties": {
"max_stops": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "Scali al massimo per tratta (0 = solo voli diretti)."
},
"checked_bag": {
"type": "boolean",
"description": "true = almeno un bagaglio in stiva incluso."
},
"depart_after": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Andata che parte da quest'ora. HH:MM, ora locale dell'aeroporto di partenza, estremo compreso."
},
"return_after": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Ritorno che parte da quest'ora. HH:MM, ora locale dell'aeroporto di partenza, estremo compreso."
},
"depart_before": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Andata che parte entro quest'ora. HH:MM, ora locale dell'aeroporto di partenza, estremo compreso."
},
"return_before": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$",
"description": "Ritorno che parte entro quest'ora. HH:MM, ora locale dell'aeroporto di partenza, estremo compreso."
}
},
"description": "Solo con transport \"flight\".",
"additionalProperties": false
}
},
"description": "Facoltativo: solo le preferenze dette dal cliente, mai inventate. Per ogni voce il server sceglie la più economica che le rispetta tutte; se nessuna le rispetta, la più economica, con una nota in preference_notes. I booleani valgono solo con true.",
"additionalProperties": false
},
"travel_styles": {
"type": "array",
"items": {
"type": "string"
},
"description": "Facoltativo: i tipi di viaggio, al massimo 3, fra i valori elencati nella descrizione dello strumento (grandi-classici, fuori-rotta, on-the-road, natura, citta-e-cultura, mare-e-relax, enogastronomia, slow, famiglia, avventura); gli altri si ignorano."
},
"requested_days": {
"type": "integer",
"maximum": 61,
"minimum": 2,
"description": "La durata in GIORNI detta dal cliente o proposta da te (7 giorni = 6 notti: andata il giorno 1, ritorno il giorno 7). Le notti delle tappe devono essere esattamente questo numero meno uno, altrimenti il server rifiuta. Usa questo campo oppure requested_nights."
},
"requested_nights": {
"type": "integer",
"maximum": 60,
"minimum": 1,
"description": "La durata in NOTTI, se il cliente o tu l'avete detta in notti («una settimana» = 7 notti, «un weekend lungo» = le 2 o 3 notti proposte). Le notti delle tappe devono essere esattamente queste, altrimenti il server rifiuta. Usa questo campo oppure requested_days."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"quote_id",
"type",
"option_id"
],
"properties": {
"type": {
"enum": [
"flight",
"hotel",
"car"
],
"type": "string",
"description": "Lo stesso type di list_trip_options: flight, hotel (con stop_index) o car."
},
"quote_id": {
"type": "string",
"pattern": "^q_[A-Za-z0-9]{1,62}$",
"description": "quote_id restituito da quote_trip."
},
"option_id": {
"type": "string",
"pattern": "^[fhc]_[0-9a-f]{16}$",
"description": "options[].option_id della riga scelta (o options[].other_fares[].option_id della tariffa scelta), così com'è in list_trip_options."
},
"stop_index": {
"type": "integer",
"maximum": 9,
"minimum": 0,
"description": "Solo con type hotel: la tappa, da 0, la stessa di list_trip_options."
}
},
"additionalProperties": false
}