LetsFG/LetsFG · 上手攻略

仓库：LetsFG/LetsFG
链接：https://github.com/LetsFG/LetsFG
分类：AI Agent / 旅行预订 / MCP
作者：Jay
更新：2026-08-26

是什么

LetsFG 是一款面向 AI Agent 的航班与酒店搜索与预订工具，提供 MCP Server、CLI 和 Python/JS SDK三种接入方式。特色是"真实票价、无溢价、无追踪"，整合了 75 家航空公司直连 + 企业 GDS 源（Amadeus、Duffel、Sabre、Travelport），搜索耗时约 5-10 秒。酒店仅售免费取消的延迟付款房价（付 5% 订金，余款在酒店截止日期前直接付给供应商）。

注意： MPP（M achine Payments Protocol） 402 challenge 已上线，作为无卡注册通道（需持有 Tempo 钱包，$0.01 验证费用，一次性）。搜索和预订本身免费。

解决什么问题

AI Agent 需要可靠调用真实旅行数据时面临的痛点： - OTA（携程/Booking/Expedia）价格含溢价、存在 Cookie 追踪，价格会因反复查看而上涨 - 通用搜索 API 依赖 API Key 注册、付费门槛高 - 酒店预订缺乏适合 Agent 的预订流程（无卡支付、异步确认、价格透明度）

LetsFG 的解法：免费搜索 + 无卡注册通道 + 5% 订金/延迟付余款 的酒店预订模型，专为 Agent 设计。

快速安装

Python SDK（最简路径）

pip install letsfg
# 安装浏览器驱动（本地 Connector 需要）
playwright install chromium

MCP Server

# 安装后，在 MCP 配置文件中添加 letsfg-mcp 服务器
# Claude Desktop / OpenClaw 等 MCP 兼容工具均可接入
letsfg-mcp

CLI

# 安装后即可使用
pip install letsfg
letsfg auth        # 零额度 Stripe 授权（不扣钱），返回 90 天 Token
letsfg search      # 搜索航班
letsfg book        # 预订航班

⚠️ 不要调用 /developers/api/v1/agents/register 或 /developers/api/v1/agents/setup-payment，那些属于商业高用量预付费产品，会创建计费账户。

API Key（可选，付费搜索）

注册地址：https://letsfg.co/developers/api/docs

# 定价
$0.50 / 次（前 10 次/月）
$0.20 / 次（11-1000 次/月）
$0.10 / 次（1000 次以上）
# 最低充值 $5；沙箱环境免费测试

核心用法

航班搜索（Python SDK）

from letsfg import LetsFG
lfg = LetsFG()

# 基础搜索（无需 API Key）
results = lfg.search_flights(
    origin="LHR",
    destination="BCN",
    date_from="2026-06-15"
)
print(results)

酒店搜索 & 预订

from letsfg import LetsFG
lfg = LetsFG()

# 查目的地 ID
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"], stays["currency"])
# 输出示例：Hotel Gromada Warszawa Centrum 669.86 PLN

# 预订（5% 订金 + 延迟付余款）
booking = lfg.book_hotel_and_wait(
    session_id=stays["session_id"],
    hotel_code=hotel["hotel_code"],
    combination_id_v2=offer["combination_id_v2"],
    expected_price=offer["price"],
    expected_balance=offer["balance_to_supplier"],
    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"}],
    email="guest@example.com",
    phone="512345678",
)
print(booking["confirmation"], booking["pay_link"])

JavaScript SDK

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.confirmation, booking.pay_link);

MCP Server（接入 AI Agent）

// MCP 配置文件（Claude Desktop / OpenClaw 等）
{
  "mcpServers": {
    "letsfg": {
      "command": "letsfg-mcp"
    }
  }
}

可用的 MCP 工具（按调用顺序）：

resolve_hotel_city → search_hotels → book_hotel → get_hotel_booking → cancel_hotel_booking

酒店预订关键规则

规则	说明
5% 订金 + 余款延迟付	5% 预授权，剩余通过返回的 `pay_link` 直接付给酒店
截止日期 = 酒店截止日期	非平台自行设定，逾期自动释放房间
5% 不可退，取消费 = 0	仅在酒店自身取消政策下收费，可达 100%
预订是异步的	`book_hotel` 返回 `booking_job_id`（非确认号），需轮询 `get_hotel_booking` 直至状态为 `succeeded`
禁止重复预订	同一房价调用两次 `book_hotel` = 两次订房 + 两次订金
酒店搜索需信用卡存档	不同于航班，酒店搜索也要求卡存档（因为打开了真实的供应商会话）
仅售免费取消房价	结果少于 OTA，但每一个都能真实预订

典型适用场景

AI Agent 行程规划：OpenClaw、Perplexity Computer、Manus、Claude Code、Codex 等 Agent 的航班酒店搜索工具
旅行研究自动化：批量比对航线价格、研究航空公司可靠性数据（内置 Starlink 覆盖标注）
商业差旅 Agent：企业 Agent 代订机票酒店，无溢价、无 Cookie 追踪
旅行内容创作：实时票价数据抓取，生成旅行攻略内容

坑与注意

坑点	说明
搜索 vs 预订的卡分开	航班预订和酒店预订共用同一张卡，但需要分别授权；不要跑 `setup-payment`（那是商业预付账户）
酒店搜索需信用卡	不同于航班，酒店搜索也要求卡存档（因为打开真实供应商会话）
预订是异步的	`book_hotel` 不直接返回确认号，需轮询；不要盲目重试（重复预订会被扣两次订金）
免费取消 ≠ 无条件取消	超过酒店 `balance_due_by` 截止日后取消，按酒店政策收费，最高可达 100%
价格无批发锚点	返回的 `price` 即客人实际支付价，无内部批发价可供引用
API 付费搜索	免费层仅本地 Connector（部分航司），企业 GDS（400+ 航司）需付费 API Key
Starlink 标注为两档	`confirmed_all` = 全机型确认覆盖；`likely_all` = 确认中但尚未 100%，标注需解读

与同类对比

工具	定位	价格	Agent 友好度
LetsFG	Agent-native 航班/酒店搜索预订	搜索免费（本地）/ $0.10-0.50（API）	★★★★★ MCP/CLI/SDK 全家桶
SerpAPI / Skyscanner API	航班搜索 API	按量付费，贵	★★☆ 无预订能力
Amadeus / Sabre / Duffel	GDS 直连	企业级定价	★★☆ 面向传统旅游公司
OTA APIs（携程/Booking）	OTA 平台 API	含溢价	★☆☆ 含追踪、不适合 Agent
Expedia API	酒店/航班 API	商业定价	★★☆ 面向旅行社

核心差异化：真正为 Agent 设计（MCP 原生 + 无卡注册通道 + 异步预订流程），而非将现有旅游 API 包装给 Agent 用。

一句话推荐结论

需要让你的 AI Agent 真实搜索和预订机票酒店？LetsFG 是目前最干净的 Agent-native 方案——MCP/CLI/SDK 三件套齐备，搜索无溢价无追踪，酒店 5% 订金+延迟付的模型对 Agent 非常友好；付费搜索价格合理，建议从本地 Connector 试用开始。

原始来源： - README: https://github.com/LetsFG/LetsFG（main 分支，2026-08-26） - MCP Server 文档: https://mcp.so/servers/letsfg - 开发者 API 文档: https://letsfg.co/developers/api/docs - Agent 接入说明: https://letsfg.co/for-agents

⚠️ 未确定处：Tempo 钱包 MPP 402 的具体接入方式（需持有 Tempo 钱包）、balance_due_by 字段的时区处理、各个国家/地区的酒店供应商覆盖率未披露。