Find Flights

Aggregate flight search across multiple sites, then return a small ranked set of actionable options.

Default sources (in order)

1) Google Flights (best for date-grid + fast constraint filtering) 2) Kayak (good cross-check; sometimes different OTA combos) 3) Skyscanner (good for flexible dates + alternate airports)

When any site becomes automation-hostile (consent/CAPTCHA), switch to Chrome relay per web-driving.

Inputs to confirm

• Origin airport(s)
• Destination priority list (primary + acceptable alternates)
• Constraint level:
  • Stops: nonstop only vs allow 1 stop fallback
  • Baggage/carry-on needs
  • Time-of-day preferences (optional)
• Date framing:
  • Holiday window (if relevant) + flexibility
  • Trip length: target days + allowed range (e.g., 12 days, can stretch to 17)

Workflow

1) Define the search windows

If the user gives a holiday (e.g., Passover), translate that into:

• Depart window (arrive before key day)
• Return window (after key day)
• Expand by ±3 days by default if user is price-driven

2) Run searches

For each destination in priority order:

A. Google Flights

• Apply constraints (stops)
• Use Date grid / Price graph to find the minimum price region
• Capture 3–5 best date pairs

B. Kayak

• Same constraints
• Validate the top 1–2 date pairs and look for any cheaper alternatives

C. Skyscanner

• Use flexible date/month view if needed
• Cross-check for lower fares or better timing

Mechanics: follow the web-driving skill for browser automation, screenshots, and robust clicking.

3) Normalize + rank

Rank options by: 1) Total price 2) Stops (prefer fewer) 3) Total travel time 4) Departure/arrival sanity (avoid brutal red-eyes unless cheapest by a lot)

4) Return results

Provide:

• Top 3–5 options as bullets: dates, price, stops, airline(s), notes (bags, overnight, etc.)
• Links:
  • Google Flights share link for the best option
  • Kayak/Skyscanner links if they differ materially
• Recommendation: set price alerts for top 1–2 date pairs

References

• Use ../web-driving/SKILL.md for the automation playbook (profiles, aria snapshots, screenshot-based extraction).
• Site-specific tips:
  • references/google-flights.md
  • references/kayak.md
  • references/skyscanner.md