Find Flights (Duffel)

🚀 找到正確的航班

本項目提供了一系列工具，可幫助你方便快捷地查找各種類型的航班信息，支持單程、往返和多城市航班搜索，還能獲取航班詳細信息，同時具備健壯的錯誤處理機制。

🚀 快速開始

你可以使用本項目提供的工具來查找各種複雜度的航班，以下是一些使用示例：

• "查找2025年1月7日從SFO到紐約的單程航班，2名成人商務艙"
• "查找往返於洛杉磯和倫敦的航班，出發日期為2025年1月8日，返回日期為2025年1月15日"
• "計劃一次從紐約到巴黎的多城市旅行，2025年1月7日出發，然後前往羅馬2025年1月10日，最後返回紐約2025年1月15日"
• "2025年1月7日至2025年1月15日期間，2名成人經濟艙從SFO到LAX的最便宜航班是什麼？"
• 你甚至可以搜索在多天內往返的航班。目前推薦用於單程或往返航班。例如："查找2025年1月7日至2025年1月10日期間，2名成人經濟艙從SFO到LAX的最便宜航班"

✨ 主要特性

• 支持三種類型的航班搜索：單程航班、往返航班、多個城市航班。
• 可獲取特定航班報價的詳細信息。
• 具備健壯的錯誤處理功能，能應對多種異常情況。

💻 使用示例

基礎用法

@mcp工具()
異步函數搜索航班（參數：FlightSearch）-> str：
    """根據參數查找航班。"""

支持三種類型的航班：

• 單程航班
• 往返航班
• 多個城市航班

參數包括：

• type: 航班類型 ('one_way', 'round_trip', 'multi_city')
• origin: 出發地機場代碼
• destination: 目的地機場代碼
• departure_date: 出發日期 (YYYY-MM-DD)
• 可選參數:
  • return_date: 返程日期（用於往返航班）
  • adults: 成人乘客數量
  • cabin_class: 偏好的艙位等級
  • departure_time: 具體的出發時間範圍
  • arrival_time: 具體的到達時間範圍
  • max_connections: 最大連接次數

高級用法

@mcp工具()
異步函數獲取offer_details（參數：OfferDetails）-> str：
    """獲取特定航班報價的詳細信息。"""

使用唯一的ID獲取特定航班報價的全面詳細信息。

@mcp工具(name="search_multi_city")
異步函數搜索multi_city（參數：MultiCityRequest）-> str：
    """搜索多城市航班。"""

專門用於複雜多城市航班行程的工具。

參數包括：

• segments: 航班段落列表
• adults: 成人乘客數量
• cabin_class: 偏好的艙位等級
• max_connections: 最大連接次數

📚 詳細文檔

響應格式

工具返回JSON格式的響應，包括：

• 航班報價詳細信息
• 價格信息
• 路線詳細信息
• 承運人信息
• 連接詳細信息

錯誤處理

該服務包含健壯的錯誤處理功能，包括：

• API請求失敗
• 無效機場代碼
• 缺失或無效API密鑰
• 網絡超時
• 無效搜索參數

性能注意事項

• 每次航班搜索最多返回10個結果。
• 複雜的多城市行程可能需要更長的處理時間。

通過遵循這些指南，你可以有效地使用提供的工具來查找和管理航班。