URL 模板

https://www.google.com/travel/flights?q=Flights+from+{ORIGIN}+to+{DEST}+on+{DATE}[+returning+{DATE}][+one+way][+business+class][+N+passengers]

默认：经济舱 + 商务舱比较

始终并行运行两个会话 — 经济舱和商务舱 — 以显示价格差异。由于两者同时加载，这不会增加额外时间。

# 并行启动两者（将第一个放入后台）
agent-browser --session econ open "https://www.google.com/travel/flights?q=Flights+from+BKK+to+NRT+on+2026-03-20+returning+2026-03-27" &
agent-browser --session biz open "https://www.google.com/travel/flights?q=Flights+from+BKK+to+NRT+on+2026-03-20+returning+2026-03-27+business+class" &
wait

# 等待两者加载完成
agent-browser --session econ wait --load networkidle &
agent-browser --session biz wait --load networkidle &
wait

# 为两者创建快照
agent-browser --session econ snapshot -i
agent-browser --session biz snapshot -i

# 关闭 biz 会话（仅用于价格差异列）；保持 econ 会话存活以获取预订链接
agent-browser --session biz close

然后以紧凑列表格式呈现结果（见下文输出格式部分）。

匹配逻辑：通过航空公司名称和起飞时间匹配航班。并非所有经济舱航班都有对应的商务舱航班（例如 ZIPAIR、Air Japan 等廉价航空公司不提供商务舱）。当没有商务舱匹配项时显示 "—"。

提示：当某家航空公司出现在商务舱结果中但未出现在经济舱结果中时（例如菲律宾航空），可能意味着该航线仅提供商务舱定价。在结果中包含该航班，经济舱价格显示为 "—"。

单程航班与商务舱差价

模式相同 — 只需在两个 URL 中都添加 +one+way：

agent-browser --session econ open "https://www.google.com/travel/flights?q=Flights+from+LAX+to+LHR+on+2026-04-15+one+way" &
agent-browser --session biz open "https://www.google.com/travel/flights?q=Flights+from+LAX+to+LHR+on+2026-04-15+one+way+business+class" &
wait

当用户仅要求商务舱时

如果用户明确要求商务舱（而非比较），则仅运行商务舱会话：

agent-browser --session flights open "https://www.google.com/travel/flights?q=Flights+from+JFK+to+CDG+on+2026-06-01+returning+2026-06-15+business+class"
agent-browser --session flights wait --load networkidle
agent-browser --session flights snapshot -i
# 保持会话存活以获取预订链接

头等舱 / 多名乘客

agent-browser --session flights open "https://www.google.com/travel/flights?q=Flights+from+JFK+to+CDG+on+2026-06-01+returning+2026-06-15+first+class+2+adults+1+child"
agent-browser --session flights wait --load networkidle
agent-browser --session flights snapshot -i
# 保持会话存活以获取预订链接

通过 URL 可实现的功能

需要交互式备用方案的情况

• 超级经济舱 舱位等级
• 多城市 行程（3 段或以上航程）
• 婴儿乘客（占座与不占座的区别）
• URL 未加载结果（同意横幅、验证码、区域设置问题）

从快照读取结果

每个航班显示为一个带有完整描述的 link 元素：

link "From 20508 Thai baht round trip total. Nonstop flight with Air Japan.
     Leaves Suvarnabhumi Airport at 12:10 AM on Friday, March 20 and arrives
     at Narita International Airport at 8:15 AM on Friday, March 20.
     Total duration 6 hr 5 min. Select flight"

将经济舱和商务舱快照解析为紧凑列表格式：

1. JAL — Nonstop · 5h 55m
   8:05 AM → 4:00 PM
   Economy: THB 23,255 · Business: THB 65,915 (+183%)

2. THAI — Nonstop · 5h 50m
   10:30 PM → 6:20 AM+1
   Economy: THB 28,165 · Business: THB 75,000 (+166%)

3. Air Japan — Nonstop · 6h 05m
   12:10 AM → 8:15 AM
   Economy: THB 20,515 · Business: —

4. ZIPAIR — Nonstop · 5h 45m
   11:45 PM → 7:30 AM+1
   Economy: THB 21,425 · Business: —

匹配：通过航空公司 + 起飞时间配对经济舱和商务舱结果。没有商务舱的廉价航空公司显示 "—"。如果 Google 显示 "最佳"/"最便宜" 标签，请一并包含。

预订选项交接

呈现结果表格后，务必提供预订链接："需要这些航班的预订链接吗？请告诉我您选择哪一个。"

当用户选择某个航班后，通过点击快照中该航班的 link 元素来提取预订选项。Google Flights 会显示一个包含预订提供商（航空公司、在线旅行社）的面板，每个提供商都有价格和指向预订网站的 "继续" 链接。

工作流程

# 用户选择航班 #N — 点击结果快照中对应的链接
agent-browser --session econ click @eN
agent-browser --session econ wait 3000
agent-browser --session econ snapshot -i

预订面板快照将显示如下 link 元素：

link "Book with Emirates THB 28,960" → href="https://..."
link "Book with Booking.com THB 29,512" → href="https://..."
link "Book with Teaflight THB 28,171" → href="https://..."

从每个链接中提取提供商名称、价格和 href URL。

输出格式

📋 Booking Options for JAL BKK→NRT (5h 55m, Nonstop)

| Provider | Price | Book |
|----------|-------|------|
| Emirates | THB 28,960 | [Continue](https://...) |
| Booking.com | THB 29,512 | [Continue](https://...) |
| Teaflight | THB 28,171 | [Continue](https://...) |

注意事项

• 会话生命周期：保持结果会话存活以获取预订链接；--session biz 在获取结果后立即关闭（仅用于价格差异）。在用户获取预订链接或拒绝后，关闭结果会话。
• 如果预订面板未能加载：重新创建快照，等待更长时间后重试。

交互式工作流程（备用方案）

用于多城市、超级经济舱或 URL 路径失败的情况。

打开并创建快照

agent-browser --session flights open "https://www.google.com/travel/flights"
agent-browser --session flights wait 3000
agent-browser --session flights snapshot -i

如果出现同意横幅，请先点击 "全部接受" 或 "全部拒绝"。

设置行程类型（如果不是往返）

agent-browser --session flights click @eN   # 行程类型组合框（"往返"）
agent-browser --session flights snapshot -i
agent-browser --session flights click @eN   # "单程" 或 "多城市"
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i

设置舱位等级 / 乘客（如果非默认）

舱位等级：

agent-browser --session flights click @eN   # 舱位等级组合框
agent-browser --session flights snapshot -i
agent-browser --session flights click @eN   # 选择舱位等级
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i

乘客：

agent-browser --session flights click @eN   # 乘客按钮
agent-browser --session flights snapshot -i
agent-browser --session flights click @eN   # 点击 "+" 增加成人/儿童/婴儿数量
agent-browser --session flights snapshot -i
agent-browser --session flights click @eN   # "完成"
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i

输入机场（出发地或目的地）

agent-browser --session flights click @eN   # 组合框字段
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i
agent-browser --session flights fill @eN "BKK"
agent-browser --session flights wait 2000   # 关键：等待自动补全
agent-browser --session flights snapshot -i
agent-browser --session flights click @eN   # 点击建议项（切勿按 Enter 键）
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i

设置日期

agent-browser --session flights click @eN   # 日期文本框
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i
# 日历将日期显示为按钮："Friday, March 20, 2026"
agent-browser --session flights click @eN   # 点击目标日期
agent-browser --session flights wait 500
agent-browser --session flights snapshot -i
# 点击 "完成" 关闭日历
agent-browser --session flights click @eN   # "完成" 按钮
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i

搜索

"完成" 仅关闭日历。您必须单独点击 "搜索"。

agent-browser --session flights click @eN   # "搜索" 按钮
agent-browser --session flights wait --load networkidle
agent-browser --session flights snapshot -i
# 保持会话存活以获取预订链接

多城市特定操作

选择 "多城市" 行程类型后，表单会为每个航段显示一行：

• 每个航段包含：出发地组合框、目的地组合框、出发日期文本框
• 出发地自动填充为上一航段的目的地
• 点击 "添加航班" 以添加更多航段（默认显示 2 个航段）
• 点击 "Remove flight from X to Y" 按钮以移除航段
• 结果显示第一航段的航班，价格反映多城市总费用

按顺序填写每个航段的目的地和日期，然后点击 "搜索"。

输出格式

始终使用紧凑列表格式 — 切勿使用 Markdown 表格。输出通常显示在聊天机器人界面（Telegram 等）中，这些界面表格渲染效果不佳。

经济舱 + 商务舱比较（默认）

1. JAL — Nonstop · 5h 55m
   8:05 AM → 4:00 PM
   Economy: THB 23,255 · Business: THB 65,915 (+183%)

2. THAI — Nonstop · 5h 50m
   10:30 PM → 6:20 AM+1
   Economy: THB 28,165 · Business: THB 75,000 (+166%)

3. Air Japan — Nonstop · 6h 05m
   12:10 AM → 8:15 AM
   Economy: THB 20,515 · Business: —

仅经济舱

1. JAL — Nonstop · 5h 55m
   8:05 AM → 4:00 PM · THB 23,255

2. THAI — Nonstop · 5h 50m
   10:30 PM → 6:20 AM+1 · THB 28,165

格式规则

• 每个编号块对应一个航班，航班间用空行分隔
• 第 1 行：航空公司 — 经停次数 · 时长
• 第 2 行：起飞 → 到达时间
• 第 3 行：价格（经济舱，商务舱差价如适用）
• 航班列表周围不要使用代码块 — 纯文本阅读体验最佳
• 将 "最佳价值" 推荐作为列表后的纯文本段落保留

关键规则

故障排除

同意弹窗：在快照中点击 "全部接受" 或 "全部拒绝"。

URL 快速路径无效：回退到交互式流程。某些地区/区域设置处理 ?q= 的方式不同。

无结果：检查机场（检查组合框标签）、日期是否为未来日期，或等待更长时间。

机器人检测 / 验证码：通知用户。不要解决验证码。稍等片刻后重试。

深入参考

请参阅 references/interaction-patterns.md 了解：

• 完整带注释的演练（每条命令 + 预期输出）
• 机场自动补全的失败模式及恢复方法
• 日期选择器日历导航
• 多城市搜索
• 滚动查看更多结果

每周安装次数

443

代码仓库

skillhq/flight-search

首次出现

2026 年 2 月 9 日

安全审计

Gen Agent Trust HubPassSocketPassSnykWarn

安装于

gemini-cli421

codex420

github-copilot419

opencode418

kimi-cli417

amp417

Fast Path: URL-Based Search (Preferred)

Construct a URL with a natural language ?q= parameter. Loads results directly — 3 commands total.

URL Template

https://www.google.com/travel/flights?q=Flights+from+{ORIGIN}+to+{DEST}+on+{DATE}[+returning+{DATE}][+one+way][+business+class][+N+passengers]

Default: Economy + Business Comparison

Always run two parallel sessions — economy and business — to show the price delta. This adds no extra time since both load concurrently.

# Launch both in parallel (background the first)
agent-browser --session econ open "https://www.google.com/travel/flights?q=Flights+from+BKK+to+NRT+on+2026-03-20+returning+2026-03-27" &
agent-browser --session biz open "https://www.google.com/travel/flights?q=Flights+from+BKK+to+NRT+on+2026-03-20+returning+2026-03-27+business+class" &
wait

# Wait for both to load
agent-browser --session econ wait --load networkidle &
agent-browser --session biz wait --load networkidle &
wait

# Snapshot both
agent-browser --session econ snapshot -i
agent-browser --session biz snapshot -i

# Close biz (only needed for delta column); keep econ alive for booking links
agent-browser --session biz close

Then present results in compact list format (see Output Format section below).

Matching logic : Match flights by airline name and departure time. Not all economy flights have a business equivalent (budget carriers like ZIPAIR, Air Japan don't offer business). Show "—" when no business match exists.

Tip : When an airline appears in business results but not economy (e.g., Philippine Airlines), it may operate business-only pricing on that route. Include it with "—" for economy.

One Way with Business Delta

Same pattern — just add +one+way to both URLs:

agent-browser --session econ open "https://www.google.com/travel/flights?q=Flights+from+LAX+to+LHR+on+2026-04-15+one+way" &
agent-browser --session biz open "https://www.google.com/travel/flights?q=Flights+from+LAX+to+LHR+on+2026-04-15+one+way+business+class" &
wait

When User Asks for Business Only

If the user specifically asks for business class (not a comparison), run just the business session:

agent-browser --session flights open "https://www.google.com/travel/flights?q=Flights+from+JFK+to+CDG+on+2026-06-01+returning+2026-06-15+business+class"
agent-browser --session flights wait --load networkidle
agent-browser --session flights snapshot -i
# Keep session alive for booking links

First Class / Multiple Passengers

agent-browser --session flights open "https://www.google.com/travel/flights?q=Flights+from+JFK+to+CDG+on+2026-06-01+returning+2026-06-15+first+class+2+adults+1+child"
agent-browser --session flights wait --load networkidle
agent-browser --session flights snapshot -i
# Keep session alive for booking links

What Works via URL

What Requires Interactive Fallback

• Premium economy cabin class
• Multi-city trips (3+ legs)
• Infant passengers (seat vs lap distinction)
• URL didn't load results (consent banner, CAPTCHA, locale issue)

Reading Results from Snapshot

Each flight appears as a link element with a full description:

link "From 20508 Thai baht round trip total. Nonstop flight with Air Japan.
     Leaves Suvarnabhumi Airport at 12:10 AM on Friday, March 20 and arrives
     at Narita International Airport at 8:15 AM on Friday, March 20.
     Total duration 6 hr 5 min. Select flight"

Parse economy + business snapshots into the compact list format :

1. JAL — Nonstop · 5h 55m
   8:05 AM → 4:00 PM
   Economy: THB 23,255 · Business: THB 65,915 (+183%)

2. THAI — Nonstop · 5h 50m
   10:30 PM → 6:20 AM+1
   Economy: THB 28,165 · Business: THB 75,000 (+166%)

3. Air Japan — Nonstop · 6h 05m
   12:10 AM → 8:15 AM
   Economy: THB 20,515 · Business: —

4. ZIPAIR — Nonstop · 5h 45m
   11:45 PM → 7:30 AM+1
   Economy: THB 21,425 · Business: —

Matching : Pair economy and business results by airline + departure time. Budget carriers without business class show "—". Include "Best"/"Cheapest" labels from Google when present.

Booking Options Handoff

After presenting the results table, always offer booking links : "Want booking links for any of these? Just say which one."

When the user picks a flight, extract booking options by clicking the flight's link element in the snapshot. Google Flights shows a panel with booking providers (airlines, OTAs) each with a price and a "Continue" link to the booking site.

Workflow

# User picks flight #N — click the corresponding link from the results snapshot
agent-browser --session econ click @eN
agent-browser --session econ wait 3000
agent-browser --session econ snapshot -i

The booking panel snapshot will show link elements like:

link "Book with Emirates THB 28,960" → href="https://..."
link "Book with Booking.com THB 29,512" → href="https://..."
link "Book with Teaflight THB 28,171" → href="https://..."

Extract the provider name, price, and href URL from each link.

Output Format

📋 Booking Options for JAL BKK→NRT (5h 55m, Nonstop)

| Provider | Price | Book |
|----------|-------|------|
| Emirates | THB 28,960 | [Continue](https://...) |
| Booking.com | THB 29,512 | [Continue](https://...) |
| Teaflight | THB 28,171 | [Continue](https://...) |

Notes

• Session lifecycle : Keep the results session alive for booking links; close --session biz immediately (only needed for delta). Close the results session after the user gets booking links or declines.
• If booking panel fails to load : Re-snapshot and wait longer before retrying.

Interactive Workflow (Fallback)

Use for multi-city, premium economy, or when the URL path fails.

Open and Snapshot

agent-browser --session flights open "https://www.google.com/travel/flights"
agent-browser --session flights wait 3000
agent-browser --session flights snapshot -i

If a consent banner appears, click "Accept all" or "Reject all" first.

Set Trip Type (if not Round Trip)

agent-browser --session flights click @eN   # Trip type combobox ("Round trip")
agent-browser --session flights snapshot -i
agent-browser --session flights click @eN   # "One way" or "Multi-city"
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i

Set Cabin Class / Passengers (if non-default)

Cabin class:

agent-browser --session flights click @eN   # Cabin class combobox
agent-browser --session flights snapshot -i
agent-browser --session flights click @eN   # Select class
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i

Passengers:

agent-browser --session flights click @eN   # Passengers button
agent-browser --session flights snapshot -i
agent-browser --session flights click @eN   # "+" for Adults/Children/Infants
agent-browser --session flights snapshot -i
agent-browser --session flights click @eN   # "Done"
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i

Enter Airport (Origin or Destination)

agent-browser --session flights click @eN   # Combobox field
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i
agent-browser --session flights fill @eN "BKK"
agent-browser --session flights wait 2000   # CRITICAL: wait for autocomplete
agent-browser --session flights snapshot -i
agent-browser --session flights click @eN   # Click suggestion (NEVER press Enter)
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i

Set Dates

agent-browser --session flights click @eN   # Date textbox
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i
# Calendar shows dates as buttons: "Friday, March 20, 2026"
agent-browser --session flights click @eN   # Click target date
agent-browser --session flights wait 500
agent-browser --session flights snapshot -i
# Click "Done" to close calendar
agent-browser --session flights click @eN   # "Done" button
agent-browser --session flights wait 1000
agent-browser --session flights snapshot -i

Search

"Done" only closes the calendar. You MUST click "Search" separately.

agent-browser --session flights click @eN   # "Search" button
agent-browser --session flights wait --load networkidle
agent-browser --session flights snapshot -i
# Keep session alive for booking links

Multi-City Specifics

After selecting "Multi-city" trip type, the form shows one row per leg:

• Each leg has: origin combobox, destination combobox, departure date textbox
• Origins auto-fill from the previous leg's destination
• Click "Add flight" to add more legs (default: 2 legs shown)
• Click "Remove flight from X to Y" buttons to remove legs
• Results show flights for the first leg , with prices reflecting the total multi-city cost

Fill each leg's destination + date in order, then click "Search".

Output Format

Always use compact list format — never markdown tables. Output is typically displayed in chatbot interfaces (Telegram, etc.) where tables render poorly.

Economy + Business comparison (default)

1. JAL — Nonstop · 5h 55m
   8:05 AM → 4:00 PM
   Economy: THB 23,255 · Business: THB 65,915 (+183%)

2. THAI — Nonstop · 5h 50m
   10:30 PM → 6:20 AM+1
   Economy: THB 28,165 · Business: THB 75,000 (+166%)

3. Air Japan — Nonstop · 6h 05m
   12:10 AM → 8:15 AM
   Economy: THB 20,515 · Business: —

Economy only

1. JAL — Nonstop · 5h 55m
   8:05 AM → 4:00 PM · THB 23,255

2. THAI — Nonstop · 5h 50m
   10:30 PM → 6:20 AM+1 · THB 28,165

Format rules

• One flight per numbered block, blank line between flights
• Line 1: Airline — Stops · Duration
• Line 2: Departure → Arrival times
• Line 3: Prices (economy, business delta if applicable)
• No code blocks around the flight list — plain text reads best
• Keep the "Best value" recommendation as a plain text paragraph after the list

Key Rules

Troubleshooting

Consent popups : Click "Accept all" or "Reject all" in the snapshot.

URL fast path didn't work : Fall back to interactive. Some regions/locales handle ?q= differently.

No results : Verify airports (check combobox labels), dates in the future, or wait longer.

Bot detection / CAPTCHA : Inform user. Do NOT solve CAPTCHAs. Retry after a short wait.

Deep-Dive Reference

See references/interaction-patterns.md for:

• Full annotated walkthrough (every command + expected output)
• Airport autocomplete failure modes and recovery
• Date picker calendar navigation
• Multi-city searches
• Scrolling for more results

Weekly Installs

443

Repository

skillhq/flight-search

First Seen

Feb 9, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykWarn

Installed on

gemini-cli421

codex420

github-copilot419

opencode418

kimi-cli417

amp417