Flights

核心功能

该技能基于Python CLI工具flights-search，调用fast-flights库抓取Google Flights实时数据，提供无需API密钥的航班搜索服务。支持IATA机场代码或城市名（如NYC、London、Tokyo）作为起终点，自动扩展搜索该都会区的全部机场。核心功能包括：

• 智能过滤：默认展示最少经停航班（直飞优先），支持--nonstop强制直飞、--after/--before时段过滤、--class舱位选择（经济/高端经济/商务/头等）
• 灵活查询：支持多乘客数量设定（--passengers）、生成Google Flights预订链接（--link）
• 都会区覆盖：内置60+城市多机场映射，涵盖主要国际枢纽

显著优点

1. 零配置门槛：无需申请Google API密钥，开箱即用
2. 城市级搜索：输入"NYC"即可同时搜索JFK/EWR/LGA，避免手动比价
3. 轻量高效：基于uvx即时运行，无需持久化安装依赖
4. 实时数据：直接对接Google Flights，价格时效性接近官网

潜在局限

• 稳定性风险：依赖非官方逆向工程接口（protobuf API），Google随时可能更改协议导致失效
• 数据不完整：部分航线可能仅返回价格而无起降时间，源于上游解析限制
• 地域限制：价格默认USD，时区处理为机场本地时间，跨国查询需注意换算
• 无预订能力：仅提供搜索和链接跳转，实际订票需跳转第三方

适合人群

• 频繁出差/旅行需快速比价的个人用户
• 需要批量查询航班数据的开发者或自动化场景
• 对API申请流程敏感、追求即时可用性的轻量用户

常规风险提示

| 风险类型 | 说明 |

|---------|------|

| 服务中断 | 非官方接口可能被限制或封禁 |

| 数据准确性 | 价格可能存在延迟，建议以航司官网为准 |

| 隐私合规 | 查询数据经Google Flights处理，需遵守其服务条款 |

核心用法

flights 是一个纯文档型 Skill，通过调用 fast-flights Python 包实现 Google Flights 数据查询。用户通过 CLI 命令 flights-search <origin> <destination> <date> 执行搜索，支持以下核心功能：

• 智能机场解析：输入城市名（如 NYC、London、Tokyo）自动搜索该都市区全部机场，覆盖 60+ 都市区
• 灵活过滤：支持仅直飞（--nonstop）、时段筛选（--after/--before）、舱位等级（--class）、乘客数量（--passengers）
• 默认最优策略：自动仅显示最少经停航班，优先推荐直飞
• 输出格式：清晰的表格化展示，含起降时间、航司、价格、时长

显著优点

1. 零配置开箱即用：无需 API Key，依赖 Astral 的 uv 工具实现自动依赖管理
2. 城市级搜索体验：突破传统 IATA 代码限制，NYC 一次搜索覆盖 JFK/EWR/LGA 三大机场
3. 数据时效性：直接对接 Google Flights，价格与时刻相对实时

潜在缺点与局限性

| 问题 | 说明 |

|------|------|

| **非官方 API 风险** | fast-flights 基于逆向工程，Google 可能随时封禁或更改接口 |

| **数据不完整** | 部分航线仅返回价格，缺失具体起降时刻 |

| **个人维护依赖** | fast-flights 为个人开发者项目，长期维护存疑 |

| **管道安装风险** | 推荐的 `curl \| sh` 安装方式存在供应链攻击面 |

适合人群

• 需要快速查询国际/国内航班比价的技术用户
• 熟悉 CLI 操作、愿意承担非官方 API 风险的旅行者
• 不需要企业级 SLA 保障的个人或小团队

常规风险

• 供应链安全：fast-flights 包若被恶意篡改，可能影响搜索结果准确性甚至引入恶意代码
• 隐私合规：Skill 本身无数据收集，但实际搜索时 Google Flights 可能记录查询行为
• 功能失效风险：上游 API 变更可能导致 Skill 突然无法使用，需关注 GitHub 仓库更新