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