Flight Search

核心用法

flight-search 是一个命令行工具 Skill，基于 Python 的 fast-flights 库封装，通过 uvx 直接运行而无需本地安装。用户只需提供出发地、目的地、日期等基础参数，即可获取 Google Flights 的实时航班数据，支持单程/往返、多舱位、多乘客配置，并可输出 JSON 格式便于二次开发。

显著优点

• 零配置即用：依赖 uvx 直接执行，无需 API 密钥、无需账号、无需复杂配置，大幅降低使用门槛
• 信息全面：返回价格、起飞/到达时间、航司、是否直飞、飞行时长等关键字段，并标注"最佳"推荐
• 灵活输出：支持 text 和 json 两种格式，后者便于集成到自动化脚本或数据分析流程
• 舱位覆盖全：从经济舱到头等舱均可查询，满足商务和休闲出行需求

潜在局限

• 依赖外部工具：需先安装 uv 以获得 uvx 命令，对未配置 Python 环境的用户有前置成本
• 网络依赖：实时抓取 Google Flights 数据，受网络状况和反爬机制影响，稳定性不如官方 API
• 功能边界：仅支持查询，不可直接预订；不支持多城市联程、里程票查询等高级功能
• 数据准确性：价格等信息来自第三方抓取，可能存在延迟或与实际购票页面不一致的情况

适合人群

• 需要快速比价的个人出行者
• 希望将航班查询集成到脚本的开发者
• 对 API 配置感到繁琐、追求极简体验的用户

常规风险

• 该 Skill 本身为纯 Markdown 文档（T-MD 分类），无可执行代码，安全性由底层 flight-search 包和 uvx 工具链保障
• 建议通过官方 PyPI 渠道安装 flight-search，避免使用来路不明的镜像源
• 频繁查询可能触发 Google 的反爬策略，建议控制调用频率

核心用法

flight-search 是一款命令行航班查询工具，无需 API Key 即可调用 Google Flights 数据。使用时指定出发地、目的地 IATA 三字码及出发日期，支持可选返程日期、乘客人数、舱位等级和输出格式。

基础语法：

uvx flight-search <ORIGIN> <DEST> --date YYYY-MM-DD

典型场景：

• 单程速查：flight-search DEN LAX --date 2025-03-01
• 往返规划：flight-search JFK LHR --date 2025-06-15 --return 2025-06-22 --adults 2
• 自动化集成：--output json 输出结构化数据供脚本解析

显著优点

1. 零门槛接入：无需注册 Google Flights API，开箱即用
2. 信息完整：返回价格、航司、起降时间、飞行时长、经停次数、"最优推荐"标记
3. 舱位全覆盖：经济舱至头等舱均可查询
4. 灵活输出：文本格式友好可读，JSON 格式便于程序处理
5. 轻量部署：基于 uvx 一键运行，无需全局安装

潜在缺点与局限性

1. 数据来源依赖：基于 fast-flights 非官方爬虫方案，Google Flights 页面结构变更可能导致失效
2. 无实时预订：仅查询比价，无法直接完成购票
3. 地区限制：Google Flights 覆盖范围受 Google 服务区域限制
4. T3 来源风险：个人开发者维护，长期维护稳定性存疑
5. 无缓存机制：重复查询可能触发反爬限制

适合人群

• 开发者构建自动化行程规划工具
• 需要批量比价的企业差旅管理员
• 偏好终端工作流的技术用户
• 快速验证航线价格的临时查询需求

常规风险

• 数据准确性：航班动态调整频繁，查询结果与实际可订状态存在时间差
• 反爬限制：高频查询可能导致 IP 临时受限
• 依赖链安全：实际功能依赖 PyPI 包 flight-search，建议定期检查更新
• 隐私注意：查询数据通过 Google 服务处理，虽无用户身份关联，但仍需注意行程信息暴露