企业官网建设流程全解析

LetsFG酒店预订指南：一个凭证订机票+酒店，比Booking.com更便宜的完整教程

【免费下载链接】LetsFGAgent-native flight & hotel search and booking — MCP server, CLI, and Python/JS SDKs. Every airline in the world, major booking sites and OTAs, with per-flight reliability history.项目地址: https://gitcode.com/gh_mirrors/le/LetsFG

LetsFG 是一款面向 AI Agent 的机票与酒店预订平台，覆盖全球航空公司与各大订房渠道，提供 MCP 服务器、CLI 和 Python/JS 双语言 SDK。它的酒店预订功能已正式上线——一个凭证同时预订机票和酒店，在真实比价中比 Booking.com 更便宜。本文用 3 个步骤带你完成从"连接凭证"到"订下房间"的完整流程，新手也能一次看懂。

一、LetsFG 真的比 Booking.com 便宜吗？

官方在 2026-08-05 做了同日、同酒店、同房型、同取消政策的实测对比：

📊 3 家酒店合计便宜$207（同一日验证）。

便宜的逻辑很简单：LetsFG 的价格不随搜索次数上涨（没有 cookie 追踪和动态加价），且展示的就是你要付的全包价，结账时不加收任何"预订服务费"（传统 OTA 通常还有约 3% 的费用）。机票侧同理，官方 5 条航线对比 Google Flights 合计便宜 $133。

二、一个凭证两用：LetsFG 预订的核心设计

LetsFG 最大的设计亮点是：同一张绑定的卡，同时授权机票和酒店。

• 凭证形式：连接后获得的 card-backed 令牌（Bearer Token），或 Developer API Key，二者任选其一，酒店端点全部通用；
• 绑卡零费用：绑卡走 0.00 的 Revolut 流程，任何卡都支持，不产生任何扣款，卡信息只传给 Revolut；
• ⚠️酒店搜索也需要卡：酒店搜索会在供应商侧打开真实会话、锁定价，所以没有支付方式时所有酒店接口直接返回402——宁可提前拒绝，也不让你到付钱那一刻才发现付不了；
• SDK 版本要求：酒店预订需要 Python SDK ≥ 2026.5.101、JS SDK ≥ 2026.5.74、MCP ≥ 2026.5.77，旧版本会因已废弃的字段被 API 拒绝，升级命令见 docs/hotels.md。

三、三步快速上手：从连接凭证到订下房间

第 1 步：连接 LetsFG MCP 服务器

在 Claude、Cursor、Windsurf 等支持远程 MCP 的客户端里，把 MCP 服务器地址https://letsfg.co/developers/api/mcp添加为自定义连接器，名称填LetsFG，点Connect后在打开的确认页点Approve即可——一键完成，无需注册表单。

第 2 步：绑定一次支付卡（$0.00，不扣款）

首次需要支付时会引导你绑卡。这一步是酒店搜索的前置条件，绑定后搜索完全免费。

第 3 步：用自然语言订酒店

连接完成后，直接对 AI 说：

"帮我在巴塞罗那找 11 月 10 日到 12 日住两晚的酒店，2 个成人"

Agent 会按这条工具链自动完成：

resolve_hotel_city → search_hotels → book_hotel → get_hotel_booking → cancel_hotel_booking

• search_hotels返回可真实预订的房间：price（客人实付价）、refundable（是否可退）、free_cancellation_until（免费取消截止日）等字段齐全；
• 价格默认以 USD 报价，也可以指定 EUR、GBP 等币种，展示价即实付价。

💡 不想用 AI 客户端？安装 CLI 后在终端运行letsfg auth走同样的连接流程，令牌会写入本地配置文件，后续 CLI 和 SDK 直接复用。

四、钱的走向：先冻结，酒店确认后才扣款

LetsFG 的扣款机制和机票完全一致，这是它比 OTA 更让人安心的原因：

没有任何"预订费、定金或支付链接"：预订成功后客人不再欠酒店一分钱。

搜索成本：每次成功预订酒店后送 1,000 次免费搜索，超出后按 1,000 次 $5.00 从预付余额扣，个人使用基本免费。

五、异步预订：4 种状态与一条铁律

酒店预订不是即时完成的——供应商要重新锁价、确认房间、结算，通常要几分钟。book_hotel返回的是booking_job_id（任务 ID），之后轮询任务状态：

⚠️铁律：任务运行期间绝不重复下单，只轮询。相同幂等键重试只会返回原任务，换个新键等于重新订房、扣两次钱。

六、给开发者：10 行 Python 订一间房

装了 SDK 之后（pip install -U letsfg），核心流程非常短：

from letsfg import LetsFG lfg = LetsFG() 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, offer = stays["hotels"][0], stays["hotels"][0]["offers"][0] 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"}, {"title": "Ms", "first_name": "Anna", "last_name": "Kowalska"}], email="guest@example.com", phone="512345678", )

两个容易踩的坑：

• 价格字段必须原样回传：expected_price、expected_cost、currency、fx_rate要照抄搜索返回的值，供应商价格一变就会被price_mismatch拒绝——这保证客人永远不会被扣一个没确认过的价格；
• 一位客人一个名字：guests里要列出房间内所有人（含儿童，顺序与搜索时一致），名字少于人数会直接失败并释放冻结。

完整字段说明见 docs/hotels.md 和 skills/hotel-search/SKILL.md，Python 客户端实现可查看 sdk/python/letsfg/client.py，MCP 工具实现可查看 sdk/mcp/src/index.ts。

七、取消政策：退与不退，下单前就看明白

每个报价都带refundable（是否可退）和free_cancellation_until（免费取消截止日）两个字段——不可退的通常是最低价，这就是取舍，订前一定看清。

• 可退订单在截止日前取消：退 98%（2% 为不可退的支付成本），响应里会给出精确的退款额和手续费；
• 已过截止日或不可退价：按酒店自己的阶梯收费（可能高达 100%），完整阶梯随预订的terms字段返回，接口会拒绝而不是擅自替客人扣款；
• 💡 取消流程会真实操作供应商页面，耗时 1 分钟以上，超时不代表失败，先复查再重试。

八、新手避坑清单

总结

LetsFG 把"订机票"和"订酒店"收敛到了同一个凭证、同一套扣款机制之下：搜索免费、价格不追踪不涨价、冻结后才扣款、失败零扣款。对新手，用 AI 客户端接上 MCP 后一句话就能订房；对开发者，Python/JS SDK 十几行代码即可接入。比 Booking.com 便宜 $207/3 晚不是营销话术，而是同日同房间的可验证结果。

延伸阅读：

• 酒店 API 完整文档：docs/hotels.md
• 酒店搜索技能说明：skills/hotel-search/SKILL.md
• Claude 5 分钟快速上手：docs/quickstart-claude.md
• 入门总览：docs/getting-started.md

【免费下载链接】LetsFGAgent-native flight & hotel search and booking — MCP server, CLI, and Python/JS SDKs. Every airline in the world, major booking sites and OTAs, with per-flight reliability history.项目地址: https://gitcode.com/gh_mirrors/le/LetsFG