ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

LetsFG Python SDK教程:pip install letsfg,从搜索到拿到PNR的完整实战

LetsFG Python SDK教程:pip install letsfg,从搜索到拿到PNR的完整实战 LetsFG Python SDK教程pip install letsfg从搜索到拿到PNR的完整实战【免费下载链接】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/LetsFGLetsFG Python SDK 让你用一行pip install letsfg就能调用全球所有航司与主流订票网站免费搜索真实机票价格一路预订到拿到航空公司的 PNR。本教程面向新手带你从安装、获取令牌、搜索、筛选结果到最终出票完整走通整个流程无需任何爬虫经验。为什么选择 LetsFG Python SDK大多数机票工具要么只能查一个站点要么价格会因为你搜了几次而悄悄上涨。LetsFG 不一样覆盖全一次搜索同时查遍全球航空公司与主流 OTA返回一个总价你看到的价格就是最终扣款的价格没有隐藏手续费。价格稳定不跟踪、不涨价同一搜索反复运行结果一致。能真出票不只是比价还能真正预订——票价先在你的卡上锁定hold由 LetsFG 预订代理向卖家买票只有拿到真实航空 PNR 后才扣款预订失败则自动释放一分不扣。核心逻辑源码在 sdk/python/letsfg/client.py数据模型在 sdk/python/letsfg/models.py官方 README 见 sdk/python/README.md。一键安装pip install letsfg整个安装只需一条命令安装后即可使用命令行letsfg和 Python 包pip install letsfg官方入门文档在 docs/getting-started.md可直接查看快速上手与常见坑位。获取访问令牌一次性配置LetsFG 的搜索是免费的前提是先做一次一次性绑定绑卡不扣款卡信息交由 Revolut 处理不会传给 LetsFG。推荐用命令行一条命令完成letsfg auth它会打开浏览器让你在连接页面确认成功后把令牌写入~/.letsfg/config.json。SDK 会自动从LETSFG_BEARER_TOKEN环境变量或该配置文件里读取令牌之后无需再管。令牌约 1 小时过期内置 30 天刷新令牌会自动续期长驻进程无需手动处理。认证实现见 sdk/python/letsfg/connectors/auth.py。第一次机票搜索免费用 IATA 机场代码或城市代码如LON、NYC会自动展开该城市所有机场发起搜索from letsfg import LetsFG bt LetsFG() # 自动读取令牌 flights bt.search(LHR, BCN, 2026-06-15) print(flights.total_results, 个结果) print(最便宜:, flights.cheapest.summary())search()会返回一个FlightSearchResult对象常用字段字段含义flights.offers所有报价列表flights.cheapest最便宜的一条报价flights.total_results结果总数flights.search_id搜索 ID预订时必须带上flights.passenger_ids乘客 ID 列表搜索是免费的每张卡 10 次/10 分钟、30 次/小时、100 次/天轮询结果不计入额度。读懂搜索结果与快速筛选每条报价FlightOffer都带有航线、时长、停经次数、航司、退改条件等可直接遍历筛选# 只看直飞 direct [o for o in flights.offers if o.outbound.stopovers 0] # 按飞行时长排序 by_duration sorted(flights.offers, keylambda o: o.outbound.total_duration_seconds) for o in direct[:5]: print(o.price, o.currency, o.owner_airline, o.outbound.route_str)常用搜索参数在search()里传return_date返程日期、adults/children乘客数、cabin_class舱位M经济 /W超级经济 /C公务 /F头等、max_stopovers最大中转次数、sort按price或duration排序。更多字段说明见 docs/api-search.md。预订机票从价格锁定到出票选好报价后调用book()。预订会立刻返回一个订单号真正的买票在后台进行result bt.book( offer_idflights.cheapest.id, search_idflights.search_id, # 必须是产生该报价的那次搜索 passengers[{ given_name: John, family_name: Doe, born_on: 1990-01-15, gender: m, nationality: GB, phone_number: 447700900123, phone_country: GB, address_line1: 1 Analytical Way, address_city: London, address_postal: N1 9GU, address_country: GB, }], contact_emailjohnexample.com, )钱是怎么走的这是最安全的部分book()把票价在你的卡上锁定只是授权不扣款LetsFG 预订代理去卖家处买票约 4–11 分钟只有拿到真实航空 PNR 后才正式扣款若失败锁定自动释放一分不扣。关键同一趟行程在预订进行中不要再发起第二次预订否则会重复锁款。预订接口细节见 docs/api-booking.md。轮询订单状态拿到 PNR预订是异步的需要每 20–30 秒轮询一次直到进入终态。你可以用 SDK 的book_and_wait()一键完成下单 轮询它会自动处理到终态final bt.book_and_wait( offer_idflights.cheapest.id, search_idflights.search_id, passengers[...], # 同上 contact_emailjohnexample.com, ) print(final) # completed 时会带 pnr 与 charged_amount订单状态含义状态含义booking_in_progress代理正在卖家页面下单继续等completed出票成功返回pnr与charged_amountfailed未成功锁款已释放未扣款needs_attention有人在人工核查切勿重复预订常见错误与排查SDK 把所有错误统一为LetsFGError带error_code与is_retryable便于程序化判断异常场景建议BearerTokenError令牌缺失或失效重新执行letsfg authValidationError参数不合法IATA、日期等修正入参后重试OfferExpiredError报价已过期重新搜索再预订LetsFGError可重试限流 / 超时短暂退避后重试from letsfg import LetsFG, LetsFGError from letsfg.connectors.auth import BearerTokenError try: flights bt.search(LHR, JFK, 2026-04-15) except BearerTokenError: print(令牌缺失或已失效请重新运行 letsfg auth)云端搜索首次结果约 8–10 秒返回建议对限流/超时做指数退避重试。完整错误码与重试策略见 sdk/python/letsfg/client.py 与 docs/api-errors.md。进阶技巧与延伸阅读多日期比价搜索免费可对多个日期分别搜索、比较最便宜的一条再只对获胜日期下单避免盲目预订。Starlink 网络报价可能带starlink字段confirmed_all表示该机型已全部配备可放心向用户陈述。完整可运行示例参考 sdk/python/examples/quickstart.py。MCP 方式如果你用 Claude / Cursor / ChatGPT可把 LetsFG 作为 MCP 服务器接入直接对 AI 说帮我订一张最便宜的票。说明本文示例使用免费的 PFSBearer 令牌路径适合个人与 AI 代理register/connect-payment属于独立的付费 Developer API多数个人用户无需使用。按本文步骤你就能用pip install letsfg让脚本或 AI 代理完成搜索 → 筛选 → 预订 → 拿到 PNR的全链路。【免费下载链接】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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表