核心用法
FlyClaw 是一款基于多源聚合架构的航班信息查询工具,通过飞猪、Google Flights、Skiplagged、FlightRadar24 及 ADS-B 数据源实现票价、时刻、实时位置的一站式检索。用户无需注册账号或提供 API Key 即可使用全部功能,支持中英文城市名、IATA 代码及 7912 个机场的智能转换。
核心调用方式包括:
- 按航线搜索:
flyclaw.py search --from 上海 --to 纽约 --date 2026-04-01 - 按航班号查询:
flyclaw.py query --flight CA981 - 往返/多旅客/舱位筛选:支持
--return、--adults、-C business等参数 - 经停控制:
--stops 0直飞(默认)、--stops any含转机、--stops 1/2限中转次数
输出默认为 JSON 格式便于程序化解析,可通过 -o table 切换为可读表格;多日查询需自行并发执行后合并结果。
显著优点
1. 零门槛使用:无需账号、API Key 或浏览器自动化,规避了 Playwright/Selenium 的性能开销和检测风险
2. 多源互补:五数据源并发查询并智能合并,国内票价以飞猪为主(CNY 计价),国际航线综合 Google Flights 与 Skiplagged,实时动态依赖 FlightRadar24 与 ADS-B
3. 插件式扩展:每个数据源为独立模块,便于社区贡献新源或维护失效源
4. 本地化隐私:所有数据处理在本地完成,不收集、不存储用户个人信息
5. 输入灵活:城市级搜索自动扩展至多机场(如"上海"→PVG+SHA),支持别名匹配("浦东"→PVG)
潜在缺点与局限性
- 单日查询限制:search 命令单次仅返回指定日期结果,跨天比价需外部并发调度
- 数据源可靠性:依赖第三方公开接口,Google Flights 在部分地区不可用,飞猪价格可能因促销策略与实际支付价存在差异
- 舱位与税费差异:多源价格对比时需注意含税/不含税、舱位子类(如经济舱 Light/Standard)的不一致性
- 实时性边界:ADS-B 数据覆盖受地面接收站分布影响,部分空域位置更新延迟
- 法律合规风险:Skiplagged 的隐藏城市票务模式在部分航司条款中存在争议
适合人群
- 需要快速比价但不愿安装多个 App 的商务/休闲旅客
- 追求隐私、拒绝账号绑定的技术敏感用户
- 需要将航班数据集成至自动化工作流(如企业差旅系统、价格监控机器人)的开发者
- 学术研究或数据分析场景下的航班数据获取
常规风险
1. 服务可用性:公开 API 可能因源站策略调整而失效,需关注 GitHub issue 获取维护更新
2. 价格准确性:展示价格为抓取时点数据,实际预订时可能因舱位售罄或动态调价变化
3. 汇率波动:默认 7.25 CNY/USD 汇率可在 config.yaml 中调整,长期监控场景建议接入实时汇率 API
4. 合规使用:工具声明仅供学习研究,商业大规模调用可能触发源站反爬机制或违反服务条款