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

核心优势:零抓取与纯 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 服务器暴露了两个核心工具:
search_flights:针对特定日期进行深度航班搜索,支持多达 18 种精细化筛选条件(如舱位、联盟、中转时间窗口、多机场代码等)。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) 的替代方案。这带来了一些必须了解的技术边界:
- 部分筛选器不支持:
emissions(碳排放)、bags(行李)和exclude_basic_economy(排除基础经济舱)无法从解码数据中重建,会被静默丢弃并给出警告。 - 不支持多城市搜索:Google 通过受门控的 RPC 在客户端动态加载多城市结果,Fli 会抛出
SearchUnsupportedError,建议分段搜索。 - 儿童/婴儿可能导致结果锐减:由于 Google 在客户端为特殊乘客群体动态定价,包含儿童或婴儿的搜索返回的行程数量可能显著减少(甚至在高级舱位中为零)。这并非 Fli 的缺陷,而是上游数据源的机制。
- 日期搜索的资源消耗:
search_dates需逐日抓取页面。扫描 93 天范围可能产生数百次 HTTP 请求。Fli 内置了智能断路器,若连续多次页面加载失败(如被阻止或触发同意门控),将提前终止扫描以节省资源。 - 企业网络与区域限制:欧盟/欧洲经济区 (EU/EEA) IP 会触发 Google 同意页面。Fli 默认发送预先接受的
SOCSCookie,可通过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 获取实际路径)
相关导航


Disco

xiaohongshu-mcp

Supabase MCP Server

AgentLine

Office-PowerPoint-MCP-Server

n8n-MCP






