mcpField
F
flights

flights

github.com/tychohq生产力0117 次安装31 周前更新
代码仓库

关于 flights

flights 是用于查询实时航班时刻与价格的命令行技能,数据来自 Google Flights。可按城市或 IATA 机场代码搜索,并筛选停靠次数、舱位和出发时间。

主要功能

  1. 01实时查询航班时刻与价格
  2. 02城市名覆盖都会区机场
  3. 03筛选经停、舱位与乘客数
  4. 04按出发时间筛选
  5. 05生成 Google Flights 链接

适用场景

  1. 01比较特定日期的航班价格
  2. 02查找指定时间段出发的航班
  3. 03筛选直飞或特定舱位航班

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/tychohq/agent-skills --skill flights

安装后在 Claude Code 中输入/flights确认已加载。

附带文件scripts/flights-search

详细介绍

航班搜索

通过 Google Flights 数据搜索实时航班时刻表和价格。

前提条件

  • Python 3.9+
  • uv(推荐)——使用 curl -LsSf https://astral.sh/uv/install.sh | sh 安装

flights-search CLI 随附于此技能目录下的 scripts/flights-search。

首次运行时会通过 uvx 自动安装 fast-flights 库(之后会缓存)。也可以手动安装:pip install fast-flights

CLI 用法

uvx --with fast-flights python3 scripts/flights-search <origin> <destination> <date> [options]

出发地和目的地支持 IATA 代码(JFK、LAX)或城市名称(NYC、伦敦、东京)。城市名称会自动搜索该都会区内的所有机场。

示例
# Search all NYC airports to LAX
flights-search NYC LAX 2026-03-15

# Nonstop flights from NYC to Berlin
flights-search NYC Berlin 2026-03-15 --nonstop

# Evening departures only
flights-search JFK LHR 2026-03-15 --after 17 --before 22

# Business class
flights-search NYC London 2026-03-15 --class business

# Multiple passengers with booking link
flights-search SF Tokyo 2026-04-01 --passengers 2 --link
选项
选项说明
--nonstop仅显示直飞航班
--all-stops显示所有航班,不限经停次数
--after HH只显示指定时刻之后出发的航班(24 小时制)
--before HH只显示指定时刻之前出发的航班(24 小时制)
--class舱位:经济舱、高级经济舱、商务舱、头等舱
--passengers N旅客人数(默认:1)
--link打印 Google Flights URL
支持的城市名称

使用城市名称时,CLI 会搜索该都会区内的所有机场:

城市机场
NYC / New YorkJFK、EWR、LGA
LA / Los AngelesLAX、BUR、LGB、ONT、SNA
SF / San FranciscoSFO、OAK、SJC
ChicagoORD、MDW
DC / WashingtonDCA、IAD、BWI
LondonLHR、LGW、STN、LTN、LCY
ParisCDG、ORY
TokyoNRT、HND
TorontoYYZ、YTZ

支持 60 多个都会区。对于列表中没有的机场,可直接使用任意 IATA 代码。

默认行为

默认情况下,CLI 仅显示可选经停次数最少的航班:

  • 如果有直飞航班 → 仅显示直飞航班
  • 如果没有直飞航班 → 仅显示经停 1 次的航班
  • 使用 --all-stops 查看所有航班

输出

Searching from NYC: JFK, EWR, LGA

Route        Depart                       Arrive                       Airline          Price       Duration
------------------------------------------------------------------------------------------------------------
EWR→LAX      6:00 AM on Sat, Mar 7        9:07 AM on Sat, Mar 7        United           $289        6 hr 7 min
EWR→LAX      12:00 PM on Sat, Mar 7       3:14 PM on Sat, Mar 7        United           $289        6 hr 14 min
JFK→LAX      8:00 AM on Sat, Mar 7        11:30 AM on Sat, Mar 7       Delta            $304        5 hr 30 min

3 flight(s) found.

说明

  • 日期格式:YYYY-MM-DD
  • 机场代码:标准 IATA 代码(JFK、LAX、LHR 等)
  • 价格以 USD 计价
  • 时间均为机场当地时区时间
  • 无需 API 密钥——通过逆向工程的 protobuf API 使用 Google Flights 数据
  • 由于上游解析限制,部分航线可能只返回价格(缺少出发/到达时间)

数据来源

通过 Python 程序包 fast-flights 使用 Google Flights 数据。

评论

支持 Markdown