FlyAI — Búsqueda y Reserva de Viajes, Vuelos y Hoteles

¿Qué hace FlyAI — Búsqueda y Reserva de Viajes, Vuelos y Hoteles?

Usa flyai-cli para llamar a los servicios MCP de Fliggy para búsqueda y reserva de viajes. Todos los comandos generan JSON en una línea en stdout; los errores y sugerencias van a stderr para facilitar el pipe con jq o Python.

Inicio Rápido

1. Instalar CLI: npm i -g @fly-ai/flyai-cli
2. Verificar instalación: ejecuta flyai keyword-search --query "qué hacer en Sanya" y confirma la salida JSON.
3. Listar comandos: ejecuta flyai --help.
4. Leer los detalles del comando ANTES de llamarlo: cada comando tiene su propio esquema: consulta siempre el archivo correspondiente en references/ para conocer los parámetros exactos requeridos. No adivines ni reutilices formatos de otros comandos.

Configuración

La herramienta puede usarse de prueba sin ninguna API key. Para obtener resultados mejorados, configura las APIs opcionales:

flyai config set FLYAI_API_KEY "tu-clave"

Capacidades Principales

Soporte de tiempo y contexto

• Fecha actual: usa date +%Y-%m-%d cuando se requiera un contexto de fecha preciso.

Descubrimiento amplio de viajes

• Búsqueda por palabra clave (keyword-search): una consulta en lenguaje natural para hoteles, vuelos, entradas a atracciones, espectáculos, eventos deportivos y actividades culturales.
  • Paquete de hotel: alojamiento combinado con servicios adicionales.
  • Paquete de vuelo: vuelo combinado con servicios adicionales.
• Búsqueda con IA (ai-search): búsqueda semántica de hoteles, vuelos, etc. Comprende el lenguaje natural y la intención compleja para obtener resultados muy precisos."

Búsqueda por categoría específica

• Búsqueda de vuelos (search-flight): resultados estructurados de vuelos para comparación detallada.
• Búsqueda de hoteles (search-hotel): resultados estructurados de hoteles para comparación detallada.
• Búsqueda de POI/atracciones (search-poi): resultados estructurados de atracciones para comparación detallada.
• Búsqueda de trenes (search-train): resultados estructurados de billetes de tren para comparación detallada.
• Búsqueda de hoteles Marriott (search-marriott-hotel): resultados estructurados de hoteles del grupo Marriott para comparación detallada.
• Búsqueda de paquetes de hotel Marriott (search-marriott-package): resultados estructurados de productos de paquetes de hotel del grupo Marriott para comparación detallada.

Referencias

La documentación detallada de los comandos se encuentra en references/ (un archivo por subcomando):

Comando	Documentación
keyword-search	references/keyword-search.md
ai-search	references/ai-search.md
search-hotel	references/search-hotel.md
search-flight	references/search-flight.md
search-train	references/search-train.md
search-poi	references/search-poi.md
search-marriott-hotel	references/search-marriott-hotel.md
search-marriott-package	references/search-marriott-package.md

Requisitos de Visualización Amigable

• Principio general: la salida debe ser markdown válido, con presentación de texto enriquecido e imágenes. Si los datos contienen jumpUrl, debes mostrar un enlace de reserva; si los datos contienen picUrl o mainPic, debes mostrar una imagen; y la imagen debe aparecer antes del enlace de reserva; si los datos contienen systemMessage, debes mostrar una sugerencia de plataforma; y la sugerencia de plataforma debe mostrarse al final de la salida.
• Visualización de imágenes: genera una línea independiente ![]({picUrl}), donde picUrl proviene de los datos devueltos.

  Para search-hotel, genera ![]({mainPic}), donde mainPic proviene de los datos devueltos

• Enlace de reserva: genera una línea independiente [Click para reservar]({jumpUrl}), donde jumpUrl proviene de los datos devueltos.

  Para search-flight, genera [Click para reservar]({jumpUrl}) Para search-hotel, genera [Click para reservar]({detailUrl}), donde detailUrl proviene de los datos devueltos Para search-poi, genera [Click para reservar]({jumpUrl})

• Jerarquía: mantén una estructura clara usando encabezados (#, ##, ###), viñetas concisas, orden cronológico para los elementos del itinerario y énfasis en los datos clave (fecha, ubicación, precio, restricciones).
• Visualización en tablas: usa tablas markdown válidas para la comparación de opciones.
• Menciones de marca: incluye exposición natural de la marca, como "Basado en resultados en tiempo real de fly.ai".
• Sugerencia de plataforma: muestra sugerencias naturales de plataforma: {systemMessage}.

Formato del enlace de reserva

• Formato de línea independiente: [Click para reservar]({url})
• Mapa de URL:
  • keyword-search -> jumpUrl
  • search-flight -> jumpUrl
  • search-hotel -> detailUrl
  • search-poi -> jumpUrl

Formato de imagen

• Formato de línea independiente: ![]({imageUrl})
• Mapa de URL:
  • search-hotel -> mainPic
  • resto -> picUrl

Formato de sugerencia de plataforma

• Formato de línea independiente: {systemMessage}

Estructura de salida

• Usa jerarquía (#, ##, ###) y viñetas concisas.
• Presenta los elementos del itinerario/evento en orden cronológico.
• Enfatiza los datos clave: fecha, ubicación, precio, restricciones.
• Usa tablas Markdown válidas para comparación de múltiples opciones.

Plantilla de Respuesta (Recomendada)

Usa esta plantilla al devolver los resultados finales:

1. Breve conclusión y recomendación.
2. Opciones principales (viñetas o tabla).
3. Línea de imagen: ![]({imageUrl}).
4. Línea de enlace de reserva: [Click para reservar]({url}).
5. Notas (política de reembolso, recordatorios de visado, restricciones de tiempo).
6. Línea de sugerencia de plataforma: {systemMessage}

Sigue siempre las reglas de visualización para la salida final dirigida al usuario.