Travel Promos Argentina

Consulta promociones de viajes (vuelos, hoteles y paquetes) y permite filtrarlas y ordenarlas localmente.

API Overview

• Base URL: https://anduin.ferminrp.com
• Auth: None required
• Response format: JSON
• Endpoint principal: /api/v1/promos
• OpenAPI: https://anduin.ferminrp.com/docs/openapi.json
• Fuente upstream: data.source
• Timestamps relevantes:
  • data.lastUpdated (actualizacion de promos)
  • timestamp (respuesta del servicio)
• Query params documentados para /api/v1/promos: ninguno
• Nota: los query params probados (category, destinationCountry, limit, q) no filtran en origen; filtrar localmente con jq (verificado sobre la respuesta actual del endpoint).

Endpoint

• GET /api/v1/promos

Ejemplos de uso:

curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos[0:5]'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos | map(select(.category == "vuelos"))'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos | map(select(.category == "autos"))'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos | map(select(.destinationCountry == "brazil"))'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos | sort_by(.date) | reverse | .[0:10]'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos | sort_by(-.score) | .[0:10]'

Campos clave

• Top-level:
  • success (bool)
  • timestamp (ISO datetime)
• data:
  • lastUpdated (ISO datetime)
  • source (URL de origen)
  • totalPromos (int)
  • promos (array)
• promos[]:
  • id, date, title, permalink, thumbnailUrl
  • destinationCountry (puede ser null)
  • category
  • score (numerico para ranking, puede no venir si falla clasificacion AI)
• Valores dinamicos observados hoy (ejemplos, no lista cerrada):
  • category: vuelos, hoteles, autos, paquetes, asistencia, otros
  • destinationCountry: brazil, united_states, spain, dominican_republic, aruba, mexico, japan, portugal, europe, null
• Semantica adicional:
  • permalink se construye dinamicamente como /links/viajes/:id sobre el host de la request

Workflow

1. Detectar intencion del usuario:
   • Listado general
   • Filtro por categoria o pais
   • Ranking por score
   • Ultimas promos
2. Consultar endpoint unico con curl -s.
3. Validar success == true y existencia de data.promos.
4. Aplicar filtros y orden localmente con jq:
   • Por category
   • Por destinationCountry
   • Por texto en title o id cuando aplique
   • Por date o score
5. Responder primero con snapshot:
   • Cantidad total (totalPromos)
   • lastUpdated
   • Top 3 promos por score o relevancia
6. Luego mostrar tabla corta (top 5/10):
   • date | category | destinationCountry | score | title
7. Incluir solo permalink para promos mostradas.
8. Mantener respuesta informativa, sin consejos financieros ni garantias de disponibilidad.

Error Handling

• HTTP no exitoso:
  • Informar codigo HTTP y endpoint consultado.
• 404 (No promos data available):
  • Informar que no hay datos cacheados de promos en este momento.
• success: false:
  • Mostrar payload de error si existe.
• JSON inesperado:
  • Mostrar minimo crudo util y aclarar inconsistencia.
• Red o timeout:
  • Reintentar hasta 2 veces con espera corta.
• promos vacio:
  • Informar "no hay promociones disponibles actualmente".

Presenting Results

• Formato por defecto:
  • Resumen ejecutivo + tabla corta
• Priorizar:
  • Recencia (date)
  • Relevancia (score)
  • Claridad de destino y categoria
• Aclarar timestamps (lastUpdated y/o timestamp) y la fuente externa (data.source).
• No emitir recomendaciones de compra; solo informar promociones disponibles.

Out of Scope

Esta skill no debe hacer en v1:

• Scraping directo de sitios externos
• Automatizacion de reserva o compra
• Alertas push, notificaciones o tracking de cambios
• Uso de endpoints distintos de /api/v1/promos