航班搜索

搜索航班、跨航司比价，并监控机票价格下跌。支持灵活日期查询、价格提醒及航班状态追踪。

⚠️ 必需凭证

本技能需配置 API 凭证方可运行：

必需（Amadeus）：

• AMADEUS_API_KEY — 从 developers.amadeus.com 获取
• AMADEUS_API_SECRET — 创建应用时提供

免费套餐：每月 2,000 次搜索（沙盒环境），或含真实票价的生产环境免费套餐

可选（AviationStack）：

• AVIATIONSTACK_API_KEY — 从 aviationstack.com 获取

免费套餐：每月 100 次请求（极为有限，仅适用于航班状态查询）

配置

安装完成后，将 config.example.json 复制为 config.json，并填入您的凭证：

{
  "apis": {
    "amadeus": {
      "api_key": "YOUR_AMADEUS_API_KEY",
      "api_secret": "YOUR_AMADEUS_API_SECRET",
      "sandbox_mode": true
    },
    "aviationstack": {
      "enabled": false,
      "api_key": "YOUR_AVIATIONSTACK_API_KEY"
    }
  }
}

🔒 安全说明：

• config.json 默认已加入 .gitignore
• 切勿将 API 密钥提交至版本控制系统
• 建议使用环境变量或安全的配置文件管理密钥
• 若密钥意外泄露，请及时轮换

功能说明

通过 Amadeus API 搜索航班、比价、筛选最优航线，并可长期监控价格变化，在降价时向您发出提醒。可选集成 AviationStack 实现航班实时状态查询。

前提条件

1. 获取 API 密钥：

   • Amadeus（必需）：developers.amadeus.com
     • 测试/沙盒环境（免费）：每月 2,000 次航班搜索 — ⚠️ 仅限测试数据
     • 生产环境（免费 + 按量付费）：含免费配额，超出后仅对额外调用付费 — ✅ 真实票价
     • 注册账号并创建应用
     • 获取 API Key 和 API Secret

   ✅ 好消息：

   • 两个环境均提供免费套餐！
   • 测试环境：每月 2,000 次请求（免费，测试数据）
   • 生产环境：含免费配额 + 按量付费（真实数据）
   • 生产环境在免费配额内即可获取真实票价
   • 额外福利：如后续产生预订行为，搜索调用费用可享 90% 折扣！

   ⚠️ 关键须知：

   • 沙盒环境 = 测试数据（票价非真实）

   • 生产环境 = 真实数据（实际票价与余票情况）

   • 生产环境并非每月 €30 — 它同样提供免费套餐！

   • 仅当超出免费配额时才需付费

   • AviationStack（可选）：aviationstack.com

     • 免费套餐：每月 100 次请求 ⚠️ 极为有限
     • 仅用于航班状态追踪
     • 如需生产环境稳定使用，建议升级至付费方案（$49.99+）

2. 配置技能：在 config.json 中填入您的 API 密钥：

   {
     "apis": {
       "amadeus": {
         "api_key": "YOUR_KEY",
         "api_secret": "YOUR_SECRET",
         "sandbox_mode": true  // 设为 false 启用生产环境（真实票价，且同样享有免费套餐！）
       }
     }
   }
   

建议：

• 先使用 沙盒环境（免费）验证技能功能
• 再切换至 生产环境（同样有免费套餐！）获取 真实票价
• 仅当超出免费配额时才需付费（按量付费）

建议：初始仅启用 Amadeus；仅当确有航班状态追踪需求且预算允许升级付费方案时，再启用 AviationStack。

使用方法

基础搜索

"搜索从 JFK 到 LHR 的航班"
"查找 3 月从圣保罗到里斯本的航班"
"12 月飞往泰国要多少钱？"

指定日期

"JFK 到 LAX 的航班，12 月 15 日至次年 1 月 10 日"
"GRU 到 MIA 的航班，3 月 1 日至 3 月 15 日"
"搜索 1 月出发前往巴黎的机票"

灵活日期

"飞往欧洲最便宜的时间是？"
"未来 3 个月飞往泰国的最佳票价"
"什么时候去巴黎最便宜？"

价格监控

"监控 JFK 到 LHR 的票价"
"航班飞往罗马降价时提醒我"
"为巴黎设置价格提醒"

航班状态（能力受限）

"查询航班 AA123 的状态"
"航班 LA1234 是否准点？"
"追踪航班 G3 4567"

注意：航班状态功能依赖 AviationStack API。其免费套餐极度受限（每月仅 100 次请求）。建议：

• 仅对重要航班谨慎使用
• 如需常规使用，请升级至付费方案（$49.99+/月）
• 替代方案：使用航司官方 App 或网站

航司比价

"比价飞往亚洲的各航司航班"
"哪家航司最便宜？"
"前往泰国的最佳航线"

功能特性

• ✅ 通过 Amadeus API 进行航班搜索
• ✅ 跨航司票价对比
• ✅ 灵活日期搜索
• ✅ 价格监控与提醒
• ✅ 多城市联程路线
• ✅ 按经停次数、航司、航程时长筛选
• ✅ 货币自动换算
• ✅ 航班状态追踪（AviationStack）
• ✅ 支持全球国际机场

API 信息概览

建议：初始仅启用 Amadeus；仅当航班状态追踪对您的使用场景至关重要，且您愿意升级至付费方案时，再启用 AviationStack。

使用技巧

• 使用机场三字码（如 JFK、LHR、BKK）提升查询准确性
• 指定灵活日期以获取最优票价
• 为中长期行程规划设置价格监控
• 周二至周四预订通常价格更低
• 国际航班建议提前 2–3 个月预订
• 出发前请核查航班状态

示例

参见 examples/ 目录中的示例：

• 基础搜索
• 多城市行程
• 价格监控配置
• 高级筛选
• 航线优化
• 航班状态追踪

故障排查

“未找到航班”

• 确认机场代码是否正确（请使用 IATA 三字码）
• 尝试扩大日期范围
• 检查 API 密钥配置是否正确
• 确认 API 配额未耗尽

“API 错误”

• 确认 API 密钥有效
• 检查 API 调用频率限制
• 确保配置中已启用对应 API
• 检查网络连接状态

“票价显示异常”

• 票价实时更新频繁
• 尝试刷新搜索结果
• 沙盒模式下返回的是测试数据
• 检查货币设置是否正确

“无法获取航班状态”

• 在配置中启用 AviationStack
• 确认航班号格式正确（例如 AA123）
• 核实该航班在指定日期是否存在
• 尝试不带日期查询当前实时状态

API 调用频率限制

重要说明：

• Amadeus 沙盒模式提供适用于开发测试的模拟数据。如需在生产环境中使用真实票价，请升级至生产环境 API。
• AviationStack 免费套餐极为有限（每月仅 100 次请求）。如需生产环境稳定使用，建议考虑以下付费方案：
  • 基础方案：$49.99/月（含 5,000 次请求）
  • 专业方案：$149.99/月（含 50,000 次请求）
  • 企业方案：定制报价
• 替代方案：如需航班状态功能，可考虑使用 Amadeus 提供的有限航班状态接口，或直接对接航司专属 API。

贡献指南

欢迎参与贡献！请按以下步骤操作：

1. Fork 本仓库
2. 新建功能分支
3. 完成修改
4. 提交 Pull Request

许可证

MIT 许可证 — 详见 LICENSE 文件。

致谢

• Amadeus for Developers：developers.amadeus.com
• AviationStack：aviationstack.com