Google Flights Search

核心用法

google-flights-search 是一个完整的航班搜索自动化工具链，通过 SearchAPI.io 实时抓取 Google Flights 数据。核心工作流为：搜索 → 评分排序 → 保存监控。

搜索阶段：使用 search_searchapi.py 脚本，支持单程/往返、日期灵活度（±3天）、直飞/中转筛选、舱位等级等参数。往返搜索必须搭配 --top 5 参数，才能获取返程航班详情。目的地支持机场代码（如 LHR）和城市聚合代码（如 LON 代表伦敦所有机场）。

评分阶段：通过 flight-scoring 技能对结果进行多维度打分——价格权重50分、直飞权重30分、便利性（起降时间、过夜航班等）权重20分，生成综合排名并自动标注标签（如"最便宜"、"直飞"、"红眼航班"）。

监控阶段：强制要求使用 flight-price-monitor 保存搜索，系统每2小时自动巡检价格波动并推送给用户。

显著优点

• 实时数据源：直连 Google Flights，价格与官网同步
• 智能评分体系：避免用户陷入纯比价陷阱，综合考量时间成本
• 自动化监控：一次搜索，持续跟踪，降价即通知
• 无依赖部署：仅依赖 Python 标准库，零 pip 安装
• 完整工作流：从搜索到预订链接（booking_token 解析真实航司/OTA URL）一气呵成

潜在局限

• API 依赖：需 SearchAPI.io 密钥，存在用量限制与成本
• 数据覆盖：El Al 等航司安息日无航班，次级机场（如 Wizz 的 LTN）需额外说明
• 评分主观性：便利性权重固定，未考虑个人偏好（如商务旅客 vs 背包客）
• 监控粒度：每2小时巡检，极端闪购可能错过

适合人群

• 弹性日期、追求性价比的休闲旅客
• 需要批量比价的差旅管理员
• 希望"设置后忘记"的价格敏感型用户

常规风险

• 价格波动：抓取价格可能与最终预订价存在差异（税费、行李额未锁定）
• 链接时效：booking_token 可能过期，需准备 vendor-booking-link 兜底
• 隐私合规：用户手机号/ID 用于监控推送，需确保符合 GDPR/本地法规

核心用法

本Skill通过SearchAPI.io接入Google Flights实时数据，支持单程/往返航班搜索、价格查询与预订链接获取。用户需提供起点/终点IATA代码、出行日期等参数，系统将返回结构化航班信息（含航司、起降时间、中转、价格等）。完整工作流要求：先搜索→再通过flight-scoring评分排序→最后经flight-price-monitor保存监控。往返搜索务必添加--top 5参数以获取返程详情，支持多币种、舱位等级、直飞筛选等高级选项。

显著优点

1. 零依赖轻量化：仅使用Python标准库（urllib/json/argparse），无第三方包安装负担，部署极简易。
2. 数据实时权威：直接对接Google Flights数据层，价格、时刻表与官方保持一致，避免缓存滞后。
3. 智能工作流整合：内置评分机制（价格50分+直飞30分+便利性20分）与自动价格追踪，实现"搜索-决策-监控"闭环。
4. 灵活查询策略：支持日期浮动（±3天）、城市级代码（如LON含多机场）、多乘客、舱位分级等复杂场景。
5. 安全凭证管理：API密钥强制从环境变量读取，无硬编码风险，符合安全最佳实践。

潜在缺点与局限性

1. 外部API依赖：完全依赖SearchAPI.io服务可用性与配额，网络中断或API限流将直接导致功能失效；且可能产生API调用费用。
2. 功能耦合度高：必须与flight-scoring和flight-price-monitor配合使用，单独使用价值受限，增加系统复杂度。
3. 数据范围限制：El Al等航司安息日停飞信息需人工备注，次级机场（如LTN/STN）返回结果需额外向用户说明。
4. 日志积累风险：默认持久化搜索日志，长期运行可能产生隐私数据堆积，需手动清理。
5. 输入校验基础：IATA代码、日期格式等依赖用户正确输入，缺乏强校验机制，错误参数易导致查询失败。

适合的目标群体

• 差旅频繁人士：需要快速比价、锁定低价并持续监控价格波动的商务或休闲旅客。
• 旅行代理/运营人员：为客户提供实时航班方案，需结构化数据支持批量处理与自动化报表。
• 开发者/技术用户：希望集成航班搜索能力至自建Agent或工作流，且偏好无依赖的轻量实现。

使用风险说明

• 性能风险：API响应延迟或超时未实现自动重试，高并发场景可能触发达限流。
• 成本风险：SearchAPI.io为商业服务，高频调用或大量日期扫描可能产生费用，需关注配额使用。
• 隐私风险：搜索历史持久化存储于本地日志，多用户共享环境需注意数据隔离与定期清理。
• 合规风险：航班数据来自Google Flights，需遵守SearchAPI.io服务条款；价格信息仅供参考，实际预订以航司/OTA为准。