Fli 實測:讓 Claude 直查 Google Flights 機票,台灣出發先修地雷

Fli 是把 Google Flights 查詢接進 Claude 與腳本的開源工具,本篇實測台灣出發航線可用、台幣計價與日期比價全通,同時拆解全新安裝會撞到的兩顆相依性地雷與可用配方,並揭露已發佈版只有三個 MCP 工具、那霸轉機行程靜默消失等文件落差。

用 AI 摘要這篇文章:

想讓 Claude 或自己的腳本直接查 Google Flights,開源專案 Fli 是目前最省事的一條路:一個 MIT 授權的 Python 套件,同時提供命令列工具、Python 函式庫與 MCP 伺服器三種形態。我在 2026 年 11 月 19 日於 macOS 上從乾淨的虛擬環境裝起、逐一實測,結論先講:查詢本身真的可用,從桃園出發的航線、台幣計價、日期比價全部跑得通;但照官方文件的一行指令全新安裝,命令列會直接崩潰,而且要連修兩顆相依性地雷才會完整可用。這篇文章會把崩潰現場、修法配方,以及實測中挖到的三個官方文件沒寫清楚的落差,一次交代完。

照官方指令裝下去,命令列先崩給你看

Fli 在 PyPI 上的套件名叫做 flights,不是 fli,這是第一個容易踩的坑:pip install flights 裝完後,執行檔叫 fli,Python 裡 import 的模組也叫 fli。我在乾淨的 Python 3.11 虛擬環境照官方 README 執行安裝,接著跑 fli --version,版本號沒等到,等到的是一整串追溯資訊,最後一行寫著 ModuleNotFoundError: No module named 'click'。

這不是我的環境問題,而是相依性設計留下來的時間炸彈。flights 0.9.0 的命令列程式直接引用 click 這個套件,但它自己的相依清單只寫了 typer>=0.15.1,長期以來都靠 typer 間接把 click 一起帶進來。2026 年 11 月 6 日出版的 typer 0.28.0 把 click 從執行期相依中移除,之後任何全新安裝都不會再有 click,於是 CLI 當場崩潰。修法很簡單,手動補裝:

pip install flights click

補完之後 CLI 立刻復活。但先別高興,第二顆地雷在日期比價功能上等著:執行 fli dates 一旦真的查到結果,會再撞一次 module 'plotext' has no attribute 'clear_figure'。原因同款:flights 宣告 plotext>=5.3.2 沒設上限,而 plotext 6.0.0 從 2026 年 8 月 23 日起移除了舊的繪圖介面。所以今天想完整使用,配方是:

pip install flights click "plotext<6"

兩顆地雷都修好之後,查詢功能一路順暢。比較值得注意的是官方的修復進度:click 的問題在 GitHub 主分支上已經修好(主分支程式碼不再引用 click),plotext 那顆則連主分支都還沒修,只是開發環境的鎖定檔碰巧把版本壓在 5.3.2,所以 plotext<6 這個防護不管你裝 PyPI 還是裝 git 最新版都要帶著。PyPI 上的版本停在 2026 年 5 月 21 日的 0.9.0,半年沒有發新版;從版本史看,這個專案的發版節奏不固定,短則數天、長則三個月,2025 年 9 月的 0.6.0 到 0.9.0 之間就是一路走走停停。同一時間主分支持續在修:九月下旬修日期掃描的錯誤回報、加上 TLS 憑證支援與來回票參數,十一月中加入探索功能,全部只在 git 裡。也就是說,README 上看到的內容與你實際裝到的內容,中間隔了六個月的開發落差,這個落差後面還會再出現兩次。

修好之後,從桃園出發真的查得到 154 個選項

先確認機場資料庫:fli airports taipei 列出 TPE 桃園國際機場與 TSA 松山機場,離線就能查。接著實際查詢 2026 年 12 月 18 日桃園飛東京羽田的單程經濟艙,一次回來 109 個選項,最便宜的是樂桃 MM860,晚間 20:55 起飛、直飛 2 小時 55 分,184 美元。同一天改查桃園飛大阪關西,回來 154 個選項,149 美元起跳。篩選條件相當齊全:艙等(經濟、豪經、商務、頭等)、直飛或轉機次數、指定或排除特定航空公司、航空聯盟、轉機時間上下限、起飛時段、乘客人數組合,還有幣別、語言與國家設定,查價可以直接指定台幣。

Fli 命令列工具的航班查詢輸出畫面,終端機以表格列出航班選項與價格Pin
Fli 命令列的航班查詢輸出(圖片來源:Fli GitHub README)

日期比價是另一個實用工具。fli dates TPE KIX 指定 12 月 14 日到 20 日,輸出一份七天價格日曆加文字趨勢圖,我查到的結果是 12 月 20 日星期日最便宜(108 美元),15 到 17 日是低檔(116 美元),18 日星期五最貴(149 美元)。週末出發與平日出發的價差,一張表直接看出來。這個指令在 0.9.0 背後走的是 Google 的日曆圖資料端點,一次拿一個月曆、超過 61 天自動分段;官方文件提醒日期掃描範圍越大、抓的頁面越多,一個大範圍的全掃描尖峰時會吃掉數百 MB 記憶體。

多城市行程也實測通過:fli multi 帶兩段行程(桃園飛羽田 12 月 18 日、羽田飛桃園 12 月 25 日),回來 10 個選項,第一個兩段直飛總價 17,715 元台幣。這點請記住,後面會反轉。

不想碰命令列的話,Python 函式庫是同一套查詢的另一個入口,篩選條件用物件組好一次傳入。我實測用函式庫指定台幣查松山飛羽田(松山進出的商務客會懂這條線),回來 43 個結果,最便宜前三個是中華航空 CI222、全日空 NH854、長榮 BR190,價格依序是 9,528、9,734、10,505 元,班表與價格一次拿齊。命令列、Python、MCP 三個入口共用同一套搜尋核心,行為與限制完全一致,挑順手的用就好。

跟一般機票比價網站相比,這條路的價值在於可程式化:同樣的查詢可以寫進腳本定期跑、可以換參數批次比,Flight Atlas 這類地圖式比價工具適合瀏覽靈感,Fli 適合把查價變成固定流程的一部分。

接進 Claude:你裝到的版本其實只有三個工具

Fli 之所以被拿出來討論,多半是因為 MCP 伺服器這個身分。安裝 flights[mcp] 後會多出 fli-mcp 執行檔,把它寫進 Claude Desktop 的設定檔(macOS 路徑為 ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "fli": {
      "command": "fli-mcp",
      "args": []
    }
  }
}

重啟 Claude Desktop 之後,就能用自然語言查航班。我沒有實機掛 Claude Desktop,而是直接用 MCP 的 stdio 協定對伺服器握手:伺服器回報名稱 Flight Search MCP Server、版本 4.2.2,握手成功。接著列工具,這裡出現第一個文件落差:README 的工具表列了 search_flights、search_dates、search_explore 三個主要工具,但你今天從 PyPI 裝到的 0.9.0,列出來的是 search_flights、search_dates、find_airports 三個,沒有 explore。search_explore 是 2026 年 11 月 11 日才合併進主分支的新功能(給定出發地與預算,一次回幾十個目的地的最低價),還沒發版;主分支上還有一個 get_booking_options,同樣裝不到。照 README 試 explore 只會得到工具不存在的回應,不是你設定錯。

Claude Desktop 對話介面中使用 Fli MCP 伺服器查詢航班的示範畫面Pin
把 Fli MCP 伺服器接進 Claude Desktop 後的對話查詢示範(圖片來源:Fli GitHub README)

實際呼叫也正常:我另外用 git 安裝的主分支 MCP 伺服器,帶上台灣情境的完整參數(幣別 TWD、語言 zh-TW、國家 TW)以 search_flights 查桃園飛羽田的直飛經濟艙,回傳樂桃 MM860 共 6,060 元、台灣虎航 IT216 共 9,099 元,幣別與在地化參數整條鏈都通。換句話說,在 Claude 裡問「12 月 18 日桃園飛東京直飛經濟艙最便宜多少錢」,背後就是這組查詢在跑。已發佈版內建的第三個工具 find_airports 則是機場代碼查詢,跟 CLI 的 airports 指令同一套資料庫,問「taipei 有哪些機場」就會列 TPE 與 TSA。想多了解 MCP 生態可以看我之前寫的攝影棚與 Premiere 的 MCP 整合,同一套協定把各種服務接進對話介面的邏輯是一樣的。

來回票的行為值得單獨記一筆(這段講的是 README 版的參數,0.9.0 的 MCP 工具還沒有這個旋鈕):搜尋會先抓去程候選,再逐一展開回程,預設只展開最便宜的 5 個去程選項,參數 top_n 可以調到 10,代價是頁面抓取次數變成 1 加 top_n。官方文件提醒的實務症狀很有感:來回票結果常常整批來自同一家航空公司,這是預設排序只展開最便宜去程的副作用,把 top_n 調高或換排序就會看到別家。

不想開 stdio 的用戶端也有另一條路:fli-mcp-http 會在本機 8000 埠起一個 streamable HTTP 端點(http://127.0.0.1:8000/mcp/),接自建的代理或自動化流程比 stdio 方便。對話端實際能問的問題形態,官方給的例子有三型:指定日期艙等的直飛查詢、一段期間內找便宜出發日、指定艙等加轉機條件;參數上還支援航空聯盟、排除特定航空公司、多機場一起比價這類組合。我實測的體感是,只要講得出出發地、目的地、日期三要素,模型自己就會把參數組對,艙等聯盟這些想加就口頭補上。

Google 在 2026 年 8 月關過一次門:README 的限制清單在講你還裝不到的版本

Fli 的查詢不是走 Google 開放出來的 API,而是逆向工程 Google Flights 的內部介面,這件事官方文件寫得很坦白。2026 年 8 月出了大事:Google 給內部 RPC 端點加上了一個名為 x-goog-batchexecute-bgr 的標頭,這個值只有 Google 頁面自己的 JavaScript 生得出來。當時開出的 issue #223 標題就叫「常見航線回空」,班加羅爾飛德里這種最繁忙的國內線之一全部查無航班,八月初開案、九月二十日才結案。

專案的解法(寫在主分支、還沒發版)是換路線:改抓 Google Flights 公開搜尋頁面本身,把篩選條件編成 tfs 參數帶在網址上,再從頁面內嵌的資料區塊解析出航班。這條新路線天生矮一截,README 列得很清楚:

  • 多城市行程直接回不支援,因為那種結果由頁面端 JavaScript 動態載入,原始頁面裡沒有資料可解析;官方建議逐段分開查。
  • 訂位選項功能不可用,查詢到的航班仍附 Google Flights 的訂購深連結,點出去可以完成訂票,但程式裡拿不到訂位細節。
  • 碳排放、行李、排除基本經濟艙三個篩選條件被丟棄,因為網址參數裡沒有對應欄位。
  • 單次查詢大約回 20 到 45 個行程,比舊路線少,而且補不回來。
  • 日期比價改成一天一天逐頁查,單次範圍上限 93 天。
  • 帶兒童或嬰兒查詢時結果會明顯變薄。官方 2026 年 9 月的量測:紐約飛倫敦經濟艙,一位大人 23 列、帶一個嬰兒剩 16 列;舊金山飛東京商務艙,大人查有 9 列、帶一個小孩直接 0 列。查到零航班時先別斷定這條線沒飛機,換大人身分再查一次對照。

這裡就是三個文件落差裡最大的一個:上面整份限制清單,講的都是主分支的行為;你今天裝到的 0.9.0 根本還在舊的 RPC 路線上,而且我 2026 年 11 月 19 日實測兩條路都還通。前面那些 109 筆、154 筆、多城市 10 筆、Python 函式庫的 43 筆,全部是 0.9.0 的舊路線跑出來的;我也直接拿主分支的 MCP 伺服器實測台幣查詢,新路線一樣回得動。對照起來,0.9.0 的能力其實比 README 描述的更寬:多城市查詢會動、命令列有碳排放與行李件的篩選參數、Python API 也還有查訂位選項的方法。代價是這條舊路站在 Google 已經開始設防的端點上,對方什麼時候收緊沒有人知道,專案自己已經搬家了,下一版發佈你就會從「能力較寬的舊路」換到「限制較多但更耐走的新路」。主分支版還補了幾個環境防護,同樣要等發版:歐盟 IP 撞到 Google 同意頁時預設夾帶預先同意的 cookie(FLI_SOCS_COOKIE 可換可停用)、企業 TLS 攔截環境可設 FLI_CA_BUNDLE 指向自訂憑證、約六十分之一的請求會拿到空頁面並自動重試兩次。

第二個文件落差是我親自撞上的:同一個查詢在幾秒內連續發送,常常回空結果,跟輸出格式無關。我先用文字模式查到 154 個選項,幾秒後用 JSON 模式重跑同一查詢,回來 0 筆;間隔 30 秒再跑一次,又完整回來 154 筆。這是 Google 端的短時間重複查詢節流,所以自動化腳本要加查詢間隔,而且別把空結果直接當成沒航班。另外 JSON 輸出模式(--format json)官方標註為實驗性質,格式還會變,我在冷卻後實測可以完整回 154 筆結果,能用,但別把它的欄位位置寫死在你的程式裡。

查得到不代表查完了:那霸轉機的行程會憑空消失

實測過程中最值得記下來的發現,是查詢結果會靜默漏掉部分行程。桃園飛羽田那筆 109 個選項的查詢,終端機同時印了 15 次「Unknown airport IATA code ‘OKA’」的警告。OKA 是那霸機場,沖繩的主力機場,怎麼會是未知代碼?

根因藏在資料結構的設計裡:Fli 用一個 Python 列舉型別存放全球機場,鍵是 IATA 代碼、值是機場名稱。那霸有兩個代碼,OKA(現在的機場)與 NAH(舊水上機場的代碼),兩者在資料表裡的機場名稱字串都是 Naha Airport。Python 的列舉遇到兩個成員同值時,後者會變成前者的別名,於是 OKA 不再是一個獨立成員。而搜尋結果的解碼器用「迭代列舉成員」的方式建立代碼對照表,別名成員不會被迭代到,對照表裡從此沒有 OKA。解碼時碰到查不到的代碼,就記一筆警告、把那一整列行程丟掉。

受影響的不只那霸:往原始碼裡比對 0.9.0 的列舉結構,共有 48 個機場代碼因為同名撞成別名,全部會被靜默丟列,其中與 BSL(瑞士巴塞爾)共用同名機場的 MLH(法國米盧斯)也在名單內,被丟掉的是 MLH 那個代碼。實際影響很直接:經沖繩轉機的行程不會出現在結果裡,而且沒有任何錯誤,只有 stderr 上一行你不會去看的警告。主分支已經給 48 個同名機場全部補上代碼後綴消除了撞名,問題解決,但一樣卡在沒發版。這是第三個文件落差。使用 0.9.0 時要有個認知:結果數字是下限,不是全量。

資料流向與授權:只跟 Google 說話的單人專案

隱私面我把整個套件的原始碼 clone 下來掃過一遍:網路端點清一色是 www.google.com(搜尋頁、訂購連結、探索功能),沒有任何遙測、分析或第三方上傳。查詢內容本來就會送給 Google,因為查的就是它的資料,除此之外沒有別的收件人。執行出錯時會把完整命令與追溯資訊寫進本機的 ~/.fli/logs/ 目錄,純本地檔案。連線用的是 curl_cffi 並偽裝成 Chrome 的指紋,這是逆向工程路線的必要手段,也再次說明這個專案的性質:它站在 Google 沒有承諾過的介面上,Google 隨時可以再改版面,2026 年 8 月那次就真的發生過。

專案體質方面:MIT 授權,商用沒有問題;3,507 顆星、426 個 fork,但貢獻紀錄實質是一位維護者(Punit Arani,182 次提交,其餘是機器人與零星兩三次的貢獻),巴士係數等於一。倉庫裡躺著 CLAUDE.md 與 AGENTS.md,看得出大量使用 AI 輔助開發,這本身不是問題,產品也確實能用。工程衛生倒是意外地好:測試預設全程離線跑(會打到真正 Google 的測試要另外開關才會執行)、有獨立文件站、開發環境用 uv 一鍵同步。另外 npm 上有一比一移植的 TypeScript 版 fli-js,限制與 Python 版完全相同,寫 Node 的人可以直升。最後是定位問題:Fli 只做查詢與比價,不能訂票,訂位要點深連結回 Google Flights 完成;文中所有價格都是 2026 年 11 月 19 日的查詢快照,機票價格天天在動,下單前請以 Google Flights 頁面上的即時價為準。

查價可以交給它,訂票永遠要出站完成

適合的場景很明確:想讓 Claude 幫你查航班與便宜日期、想把查價寫進腳本做定期觀察、做機票價格分析或通知自動化的人。用今天的配方裝,一個下午就能跑起來,而且查詢、比價、多城市、在地化計價都實測可用。三件事不要指望它:訂票永遠要點深連結回 Google Flights 完成;多城市查詢雖然 0.9.0 還能跑,但主分支已經把它拔掉,依賴這個功能前先看清楚版本;需要商業級穩定保證的生產環境,這種騎在逆向工程介面上的工具本來就不該是首選,TripStar 這類 AI 旅遊規劃工具或一般訂票平台更合適。

安裝總結一行:pip install flights click "plotext<6",接 Claude 再加 [mcp]。如果想賭主分支的新功能(search_explore、修好的 48 個機場),可以改用 git 安裝拿最新程式碼,穩定性自負,而且記得 plotext<6 的防護 git 版同樣要帶;或者等一版真正把半年落差補上的正式發佈。這個專案最誠實的地方,是連自己的限制都寫得鉅細靡遺,README 的搜尋路線一節根本是一份限制清單;最需要小心的地方,則是所有文件都在描述你還裝不到的那個版本。

Sliven 褚崇名
Sliven 褚崇名

每日分享科技新知、免費資源以及 WordPress、虛擬主機相關主題,任何問題歡迎在科技月球下方留言,或是發送 Email 至 [email protected] 與我聯繫。

文章: 2571

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *


Share to...