Letsfg

私たちはLetsFGです — 旅行者のコミュニティです。

フライトやホテルを探すために、47個ものタブを確認する必要はありません。検索に3時間もかける必要はありません。
もう少し待っていれば、もっとお得に予約できたかもしれない、という気持ちになる必要もありません。

そこで、私たちは解決策を作りました。
料金は合計金額ひとつだけ。追跡なし。何度か見たからといって値上がりすることもありません。

        

     

コミュニティに参加して、ほかの人がお得なフライトを見つけるのを手伝い、情報を広めましょう。
⭐ リポジトリにスターを付けて、友人と共有しましょう ✈️

         

---

フライトとホテル。どちらも実際に予約できます。

世界中のすべての航空会社。実際の価格。関数呼び出し1回。

LetsFG を使うと、AI エージェントにフライトとホテルの検索・予約機能を追加できます。サーバー側のエンジンが世界中を検索し、最安値を見つけます。検索は無料です。予約は実際に行われます。運賃がカードに確保され、LetsFG の予約エージェントが航空券を購入し、航空会社の PNR が届きます。

同じフライトが $20～$50 安くなります。 OTA の上乗せ、Cookie による追跡、急騰料金を回避できるためです。

Claude： LetsFG は Claude のコネクターディレクトリにあります。そこから追加でき、URL を貼り付ける必要はありません。その他のエージェント： https://letsfg.co/mcp を MCP サーバーとして追加してください。接続を承認すると letsfg.co/connect が開きます。ワンタップで完了し、カードは不要です。カード情報は初回予約時に、0.00 の Revolut セットアップで求められます（請求は発生せず、Revolut アカウントも不要です）。このトークンで無料検索と予約ができます。スクリプト： 同じトークンを Authorization: Bearer として PFS エンドポイントに送信してください。開発者向け API： 大量の商用利用向けの別途有料製品です。ほとんどのエージェントには不要です。→ 利用を開始する

サポーター

実際の価格：LetsFG と Google Flights の比較

同じ日に（2026-08-05）、2026-09-16 出発のフライトについて、Google Flights と LetsFG で5つのルートを検索しました。同じ航空会社、同じ乗り継ぎ回数で、毎回 LetsFG のほうが安くなりました。

検証済みの比較で、5つのルート合計 $133 安くなりました（2026-08-05）。検索を何度実行しても LetsFG が同じ価格を返すのは、ユーザーを追跡しないためです。

なぜ価格差があるのでしょうか？ LetsFG は、同じフライトを Skyscanner、Kayak、Momondo など多数の販売元に加え、航空会社のウェブサイト（Ryanair、United、Southwest、EasyJet、Spirit、Norwegian、AirAsia など）で比較し、最安値を表示します。Cookie による追跡はありません。同じ検索を何度実行しても、同じ価格が返されます。

実際のホテル料金：LetsFG と Booking.com の比較

同じホテル、同じ客室タイプ、同じ2泊、同じ無料キャンセルポリシーを、同じ日（2026-08-05）に2026-09-16のチェックインで確認しました。

検証済みの比較（2026-08-05）では、3つのホテルで合計$207安くなります。各施設の同一の日程・客室タイプにおける無料キャンセル料金を、Booking.comの無料キャンセル料金と照合しています。料金は予約時のPLNで提示され、その日の為替レートでUSDに換算しています。

なぜ差があるのでしょうか？ LetsFGの料金は需要や検索した人によって上がらず、ロイヤルティプログラムによる相互補助もありません。予約時に料金はカードで確保されますが、引き落とされるのはホテルが確認した後だけです。上記の比較では両方とも無料キャンセル料金を使用しています。LetsFGでは返金不可料金も販売しており、それぞれのオファーにその旨が記載されています。

今すぐお試しください — インストール不要

人間のユーザー： letsfg.coを使って、ブラウザーですぐにフライトを検索できます。

任意のルートを検索して、リアルタイムの検索結果を比較し、希望のフライトを予約できます。インストールは不要です。

エージェント／スクリプト（無料のサーバーサイド利用）： 支払い方法を登録して（請求は発生しません）Bearer トークンを取得し、POST /api/searchとPOST /api/agent-bookを使用します。これはletsfg.coのエンジンを利用したPFS — Programmatic Flight Searchです。検索は無料です。トークンは有効期間が短く、自動で更新されます。詳しいガイドはletsfg.co/for-agentsをご覧ください。

独自のエージェントに統合する準備ができたら、続きをお読みください。

LetsFG の利用方法は3つ

• MCP／CLI／SDK（方法1）： https://letsfg.co/mcpをClaude、ChatGPT、Cursor、またはWindsurfのMCP サーバーとして追加し、接続を承認します。同意手続きではletsfg.co/connectが開き、ワンタップで完了します。カードは不要です。初回予約時に（任意のカード、またはRevolut Pay／Google Payを使って）0.00 Revolutセットアップでカードの登録が求められます。請求は発生せず、Revolutアカウントも必要ありません。カード情報が送信されるのはRevolutであり、LetsFGには送信されません。取得したトークンで無料検索ができ、カードを登録すると同じトークンで予約できます。PythonおよびJS SDKはLETSFG_BEARER_TOKENまたは~/.letsfg/config.jsonからトークンを読み込み、オープンソースのランキングアルゴリズムをローカルで適用します。（letsfg authは、ターミナルから同じ接続手続きを実行します。OAuth クライアントとして自身を登録し、ブラウザーでletsfg.co/connectを開いてユーザーの承認を受け、トークンを保存します。）

• PFS — プログラムによるフライト検索（パス 2）： API を直接呼び出すスクリプトやエージェント向けです。letsfg.co はデフォルトで人間専用です（Cloudflare Turnstile とボット対策）。そのため、接続フローで取得したトークンだけがプログラムからアクセスする方法です。すべてのリクエストにトークンを含めてください。

  1. 検索：POST https://letsfg.co/api/search に Authorization: Bearer <token> を付けて送信 → { search_id }
  2. 結果の取得：GET https://letsfg.co/api/results/<search_id>（レート制限にはカウントされません）
  3. 予約：POST https://letsfg.co/api/agent-book を送信 → 数秒以内に { booking_ref }
  4. 待機：POST https://letsfg.co/api/agent-book/status に { booking_ref } を付け、completed（PNR）、failed（保留が解除され、課金なし）、needs_attention のいずれかになるまで 20〜30 秒ごとに送信します。

  POST /api/agent-access/request は引き続き 402 と add_card_url、およびこれらの手順を JSON で返すため、このエンドポイントから開始したエージェントも同じ手順に進みます。MPP の方法（ウォレットを使用し、カード不要）に変更はありません。WWW-Authenticate: Payment チャレンジ（1 回のみ $0.01）に応答し、Authorization: Payment で検証してください。Stripe の setup_url / SetupIntent の方法は 2026-09-02 に廃止され、発行済みのトークンはすべて無効化されました。letsfg.co/connect で再接続してください。完全なガイドとレスポンスのスキーマについては、letsfg.co/for-agents をご覧ください。

• 開発者 API（パス 3）： サーバーサイドの検索と予約については、letsfg.co/developers をご覧ください。検索から予約への導線（予約ごとに 200 回無料、その後は $0.01）、接続済みの Revolut の決済方法を使った実際の予約（POST /flights/book）、自然言語クエリの完全な解析、1 回の呼び出しで 20 の目的地を確認する /discover エンドポイント（2〜5 秒）、ホテル、さらに予約の一連の流れをエンドツーエンドでシミュレートする無料のサンドボックス /sandbox/flights/*（状態、質問、失敗、実際の所要時間）を利用できます。完全なドキュメントについては、letsfg.co/developers/api/docs をご覧ください。

無料のサーバーサイド検索： パス 1 または PFS を使用してください。letsfg.co/connect で一度接続すれば（ワンタップ、カード不要）、検索は当社のサーバー上で無料で実行されます。Playwright は不要で、SDK 以外にローカルへのインストールも不要です。
自社プロダクトからの予約： 開発者 API（パス 3）を使用してください。検索から予約への導線、POST /flights/book が利用でき、予約手数料や取引手数料はありません。ホテルは、接続フローで取得したトークンと開発者 API キーのどちらでも利用できます。

料金

MCP / CLI / SDK / PFS は検索無料、実際に予約でき、別途手数料はありません。 一度接続すれば（ワンタップ、カード不要）、検索は無料です。初回の予約時にカード情報を求められますが、Revolut の設定は 0.00 で行われます（請求はありません）。クレジットも、ロック解除の手順もありません。予約はウェブサイトのチェックアウトとまったく同じように機能します。book_flight / POST /api/agent-book はカードに表示された価格を確保し、LetsFG の予約エージェントが販売元からチケットを購入します。実際の航空会社 PNR が発行された時点でのみ、確保した金額が決済されます。予約に失敗した場合は確保が解除され、請求はありません。表示される価格がそのまま支払う価格であり、予約時に追加料金はかかりません。

ホテルでは、どの経路でも、提示価格を確保してから決済します。 カードで全額を確保し、LetsFG がホテルを予約して支払いを行います。ホテルが確定した時点でのみ、確保した金額が決済されます。予約に失敗した場合は確保が解除されます。予約手数料、デポジット、支払いリンクはありません。すべての料金タイプを販売しており、各プランには返金可能かどうかと、その期限が記載されています。以下のホテルをご覧ください。

Developer API はビジネス利用向けの、検索数に対する予約数の比率を重視したサービスです。 letsfg.co/developers では、フライトを自動で予約できます。POST /flights/book は接続済みの Revolut の支払い方法で運賃を確保し、LetsFG の予約エージェントがチケットを購入します。他の経路とまったく同じ仕組みです。検索は呼び出しごとに課金されません。予約を行うたびに検索 200 回が無料で付与され、予約するとカウンターがリセットされます。超過分は 500 回ごとに $5.00（1 回あたり $0.01）です。さらに予約手数料も取引手数料もありません。検索結果に表示された金額がそのまま請求されます。最低チャージ額は $5 です。

月間検索数に応じた料金プラン（$0.50 / $0.20 / $0.10）は、Stripe とともに 2026-09-08 に終了しました。現在の支払い方法は Revolut です。POST /agents/connect-payment を呼び出すと、カード情報を保存するための一度限りのリンクが返されます。接続時に請求はありません。

💡 旅行好きの知り合いはいませんか？ LetsFG を知る人が増えるほど、カバーする航空会社も増え、みんなにとってさらに便利になります。⭐ Star · 友人にシェア

開発者にこのリポジトリがスターされる理由

はじめに

すべて当社のサーバー上で実行されます。MCP、SDK、そして生 API を 1 つの接続で利用できます。

🔌 MCP — 一度接続すれば、検索して予約できます

リモートサーバーを追加し、接続を承認します。同意の手続きでは letsfg.co/connect が開きます。ワンタップで、カード不要ですぐに利用できます。カード情報が求められるのは最初の予約時です（初期設定費用は0.00で、請求はありません）。

# Claude Code
claude mcp add --transport http letsfg https://letsfg.co/mcp

// Cursor (~/.cursor/mcp.json) — Windsurf uses "serverUrl" instead of "url"
{ "mcpServers": { "letsfg": { "url": "https://letsfg.co/mcp" } } }

Claude：LetsFG は Claude の公式コネクターディレクトリに掲載されています。claude.ai/directory/letsfg を開いて追加し、接続を承認してください。URL を貼り付ける必要はありません。追加すると、Claude Desktop と Claude のスマートフォンアプリでも使えます。

ChatGPT：ブラウザーで chatgpt.com を開いて追加します（ChatGPT のスマートフォンアプリからは追加できません）。Plugins > Add > Add custom MCP server を選択し、URL に https://letsfg.co/mcp、認証に OAuth を指定して、I understand にチェックを入れ、Create as a plugin を選択します。追加すると、ChatGPT のスマートフォンアプリでも使えます。

その後、チャットで次のように入力します：「6月15日のロンドン発バルセロナ行きの最安航空券を探して予約して」。search_flights が航空券の候補を返し、book_flight がカードに運賃を仮押さえして LetsFG の予約エージェントを起動します。get_flight_booking は予約が完了すると PNR を返します（4〜11分）。

🖥️ CLI / SDK — 同じトークンを使用し、検索処理はローカルで実行

pip install letsfg
export LETSFG_BEARER_TOKEN=<token from the connect flow>
letsfg search LHR BCN 2026-06-15
letsfg search LHR JFK 2026-06-15 --cabin C   # cabin class: M economy, W premium, C business, F first

SDK は LETSFG_BEARER_TOKEN または ~/.letsfg/config.json からトークンを読み込みます。letsfg auth を実行すると、接続の手続きを自動で行います。OAuth クライアントとして登録し、承認する人のために https://letsfg.co/connect を開いて、トークンを ~/.letsfg/config.json に書き込みます。ブラウザーを開かずに URL を表示するには、--no-browser を追加してください。

🔌 PFS — Programmatic Flight Search（無料、サーバー側で実行）

どのスクリプトからでも、LetsFG のすべての検索機能を当社のサーバーで実行できます。アクセスには接続の手続きで取得したトークンが必要です： letsfg.co は人間のみが利用できるため（Cloudflare Turnstile）、このトークンが唯一のプログラム経由のアクセス方法です。接続はワンタップで、カードも不要です。カード情報が求められるのは最初の予約時です。

# 1. Search with the token
curl -X POST https://letsfg.co/api/search \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"origin":"LHR","destination":"BCN","date_from":"2026-06-15"}'
# → {"search_id":"ws_abc123","status":"searching"}

# 2. Poll until done (keep going while split_ticket_pending is true)
curl https://letsfg.co/api/results/ws_abc123 -H "Authorization: Bearer <token>"

# 3. Book — the fare is HELD on the card, a LetsFG agent buys the ticket
curl -X POST https://letsfg.co/api/agent-book \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"search_id":"ws_abc123","offer_id":"wo_abc123","contact_email":"[email protected]",
       "passenger":{"given_name":"Ada","family_name":"Lovelace","born_on":"1990-04-01","gender":"f",
                    "nationality":"GB","phone_number":"+447700900000","phone_country":"GB",
                    "address_line1":"1 Analytical Way","address_city":"London","address_postal":"N1 9GU","address_country":"GB"}}'
# → {"booking_ref":"eyJ..."} within seconds

# 4. Wait for the PNR (every 20–30 s; a booking takes 4–11 minutes)
curl -X POST https://letsfg.co/api/agent-book/status \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"booking_ref":"eyJ..."}'
# → {"state":"completed","pnr":"ABC123","charged_amount":93,"currency":"EUR"}

failed は仮押さえが解除され、請求が発生していないことを意味します。needs_attention は LetsFG の担当者が確認中であることを意味します。予約を再試行しないでください。搭乗者情報が不足している場合は missing_fields が返され、請求は発生しません。カードを登録していない場合、エンドポイントは add_card_url を含む payment_method_required を返します。詳しいガイドとレスポンスのスキーマは、letsfg.co/for-agents をご覧ください。

⚡ Developer API — サーバー側での検索、予約、ホテル

大規模な商用連携向けの別製品です。ほとんどのエージェントには不要です。検索から予約まで対応し、結果は数秒で返されます。POST /flights/book で実際に予約できるほか、/discover（1回の呼び出しで20の目的地を検索）、非同期ポーリング、自然言語クエリの解析、ホテル検索も利用できます。また、予約まで一通り試せる無料のサンドボックスもあります（本番と同じレスポンス、状態、質問、所要時間で、料金は発生しません）— まずはサンドボックスで予約フローを構築してください。

# Register, then search with your API key
curl -X POST https://letsfg.co/developers/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name":"my-agent","email":"[email protected]"}'

curl -X POST https://letsfg.co/developers/api/v1/flights/search \
  -H "X-API-Key: letsfg_..." \
  -H "Content-Type: application/json" \
  -d '{"origin":"LHR","destination":"BCN","date_from":"2026-06-15"}'

料金：予約のたびに検索200回分が無料です。その後は500回分を5.00ドル（1回あたり0.01ドル）で購入できます。予約手数料、取引手数料はありません。最低チャージ額は5ドルです。予約機能も含め、まずはサンドボックスで無料でお試しください。詳しいドキュメントは letsfg.co/developers/api/docs をご覧ください。

search_flights  LON → BCN, 2026-04-01, return 2026-04-08
get_flight_results  (while more offers are still landing)
book_flight     search_id + offer_id + one traveller's real details + contact_email
                → booking_ref in seconds; price HELD on the connected card
get_flight_booking  every 20–30 s → completed (PNR, charged_amount) | failed (hold released) | needs_attention

💡 気に入っていただけましたか？ ご支援ください — ⭐ スターを付ける · 友達に共有する

エージェントが動作するあらゆる環境で利用可能

MCP Server（Claude / ChatGPT / Cursor / Windsurf / OpenClaw）

ホスト型サーバーを使用してください。トークンはサーバーが代わりに処理し、book_flight は実際に予約を行います。

{
  "mcpServers": {
    "letsfg": {
      "url": "https://letsfg.co/mcp"
    }
  }
}

クライアントから求められたら接続を承認してください。同意の手順では letsfg.co/connect が開きます。ワンタップで完了し、カードは不要です。カード情報が求められるのは初回予約時です（セットアップ費用は 0.00 で、課金はありません）。ツールは search_flights、get_flight_results、book_flight、get_flight_booking と、ホテル関連のツールです。

stdio パッケージ（npx -y letsfg-mcp）も、LETSFG_BEARER_TOKEN にトークンを設定すれば使用できます。authenticate ツールから現在の接続手順が返されます。

{
  "mcpServers": {
    "letsfg": {
      "command": "npx",
      "args": ["-y", "letsfg-mcp"],
      "env": {
        "LETSFG_API_KEY": "letsfg_your_api_key"
      }
    }
  }
}

5 分で始めるクイックスタート： Claude · Cursor · Windsurf

Python SDK

from letsfg import LetsFG

bt = LetsFG()  # reads LETSFG_API_KEY from env
flights = bt.search("LHR", "JFK", "2026-04-15")
print(f"{flights.total_results} offers, cheapest: {flights.cheapest.summary()}")

JavaScript SDK

import { LetsFG } from 'letsfg';

const bt = new LetsFG({ apiKey: 'letsfg_...' });
const flights = await bt.search('LHR', 'JFK', '2026-04-15');
console.log(`${flights.totalResults} offers`);

Python SDK（クラウド検索）

from letsfg.local import search_local

# Reads LETSFG_BEARER_TOKEN env var or ~/.letsfg/config.json (the token from the connect flow)
result = await search_local("GDN", "BCN", "2026-06-15")

for offer in result.offers[:5]:
    print(f"{offer.airlines[0]}: {offer.currency} {offer.price}")

⇄ 分割チケット — 2 枚のチケットで 1 つの旅程

長距離路線を 1 つの旅程として検索すると、誰もが同じチケットを再販しているため、通し運賃が 1 つ返されます。ハブを経由する独立した 2 区間として検索すると、それぞれの区間で、その区間に最も安いチケットを予約します。航空会社も販売業者も問いません。通常は別々の航空会社になります（短い区間は格安航空会社、長い区間は別の航空会社となることがよくあります）が、ルールは「各区間で最安値を選ぶ」ことだけです。この組み合わせを 1 枚のチケットとして販売する業者はいないため、見積もりも出ません。だからこそ安くなります。

LetsFG はその旅程を組み立て、通し運賃とあわせて返します。分割チケットのオファーには明確なフラグが付けられ、隠されることはありません。

for o in offers:
    if o.get("split_ticket") == "true":
        print(o["price"], "— two separate tickets, self-transfer not protected")

価格を提示する前に self_transfer を確認してください。 unprotected は、2 枚のチケットが連携していないことを意味します。最初のフライトが遅れて乗り継ぎに間に合わなかった場合、2 社目の航空会社には何の義務もありません。振替も払い戻しも、ケアの提供もありません。これは節約と引き換えに提示される条件であり、旅行者にも伝える必要があります。乗り継ぎに十分な余裕がある場合にのみ分割を行い、その旨をオファーに明記します。ただし、条件を伝えずに価格だけを知らせるエージェントは、誤解を招く説明をしていることになります。

この検索は条件を満たす場合にのみ実行されます。 コネクターへの追加照会が 2 回発生し、実費がかかるため、通し運賃が十分に高く、旅程が十分に長く、経由地で旅程を分割できる市場がある場合にのみ、分割を試みます。ほとんどの検索では実行されず、実行された検索でも常に節約できるとは限りません。

結果は completed の後に届きます。 ポーリング：completed は終わりではありませんを参照してください。

実行環境： letsfg.co と、その背後にあるエージェント向けの経路（CLI、Python および JS SDK、MCP サーバー）です。有料の Developer API は別のバックエンドで提供されています。こちらでは self_transfer が返されますが、分割チケットのオファーは契約に含まれません。

実際にどれだけ節約できるか

_{2026年8月に実際の検索で測定（大人1名、片道、約2か月先）。各分割は2枚の別々のチケット（ここでは2つの異なる航空会社）であり、保護されていない自己乗り継ぎです — 最初のフライトが遅れた場合、2つ目の航空会社には何の責任もありません。価格は常に変動するため、これらがそのまま再現されることはありません。検索した26件の長距離ルートのうち5件で、最安の単一チケットより安い分割が見つかりました — この効果が現れるのは、安い直行長距離便がない二次都市です。tools/split-comparison.pyで再生成できます。}

上記の数値は実際の検索から得られたもので、再現可能です。スクリプトは誰でも実行できる公開検索をそのまま実行し、最安の分割を同じ結果セット内の最安の単一チケットと比較し、生のオファーをsplit-comparison.jsonに書き出すので、どの行でも確認できます。分割が得られなかったルートも、黙って除外するのではなく報告されます — ほとんどの検索では分割の調査は実行されず、それを隠した表はこれがどれほど頻繁に起こるかを誤って伝えることになります。

✦ 検索結果での Starlink Wi-Fi

オファーは、そのフライトに Starlink があるかどうかを、誠実な2つの段階で示します。確実な判定（confirmed_all）は、その航空会社がその機種のすべての機体に装備済みであることを意味します。留保付きの判定（likely_all）は、その機種への展開が実際に進行中だが完了していないことを意味します — 2026年8月時点で United は保有機材の約29%でした — したがって、これはシグナルとして報告されるものであり、決して約束ではありません。フィールドが存在しない場合は情報がないことを意味し、Wi-Fi がないことを意味するわけではありません。

for o in offers:
    if o.get("starlink") == "confirmed_all":
        print(f"{o['owner_airline']} {o['price']} — Starlink on every leg")

完全なセマンティクス: docs/api-search.md。

🏨 ホテル — 新登場、そしてライブ

エージェントはフライトだけでなく、ホテルも予約できるようになりました。同じ認証情報、同じ登録済みカードです。

ホテルを予約する前に SDK を更新してください。 ホテルの予約には letsfg 2026.5.101 以降（Python）、 letsfg 2026.5.74 以降（JavaScript/TypeScript）、または letsfg-mcp 2026.5.77 以降が必要です。それより前のリリースは、 2026-09-11 に廃止された予約手数料フィールド（expected_balance、expected_cost なし）を送信するため、API は それらが行うすべてのホテル予約を拒否します。pip install -U letsfg、npm install letsfg@latest、または npx -y letsfg-mcp@latest で更新してください。https://letsfg.co/mcp のホステッド MCP は更新不要です。

from letsfg import LetsFG
lfg = LetsFG()  # reads LETSFG_API_KEY — the SDK's hotel methods take a Developer API key

city = lfg.hotel_destinations("Warsaw")[0]
stays = lfg.search_hotels(
    city_id=city["Id"], city_name=city["Name"],
    check_in="2026-11-10", check_out="2026-11-12", adults=2,
)

hotel = stays["hotels"][0]
offer = hotel["offers"][0]
print(hotel["name"], offer["price"], offer["currency"],
      "refundable" if offer["refundable"] else "non-refundable")

booking = lfg.book_hotel_and_wait(
    session_id=offer["session_id"],
    hotel_code=hotel["hotel_code"],
    combination_id_v2=offer["combination_id_v2"],
    expected_price=offer["price"],
    expected_cost=offer["expected_cost"],
    currency=offer["currency"],
    fx_rate=offer["fx_rate"],
    city_id=city["Id"], city_name=city["Name"],
    check_in="2026-11-10", check_out="2026-11-12",
    guests=[{"title": "Mr", "first_name": "Jan", "last_name": "Kowalski"},     # one entry per guest:
            {"title": "Ms", "first_name": "Anna", "last_name": "Kowalska"}],   # adults=2 -> two names
    email="[email protected]", phone="512345678",
)
print(booking["status"], booking.get("confirmation"), booking.get("total_price"), booking.get("currency"))

支払い方法

予約時にホールドされ、ホテルが確定した時点で請求されます。 予約はカード上でprice全額をホールドします — 引き落とされるわけではありません。LetsFG が部屋を予約してサプライヤーに自社で支払い、ホールドはホテルが確定した後にのみキャプチャされます。何らかの理由で予約が失敗した場合（料金がなくなった、価格が変動した、サプライヤーが拒否した）、ホールドは解除され、何も請求されません。予約手数料、デポジット、支払いリンクはありません。

priceはオールインの合計額で、検索したcurrency（デフォルトは USD）で表示されます。返金可能な予約をfree_cancellation_untilより前にキャンセルした場合は全額返金されます。エンドポイントは、費用がかかるキャンセルを拒否します。ホテル独自の段階的な条件は予約のtermsに含まれているため、常に先に費用を確認できます。

構築する前に知っておきたいこと

• ホテルの検索にカードは不要ですが、予約には必要です。 ホテル検索ではサプライヤーとの実セッションが開始されるため、カード情報が登録されていないアカウントには、1日あたりのホテル検索回数に上限があります。予約では、予約が確保される前にカードを求められます。book_hotel は、book_flight と同様にカードを追加するリンクを返します。航空券の予約を承認するカードはホテルの予約にも使えます。ホテル専用の登録はありません。
• どの料金タイプも、販売中、返金可能、返金不可のいずれかです。 各オファーには refundable と free_cancellation_until が含まれます。返金不可の料金を予約する前に、宿泊客にこれらを提示してください。
• 予約は非同期です。 book_hotel は予約そのものではなく、booking_job_id を返します。実際の予約には数分かかります。status が succeeded、failed、attention のいずれかになるまで hotel_booking(job_id) をポーリングするか、book_hotel_and_wait を呼び出してください。attention は、LetsFG の担当者がサプライヤーに結果を確認していることを意味します。予約の確保は維持され、請求は発生しません。再予約してはいけません。
• オファーの内容をそのまま返してください。 expected_price、expected_cost、currency、fx_rate は、オファーで返された値を正確に送信してください。それ以外の値を送ると、予約が確保される前に price_mismatch として拒否されます。
• 宿泊客全員の名前を入力してください。 guests には、子どもを含め、部屋に宿泊する人数分のエントリーが必要です。大人を先に入力し、その後に child_ages の順で子どもを入力してください。検索時の人数より名前が少ない場合、ホテルに情報が届く前に予約は失敗し、確保も解除されます。
• ジョブの実行中に再予約しないでください。 ジョブをポーリングしてください。同じ idempotency_key を使って再試行すると、二重に予約せず、既存のジョブが返されます。
• 結果にかかわらず、宿泊客にはこちらから連絡します。 宿泊客のメールアドレスに確認メールを送るか、予約に失敗した場合や確認が必要な場合はメッセージを送ります。
• price は宿泊客が支払う金額です。expected_cost はサプライヤー側の金額で、返送するためだけのものです。決して見積もりとして提示しないでください。

JavaScript

import { LetsFG } from 'letsfg';
const lfg = new LetsFG({ apiKey: process.env.LETSFG_API_KEY });

const [city] = await lfg.hotelDestinations('Warsaw');
const stays = await lfg.searchHotels({
  cityId: city.Id, cityName: city.Name,
  checkIn: '2026-11-10', checkOut: '2026-11-12', adults: 2,
});

const booking = await lfg.bookHotelAndWait({ /* ...offer + guest details... */ });
console.log(booking.status, booking.confirmation, booking.total_price, booking.currency);

MCP

呼び出す順に、5つの新しいツールがあります。resolve_hotel_city → search_hotels → book_hotel → get_hotel_booking → cancel_hotel_booking。

🖥️ Omarchy デスクトッププラグイン

Omarchy バーから、世界中のあらゆる航空会社を検索できます。空港コード2つと日付を入力し、Search を押して、オファーをクリックすると開きます。パネルはこのリポジトリにあり、ルートにある manifest.json、BarWidget.qml、Panel.qml、Model.js で構成されています。CLI や MCP サーバーと同じエンジンで動作し、sdk/js/src/ranking.ts にある同じオープンソースのランキングアルゴリズムで並べ替えます。

インストール

omarchy plugin add https://github.com/LetsFG/LetsFG.git --enable

次に、Omarchy バーの設定で、バーのセクションに LetsFG Flights を追加します。パネルは ~/.letsfg/config.json（letsfg auth が書き込むファイル）から LetsFG トークンを読み取り、自動的に更新します。または、パネルから letsfg.co/connect に接続できます。ワンタップで、カードは不要です。詳細は OMARCHY-PLUGIN.md をご覧ください。

削除

omarchy plugin remove io.github.letsfg.flights

これで削除されるのはプラグインのみです。トークンはご自身のものです。削除したい場合は、~/.letsfg/config.json をご自身で削除してください。

このプラグインに API キーは同梱されていません。 ご自身で作成し、いつでも取り消せるトークンで認証します。カード情報を求めることはなく、独自に検索を開始することもありません。バックグラウンドでのポーリング、価格の監視、更新タイマーはありません。接続可能なすべてのホスト、読み書きするすべてのファイル、利用状況を把握するために送信する匿名のインストール ID については、OMARCHY-PLUGIN.md にすべて記載しています。

Omarchy Quattro シェルが必要です。このリポジトリの他の部分と同様に MIT ライセンスです。Omarchy または 37signals とは提携、支援、承認の関係にありません。

インストール

CLI コマンド

すべてのコマンドで、構造化出力には --json を、環境変数を上書きするには --api-key を指定できます。

仕組み

CLI / SDK / MCP（無料、クラウド対応）

Connect the MCP (once, one tap at letsfg.co/connect) → token → Search (free) → Book (card asked for at the first booking; hold → agent → PNR)

1. 認証 — https://letsfg.co/mcp を MCP サーバーとして追加し、接続を承認します。OAuth の同意手順で letsfg.co/connect が開きます。ワンタップで、カードは不要です。カード情報は最初の予約時に、手数料 0.00 の Revolut セットアップで求められます。接続時に請求は発生しません。SDK はこのトークンを LETSFG_BEARER_TOKEN または ~/.letsfg/config.json から読み込みます。
2. 検索 — letsfg search LHR BCN 2026-06-15 は POST https://letsfg.co/api/search を呼び出し、処理が完了するまでポーリングします（最初の結果まで 8～10 秒）。その後、オープンソースのランキングアルゴリズムをローカルで適用します。
3. 予約 — POST /api/agent-book は画面に表示された価格で運賃を確保し、LetsFG の予約エージェントを開始します。POST /api/agent-book/status は、PNR を含む completed（4～11 分）または、確保した運賃を解放した failed を返します。予約時に追加料金は発生しません。

ポーリング：completed は終了ではありません

検索を開始してから最初の結果が返るまで、通常8〜10秒かかります。GET /api/results/<search_id> を すぐに呼び出し、その後は2秒ごとにポーリングしてください。最初にスリープするループでは、スリープ時間より速く完了する検索にも待ち時間が発生します。

status が searching 以外になると、コネクターへのファンアウトは完了しています。ただし、オファーの一覧はまだ増える場合があります。分割チケットのプローブはファンアウトの後に実行され、結果が遅れて統合されます。そのため、その検索で最も安い旅程が status の終了状態への切り替わり時点ではまだ存在しないことがよくあります。レスポンスにはその状態が示されます。

どちらかが true の間はポーリングを続け、待ち時間に上限を設けてください。フラグが解除されない場合に、エージェントがいつまでも待ち続けてはいけません。上限に達したら、その時点までに取得できた結果を使用してください。

Python と JS の SDK、および MCP サーバーではすでにこの処理を行っており、上限は90秒です。これは、結果が確定したとサーバーが判断するまでの時間と同じです。 そのため、分割チケットのプローブが実行される検索では、最初の結果が8〜10秒で返る高速パスよりも大幅に時間がかかる場合があります。待っているのは分割チケットのオファーです。 高速な回答を優先する場合は、LETSFG_WAIT_FOR_SPLIT=0 を設定してください。

ほとんどの検索ではプローブが実行されないため、最初のポーリング時点ですでに両方のフラグが false になっていることが多く、この処理による遅延はありません。

PFS — 生の API（ラッパーなしで CLI と同じ）

Connected at letsfg.co/connect -> Bearer token -> POST /api/search -> poll GET /api/results/<id> -> POST /api/agent-book -> poll POST /api/agent-book/status

1. Bearer トークンを取得する — MCP OAuth フローで接続します。同意手続きは letsfg.co/connect で行います（ワンタップで完了し、カードは不要です。カードまたは Revolut Pay が求められるのは最初の予約時で、金額は0.00、請求は発生しません）。POST /api/agent-access/request は 402 とともに add_card_url および手順を返します。MPP ウォレット経由（1回あたり$0.01）の場合は、Authorization: Payment を指定して POST /api/agent-access/verify で認証します。
2. 検索する — Authorization: Bearer <token> を指定して POST https://letsfg.co/api/search を実行します。{ search_id } が返されます。GET /api/results/<search_id> をすぐに呼び出し、その後は2秒ごとに、status が searching 以外になるまでポーリングします。その後、split_ticket_pending または gf_enrich_pending が true の間もポーリングを続けます。分割チケットのオファーは、status が終了状態に切り替わった後に統合されます。
3. 予約する — POST /api/agent-book → booking_ref。completed（PNR）または failed（ホールドが解除され、請求は発生しません）になるまで、POST /api/agent-book/status をポーリングします。

Developer API — サーバー側の検索と予約

Register → Connect a Revolut method → Search (200 free per booking) → POST /flights/book → poll to a PNR

1. 検出する — 最大20件の目的地を指定して POST /flights/discover を実行すると、目安価格が安い順に返されます。1クレジット、2〜5秒。完全な検索を開始する前に、選択肢の順位付けに使用してください。
2. 完全な検索 — POST /flights/search（ブロッキング）または /flights/search/async（ノンブロッキング＋ポーリング）を実行します。1クレジット。最初の結果が返るまで8〜10秒です。
3. 予約する — 各オファーには航空会社への直接リンクである booking_url が含まれます。LetsFG の手数料はなく、チェックアウト手続きもありません。

アーキテクチャ

CLI / SDK / MCP / PFS

CLI / SDK / MCP / AI Agent
        │  Connected at letsfg.co/connect (one tap) -> Bearer token
        ▼
POST letsfg.co/api/search  (bot-protected, token required)
        │
        ▼
letsfg.co server-side search engine
        │
        ▼
GET /api/results/<search_id>  (poll every 2 s; keep going while split_ticket_pending)
        │
        ▼
Ranking applied locally (sdk/js/src/ranking.ts, open-source)
        │
        ▼
Results + booking via POST /api/agent-book (hold on card -> LetsFG agent -> PNR)

開発者向け API

Product / Team / Agent
        │  API key + a connected Revolut method
        ▼
letsfg.co/developers/api/v1
  ├─ /flights/discover      (indicative prices, 20 dest, 2–5 s)
  ├─ /flights/search        (full search, 8–10 s to first results)
  ├─ /flights/search/async  (non-blocking + poll)
  ├─ /flights/parse-query   (Gemini NL parsing, free)
  ├─ /flights/book          (holds the fare on the connected method)
  ├─ /flights/bookings/{id} (poll to a real PNR, 4–11 min)
  └─ /sandbox/flights/*     (free: search + simulated booking, same schema)
        │
        ▼
Real airline PNR - the hold is captured only once it exists

スター履歴