flyclaw

# FlyClaw - 航班信息聚合查询工具

基于多源聚合架构，通过开源库及免费公开 API 获取航班动态、价格、时刻、实时位置等信息。支持中英文城市名和 IATA 代码输入。

**GitHub**：[https://github.com/AI4MSE/FlyClaw](https://github.com/AI4MSE/FlyClaw)

**零 API Key 依赖**：无需注册任何账号或提供任何 API Key 即可使用全部核心功能。用户本地化掌控所有，程序不收集、不存储任何用户个人信息。同时规避浏览器模拟等复杂、不可靠和低效问题。

**触发方式**：用户说"查航班 CA981"、"上海飞纽约多少钱"、"PVG 到 JFK 明天的航班"、"往返机票 上海到新加坡"、"商务舱 北京到伦敦"、"所有航班包括转机"、"直飞" 等即可自动执行。 默认查询行为是直飞+经济舱。

**智能转换规则**：
- 用户说"所有航班"/"包括转机"/"包括非直飞" → `--stops any`
- 用户说"直飞"/"不要转机" → `--stops 0`（默认）
- 用户说"最多一次中转" → `--stops 1`
- 用户说"最多两次中转" → `--stops 2`

## 数据来源

- **Google Flights**：国内外国际航班价格、时刻
- **Skiplagged**：国内外国际航班价格、时刻
- **FlightRadar24**：航班动态、实时状态、延误、机型
- **Airplanes.live / ADSB.lol**：ADS-B 实时位置

多源并发查询，智能合并互补。**插件式架构，支持无限扩展**——每个数据源为独立模块。特别感谢以上公开数据源为公益和大众需求提供的便利！

## 功能

1. **按航班号查询**：查询指定航班的动态信息（状态、时刻、延误、机型等）
2. **按航线搜索**：查询两地之间的航班列表（含价格、经停、时长等）
3. **城市级搜索**：输入城市名自动搜索该城市所有机场（如"上海"→PVG+SHA）
4. **高级搜索**：往返搜索、多旅客配置、舱位选择、排序、直飞过滤
5. **中英文输入**：支持中文城市名、英文名、IATA 代码，7912 机场全覆盖

## 重要：输出格式与多日查询

**默认输出为 JSON**（stdout），直接 `json.loads()` 即可解析，示例：
```json
[{"flight_number": "CA981", "price": 472.0, "origin_iata": "PVG", "destination_iata": "GVA", ...}]
```
无结果时返回 `[]`。错误和日志仅输出到 stderr，不影响 JSON 解析。价格单位默认为**美元（USD）**。可用 `-o table` 切换为人类可读表格。

**多日查询**：search 命令每次只查一天。查询一周最低价等场景，需拆成多个日期**并发执行**，分别获取 JSON 结果后自行合并比较。

## 调用方式

### 按航班...

# FlyClaw - 航班信息聚合查询 CLI 工具

**FlyClaw** 是一个轻量级命令行工具，基于多源聚合架构，通过开源库及免费公开 API 获取数据，在终端中聚合查询航班信息（航班动态、价格、时刻等），原生支持中英文查询，原生OpenClaw技能，覆盖中国国内及国际航班。轻量化python实现，非浏览器模拟的复杂和低效方式。

**FlyClaw** is a lightweight command-line tool that aggregates flight information (dynamics, prices, schedules, etc.) using a multi-source aggregation architecture powered by open-source libraries and free public APIs, with native Chinese/English query support and native OpenClaw skill integration, covering both Chinese domestic and international flights. Lightweight Python implementation — no browser automation, no complexity, no overhead.

核心价值：单一来源不稳定、不完整、覆盖有限 -- FlyClaw 的目标是**聚合、去重、补齐、呈现**。

Core value: A single data source is unreliable, incomplete, and limited in coverage -- FlyClaw's value lies in **aggregation, deduplication, gap-filling, and presentation**.

[English Readme](README_EN.md)

**作者**：nuaa02@gmail.com 小红书@深度连接
**GitHub**：[https://github.com/AI4MSE/FlyClaw](https://github.com/AI4MSE/FlyClaw)
**许可证**：[Apache-2.0](LICENSE)

## 功能特性

- **零 API Key 依赖**：无需注册账号，开箱即用，安全，同时规避浏览器模拟等复杂、不可靠和低速问题
- **多数据源聚合**：FR24、Google Flights、Skiplagged、Airplanes.live 四大数据源并发查询，通过开源库及免费公开 API 获取航班动态、价格、实时位置。**插件式架构，支持无限扩展**——每个数据源为独立模块（`sources/` 目录下一个文件）。特别感谢以上公开数据源为公益和大众需求提供的便利！
- **多源价格互补**：Google Flights + Skiplagged 并发查询，支持往返搜索、多旅客、舱位选择、经停控制
- **城市级智能搜索**：中英文城市名 / IATA 代码混合输入，自动展开至所有机场（"上海"→PVG+SHA），自动过滤已关闭/货运专用机场
- **7000+ 个机场缓存**：覆盖全球 99% 有 IATA 代码的机场，含中英文名称及别名（AI 翻译，如有错误欢迎纠正）
- **智能重试 & 快速返回**：瞬态错误自动重试，有结果后提前返回不等慢源
- **共享代码去重**：...