flightclaw

从 Google Flights 跟踪航班价格。支持航线搜索、长期价格监控，并在价格下降时发送提醒。

安装

npx skills add jackculpan/flightclaw

或手动安装：

bash skills/flightclaw/setup.sh

脚本

搜索航班

查询指定航线与日期的航班信息。支持多机场组合及日期范围搜索。

python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --cabin BUSINESS
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --return-date 2025-07-08
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --stops NON_STOP --results 10
# 多个出发/到达机场（自动搜索所有组合）
python skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01
# 日期范围（逐日搜索）
python skills/flightclaw/scripts/search-flights.py LHR JFK 2025-07-01 --date-to 2025-07-05
# 同时使用多个机场和日期范围
python skills/flightclaw/scripts/search-flights.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03

参数说明：

• origin —— 出发机场 IATA 代码（可逗号分隔，例如 LHR 或 LHR,MAN）
• destination —— 到达机场 IATA 代码（可逗号分隔，例如 JFK 或 JFK,EWR）
• date —— 出发日期（格式：YYYY-MM-DD）
• --date-to —— 日期范围终点（格式：YYYY-MM-DD），将搜索从 date 至 --date-to（含）之间的每一天
• --return-date —— 往返行程的返程日期（格式：YYYY-MM-DD）
• --cabin —— 舱等：ECONOMY（默认）、PREMIUM_ECONOMY、BUSINESS、FIRST
• --stops —— 中转次数：ANY（默认）、NON_STOP、ONE_STOP、TWO_STOPS
• --results —— 返回结果数量（默认：5）

跟踪航班

将某条航线加入价格跟踪列表，并记录当前价格。支持多机场组合与日期范围（每种组合均创建独立的跟踪条目）。

python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01
python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --target-price 400
python skills/flightclaw/scripts/track-flight.py LHR JFK 2025-07-01 --return-date 2025-07-08 --cabin BUSINESS
# 同时跟踪多个机场和日期
python skills/flightclaw/scripts/track-flight.py LHR,MAN JFK,EWR 2025-07-01 --date-to 2025-07-03 --target-price 400

参数说明：

• 同 search-flights 所有参数，此外还包括：
• --target-price —— 当价格低于该值时触发提醒

检查价格

批量检查所有已跟踪航班的价格变动。适用于定时任务（如 cron）执行。

python skills/flightclaw/scripts/check-prices.py
python skills/flightclaw/scripts/check-prices.py --threshold 5

参数说明：

• --threshold —— 触发提醒所需的价格降幅百分比（默认：10）

输出内容：报告被跟踪航班的价格变化，高亮显示降价情况，并在达到目标价格时发出提醒。

列出已跟踪航班

显示所有正在跟踪的航班，包含当前价格与原始价格对比。

python skills/flightclaw/scripts/list-tracked.py

MCP Server

flightclaw 还可作为 MCP Server 运行，提供增强版搜索能力：

pip install flights "mcp[cli]"
claude mcp add flightclaw -- python3 server.py

MCP 工具列表：search_flights、search_dates、track_flight、check_prices、list_tracked、remove_tracked

额外支持的 MCP 过滤器：乘客类型（成人/儿童/婴儿）、航司筛选、价格上限、最大飞行时长、出发/到达时间限制、中转停留时长、排序方式，以及“最便宜日期”日历式搜索。

货币

价格以用户 IP 所在地对应的本地货币返回。货币类型由 Google Flights API 响应自动识别，并以正确符号显示（例如 $、£、฿、€）。已跟踪航班的货币代码保存在 tracked.json 文件中。

数据

价格历史记录存储于 skills/flightclaw/data/tracked.json，并通过 R2 备份实现持久化。