航班 — 通过 Travelpayouts/Aviasales 进行机票搜索

前提条件

必须设置环境变量 TRAVELPAYOUTS_TOKEN，其值为有效的 Travelpayouts API Token。

快速参考

使用方法

1. 解析 IATA 代码

若用户输入的是城市名称而非 IATA 代码，请先执行解析：

python3 scripts/search_flights.py --lookup "Istanbul"

从中选取最相关结果的 code 字段值。

2. 按特定日期搜索航班

python3 scripts/search_flights.py --from MOW --to LED --date 2026-04-15 --return 2026-04-20

添加 --direct 参数仅返回直飞航班；添加 --limit N 可限制返回结果数量（默认为 10 条）。

3. 价格日历（某月内各天最低票价）

python3 scripts/search_flights.py --from MOW --to LED --month 2026-04

结果按价格升序排列，可用于向用户推荐最具性价比的出行日期。

4. 最新查得的价格（价格监控）

python3 scripts/search_flights.py --from MOW --latest

显示从出发地到任意目的地的近期查得价格。可添加 --to AER 进行目的地筛选；添加 --one-way 则仅返回单程价格。

5. 从某城市出发的热门目的地

python3 scripts/search_flights.py --from MOW --directions

结果按价格升序排列，适用于回答“从 X 出发，哪些地方机票最便宜？”之类的问题。

输出格式

所有命令均将 JSON 格式结果输出至标准输出（stdout）：

{
  "query": {"from": "MOW", "to": "LED", "date": "2026-04-15"},
  "results": [
    {
      "price": 2454,
      "airline": "Pobeda",
      "airline_code": "DP",
      "flight": "DP 209",
      "from_airport": "VKO",
      "to_airport": "LED",
      "departure": "2026-04-07T07:50:00+03:00",
      "duration_min": 90,
      "duration_str": "1h 30min",
      "transfers": 0,
      "transfers_str": "non-stop",
      "link": "https://aviasales.ru/search/..."
    }
  ],
  "cheapest": 2454,
  "count": 5
}

面向用户的结果呈现方式

1. 优先高亮显示最便宜的选项；
2. 每条结果应展示：价格、航司名称、航班号、起飞时间、总时长、是否经停；
3. 将 link 字段格式化为可点击的预订链接；
4. 对于价格日历类查询，应主动推荐其中价格最低的出行日期。

API 接口端点

常用 IATA 机场代码

参考资料

• 航空公司代码：详见 references/airlines.md 文件，其中提供了 IATA 航空公司代码与名称的对照表。脚本会自动从 Travelpayouts API 获取最新映射（缓存有效期为 24 小时）；该文件仅作为备用 fallback。