用途：google-flight 用一次确定性 HTTP GET 请求访问 Google Flights 搜索端点，解析返回 HTML 中内嵌的 JSON，快速获得航班价格，避免浏览器自动化（开标签页、等待渲染、点击下拉、滚动日历、截图验证）带来的耗时与内存开销。无需浏览器进程、CSS 布局或截图。
主要能力：支持单程与往返查询（往返输出的是「去程选项＋总价」，不解析具体回程班次）；按 IATA 机场代码、出发日期、可选返回日期、成人人数（1–9）、币种（约 70 种）、经停数（客户端过滤）、去程/到达时间窗（支持跨午夜，如 22:00-04:00）筛选；输出格式可选 json 或 table，并可按价格升序限制结果数量。脚本通过 PEP 723 内联依赖（fast-flights、typing_extensions），首次运行时由 uv 在临时环境安装。
必要用法：uv run scripts/search_flights.py --from TPE --to MAD --depart 2026-10-22 --return 2026-10-31 --currency TWD。--depart 必填且为严格 YYYY-MM-DD；--from/--to 须为 3 位机场代码且不相同；--return 不能早于 --depart；--adults 1–9；--currency 需在库支持的币种内；--max-stops 须 >= 0；--limit 须 >= 1。成功退出码为 0 并输出结果，失败则以 JSON {"error": ...} 输出到 stdout/stderr 并以非零退出——需检查退出码。
适用场景：快速估算某航线某日期区间的票价，或为后续需要浏览器工具确认回程/下单的流程提供首轮价格参考。
限制：只读，不能预订、填写乘客信息或付款。往返价格仅为第一步估算，需用浏览器工具确认具体回程。解析依赖未公开且不稳定的 tfs protobuf 参数，Google 可能随时改变结构；脚本通过 monkey-patch 缓解整批解析失败，并逐条跳过缺数据的行程，但仍可能有个别航线或日期在补丁后无法解析，此时应改用浏览器工具。结果与登录 Chrome 所见不同，Google 会按会话、Cookie、语言、IP 个性化，建议多来源取样取较低值。输入校验在调用库前完成，因为库对畸形日期会静默解析为错误日期而非报错。
（官方说明未提供更多细节，价格、平台、效果等未提及内容暂未提供。）