travel-promos-argentina

Travel Promos Argentina

旅行プロモーション（フライト、ホテル、パッケージ）を確認し、ローカルでフィルタリングや並べ替えができます。

API 概要

• ベース URL: https://anduin.ferminrp.com
• 認証: 不要
• レスポンス形式: JSON
• 主なエンドポイント: /api/v1/promos
• OpenAPI: https://anduin.ferminrp.com/docs/openapi.json
• 上流ソース: data.source
• 運用上のお知らせチャンネル: https://t.me/comparaviajes (@comparaviajes)、新しいプロモーションを1時間ごとに投稿
• 関連するタイムスタンプ:
  • data.lastUpdated（プロモーションの更新日時）
  • timestamp（サービスのレスポンス日時）
• /api/v1/promos 用として文書化されているクエリパラメーター: なし
• 注: 試したクエリパラメーター（category、destinationCountry、limit、q）ではソース側でフィルタリングされません。jq を使ってローカルでフィルタリングしてください（エンドポイントの現在のレスポンスで確認済み）。

エンドポイント

• GET /api/v1/promos

使用例：

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]'

主なフィールド

• トップレベル:
  • success（bool）
  • timestamp（ISO datetime）
• data:
  • lastUpdated（ISO datetime）
  • source（ソース URL）
  • totalPromos（int）
  • promos（array）
• promos[]:
  • id、date、title、permalink、thumbnailUrl
  • destinationCountry（null の場合があります）
  • category
  • score（ランキング用の数値。AI による分類に失敗した場合、含まれないことがあります）
• 今日確認された動的な値（例であり、すべてを網羅したリストではありません）:
  • category: vuelos、hoteles、autos、paquetes、asistencia、otros
  • destinationCountry: brazil、united_states、spain、dominican_republic、aruba、mexico、japan、portugal、europe、null
• その他の仕様:
  • permalink は、リクエストのホスト上で /links/viajes/:id として動的に構築されます。

ワークフロー

1. ユーザーの意図を把握します:
   • 全般的な一覧
   • カテゴリーまたは国によるフィルター
   • スコア順のランキング
   • 最新のプロモーション
2. curl -s を使って単一のエンドポイントに問い合わせます。
3. success == true と data.promos の存在を確認します。
4. jq を使って、ローカルでフィルターや並べ替えを行います:
   • category によるフィルター
   • destinationCountry によるフィルター
   • 該当する場合は title または id のテキストによるフィルター
   • date または score による並べ替え
5. まず、スナップショットを提示します:
   • 合計件数（totalPromos）
   • lastUpdated
   • スコアまたは関連性が高いプロモーションの上位3件
6. 次に、簡潔な表（上位5件または10件）を表示します:
   • date | category | destinationCountry | score | title
7. 表示するプロモーションの permalink のみを記載します。
8. 金融上の助言や利用可能性の保証をせず、情報提供に徹します。
9. ユーザーがリアルタイムの最新情報を求めた場合は、@comparaviajes（https://t.me/comparaviajes）でも最新情報を確認できることを伝えます。

エラー処理

• HTTP リクエストが成功しなかった場合:
  • HTTP ステータスコードと問い合わせたエンドポイントを伝えます。
• 404（No promos data available）:
  • 現時点でプロモーションのキャッシュデータがないことを伝えます。
• success: false:
  • エラーペイロードがあれば表示します。
• 想定外の JSON:
  • 最低限有用な内容をそのまま表示し、不整合があることを明記します。
• ネットワークエラーまたはタイムアウト:
  • 短い待ち時間を挟んで、最大2回再試行します。
• promos が空の場合:
  • 「現在、利用可能なプロモーションはありません」と伝えます。

結果の提示

• デフォルトの形式:
  • 概要 + 簡潔な表
• 優先する項目:
  • 新しさ（date）
  • 関連性（score）
  • 目的地とカテゴリーの明確さ
• タイムスタンプ（lastUpdated および／または timestamp）と外部ソース（data.source）を明記します。
• 該当する場合は、Telegram の https://t.me/comparaviajes で毎時更新を確認できる旨を補足します。
• 購入の推奨は行わず、利用可能なプロモーションの情報のみを伝えます。

対象外

このスキルでは、v1 で以下を行いません:

• 外部サイトの直接スクレイピング
• 予約または購入の自動化
• プッシュアラート、通知、変更の追跡
• /api/v1/promos 以外のエンドポイントの使用