cheapdates

ある路線で最も安い日付を、Google Flights から直接取得します。CLI + MCP サーバー。

存在理由: Google の価格カレンダー (GetCalendarGraph) は BotGuard によってリクエストごとに署名されるため、2026 年半ば以降、純粋な HTTP クライアント (fli dates、google-flights-mcp、…) はすべて空の結果を返しています。cheapdates には 2 つのバックエンドがあります:

• graph — ヘッドレス Chromium をルートページに誘導し、Price graph を開いて、ページ自体が受け取るカレンダーを読み取ります。1 回の呼び出しで約 60 の出発日 (片道または往復) を取得できます。60 日あたり約 3 秒。

• sweep — 日付ごとに 1 回の fast-flights 検索を行い、ブラウザは不要です。4 ワーカーで 1 日あたり約 0.5 秒。航空会社もわかります。

auto (デフォルト) は、Playwright + Chromium がインストールされている場合は graph を使用し、それ以外の場合は sweep を使用します。graph が失敗した場合は sweep にフォールバックします。

インストール

git clone https://github.com/afgoes/cheapdates.git && cd cheapdates && uv sync   # see INSTALL.md
python -m playwright install chromium       # for the graph backend

Related MCP server: fli

CLI

cheapdates JFK LHR 2026-10-01 2026-11-30            # one-way
cheapdates JFK LHR 2026-10-01 2026-11-30 -r 7       # round trip, 7 nights
cheapdates JFK LHR 2026-10-01 2026-11-30 --nonstop --json
cheapdates JFK LHR 2026-10-01 2026-11-30 -b sweep   # force fast-flights

MCP (Claude Code)

claude mcp add cheapdates -- uv run --directory /path/to/cheapdates cheapdates-mcp

ツール: cheapest_dates_tool(origin, destination, start, end, trip_length?, currency?, nonstop?, seat?, backend?)。

Python

import datetime as dt
from cheapdates import cheapest_dates
r = cheapest_dates("JFK", "LHR", dt.date(2026,10,1), dt.date(2026,11,30), trip_length=7)
print(r.cheapest)

注意事項

リバースエンジニアリングによるものです。Google はいつでもページやレスポンスを変更する可能性があります。パーサーはフィクスチャでテストされており (pytest)、graph バックエンドは失敗時に sweep にフォールバックします。