Fli

3周前更新 38 00

Fli 是一个专门给 AI 准备的航班查询 MCP 工具,最大价值是**把机票搜索封装成 AI 可调用工具**,适合让 Claude 自动帮你查航班、比价、挑便宜日期;但它受 Google 页面侧接口限制,功能不完整,不能做多城市联程,也不能直接下单,仅做查询比价。

所在地:
punitarani
收录时间:
2026-10-28

Fli 是一款强大的 Python 库及 MCP(Model Context Protocol)服务器,为开发者和 AI 代理提供对 Google Flights 数据的编程式访问。与依赖脆弱网页抓取(Web Scraping)的传统工具不同,Fli 通过逆向工程直接与 Google Flights 的底层 API 交互,实现了更快速、更可靠且高度模块化的航班搜索体验。

Fli

核心优势:零抓取与纯 API 交互

Fli 的设计哲学摒弃了传统的 HTML 解析和浏览器自动化,转而采用直接的 API 通信。这种架构带来了显著优势:

  • 极速响应:直接 API 访问消除了渲染 DOM 的开销,结果返回更快。
  • 高可靠性:不依赖易变的网页 UI 结构,大幅降低了因前端改版导致工具失效的风险。
  • 内置鲁棒性:原生支持速率限制、自动重试、全面的错误处理与严格的输入验证。

MCP 集成:赋能 AI 代理的智能行程规划

Fli 原生支持 MCP 协议,可轻松作为工具集成到 Claude Desktop、Codex 或其他支持 MCP 的 AI 代理中。它提供两种运行模式:STDIO(本地进程)和 HTTP(可流式传输,默认 http://127.0.0.1:8000/mcp/)。

MCP 服务器暴露了两个核心工具:

  1. search_flights:针对特定日期进行深度航班搜索,支持多达 18 种精细化筛选条件(如舱位、联盟、中转时间窗口、多机场代码等)。
  2. search_dates:在灵活的时间范围内(最多 93 天)扫描并找出最便宜的旅行日期,非常适合行程未定的用户。

高级搜索能力与参数控制

Fli 提供了媲美甚至超越官方网页版的筛选粒度:

  • 多维度筛选:支持按航空公司(包含/排除)、航空联盟(如 ONEWORLD, STAR_ALLIANCE)、舱位(经济舱至头等舱)、最大/最小中转停留时间进行过滤。
  • 智能排序:支持按价格(CHEAPEST)、总时长、出发时间或到达时间对结果进行排序。
  • 复杂乘客配置:支持成人、儿童(2-11岁)、占座婴儿及膝上婴儿的混合计算(总人数 1-9 人,且膝上婴儿数不得超过成人乘客数)。
  • 往返程扩展:通过 top_n 参数,可自动将前 N 个最佳出发航班与返程航班进行组合匹配,寻找最优往返方案。

技术边界与已知限制(重要)

由于 Google Flights 后端架构的复杂性及 2026 年 8 月后的 API 变更(如 GetShoppingResults 需要特定的 x-goog-batchexecute-bgr 请求头),Fli 采用了读取页面内联 AF_initDataCallback (键为 ds:1) 的替代方案。这带来了一些必须了解的技术边界:

  1. 部分筛选器不支持:emissions(碳排放)、bags(行李)和 exclude_basic_economy(排除基础经济舱)无法从解码数据中重建,会被静默丢弃并给出警告。
  2. 不支持多城市搜索:Google 通过受门控的 RPC 在客户端动态加载多城市结果,Fli 会抛出 SearchUnsupportedError,建议分段搜索。
  3. 儿童/婴儿可能导致结果锐减:由于 Google 在客户端为特殊乘客群体动态定价,包含儿童或婴儿的搜索返回的行程数量可能显著减少(甚至在高级舱位中为零)。这并非 Fli 的缺陷,而是上游数据源的机制。
  4. 日期搜索的资源消耗:search_dates 需逐日抓取页面。扫描 93 天范围可能产生数百次 HTTP 请求。Fli 内置了智能断路器,若连续多次页面加载失败(如被阻止或触发同意门控),将提前终止扫描以节省资源。
  5. 企业网络与区域限制:欧盟/欧洲经济区 (EU/EEA) IP 会触发 Google 同意页面。Fli 默认发送预先接受的 SOCS Cookie,可通过 FLI_SOCS_COOKIE 环境变量自定义。若处于 TLS 拦截的企业代理后,需通过 FLI_CA_BUNDLE 等环境变量指定 PEM CA 证书路径。

快速开始与部署

Fli 的安装与使用极其简便,推荐使用 pipx 以确保环境隔离:

# 安装 Fli
pipx install flights

# 启动 MCP 服务器 (STDIO 模式,适用于 Claude Desktop 等)
fli-mcp

# 或在 HTTP 模式下运行
fli-mcp-http

Claude Desktop 配置示例:

{
  "mcpServers": {
    "fli": {
      "command": "/Users/<user>/.local/bin/fli-mcp"
    }
  }
}

(注:可通过 which fli-mcp 获取实际路径)

相关导航