SerpApi Flights (Google Flights)

该技能提供实时航班信息查询能力，底层对接SerpApi的Google Flights数据接口，可获取航空公司、航班号、起降时间、飞行时长、价格、机型及延误预警等完整信息。核心优势在于支持中英文混合输入（如HKG或"香港"），覆盖国内主要城市及港澳台航线；舱位筛选灵活（经济舱至头等舱1-4级），支持单程/往返查询，输出包含⚠️延误风险提示的历史数据分析。免费额度100次/月对轻度使用足够，但存在明显局限：价格来源于Google Flights而非航司直营渠道，可能存在差价；无法显示实时座位余量；部分航班显示"待查"无定价。安全性依赖用户自管的SERPAPI_KEY，工具本身仅做数据中转无额外风险，适合需要快速比价、规划行程的个人用户及差旅管理人员。

核心用法

SerpApi Flights 是一款专为用户设计的航班信息查询工具，通过调用 SerpApi 提供的 Google Flights 数据接口，实现实时航班搜索与比价功能。用户可通过简单的命令行指令，查询指定日期、航线、舱位等级的航班信息，获取航空公司、航班号、起降时间、飞行时长、价格、机型等完整数据。

该技能支持多种查询模式：单程/往返、经济舱/商务舱/头等舱、直飞/中转、多币种报价等。输入方式灵活，既支持标准 IATA 机场代码（如 HKG、PVG），也支持中文城市名称（如香港、上海），覆盖了国内主要城市的 30 余个航点。

显著优点

数据权威实时：直接对接 Google Flights 数据源，价格与时刻信息更新及时，可作为出行决策的可靠参考。

使用门槛低：命令行参数设计直观，支持自然语言风格的中文城市输入，无需记忆复杂代码。

输出信息丰富：除基础价格时刻外，还提供机型信息、历史延误概率标记（⚠️），辅助用户评估航班可靠性。

轻量无依赖：仅依赖 Node.js 内置模块，零第三方包，部署简单，启动迅速。

隐私处理规范：API 密钥通过环境变量管理，无硬编码风险，符合安全最佳实践。

潜在缺点与局限性

数据来源限制：价格来自 Google Flights，可能与航空公司官网或 OTA 平台存在差异；不显示余票数量，无法判断座位紧张程度。

服务商依赖：需注册 SerpApi 账号并获取 API 密钥，免费额度有限（100 次/月），高频使用需付费升级。

网络稳定性：查询依赖外部 API 服务，网络波动或 SerpApi 服务异常时可能无法获取结果。

功能边界：不支持直接预订、选座、值机等操作，仅作为信息查询工具；历史延误标记基于统计数据，不代表实际航班表现。

输入校验待完善：当前对日期格式、城市名称拼写的容错性有限，错误输入可能导致查询失败。

适合的目标群体

• 商务差旅人士：需要快速比价、筛选直飞或特定舱位的出行方案。
• 自由行旅客：规划行程阶段，需要对比多日期、多航线的价格趋势。
• 差旅管理人员：批量查询团队出行选项，辅助制定差旅政策。
• 开发者与自动化场景：需要将航班查询集成到脚本或工作流中的技术用户。

使用风险提示

API 配额管理：免费账户每月 100 次查询额度，建议在脚本中增加缓存机制或错误重试逻辑，避免额度耗尽影响使用。

密钥安全：SERPAPI_KEY 需妥善保管，避免提交到代码仓库或暴露在日志中，建议在 CI/CD 流程中使用密钥管理服务。

价格时效性：航空票价变动频繁，查询结果仅供参考，实际预订请以航空公司或售票平台为准。

数据完整性：部分航班可能显示"待查"价格，或 Google Flights 未覆盖的廉航航线，需多渠道交叉验证。