google-flights-search
Search real flight prices and schedules from Google Flights via SearchAPI.io. Use when a user asks to find flights, check prices, compare options, or search around a date range. Always pipe results through the flight-scoring skill to rank before presenting, then ALWAYS save the search via the flight-price-monitor skill for automatic price tracking. Requires SEARCHAPI_KEY in .env.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/galdayan/google-flights-searchGoogle Flights Search
Fetch live flight data from Google Flights via SearchAPI.io, then score and rank results using the flight-scoring skill, then ALWAYS save the search via the flight-price-monitor skill for automatic price tracking.
Install
clawhub install google-flights-search
Requirements
- Python 3 — uses only stdlib (
urllib,json,argparse). No pip installs needed. - SearchAPI.io account — free tier includes 100 requests/month. Sign up here.
- SEARCHAPI_KEY — get your API key from SearchAPI.io after registering, then add it to
.envat the project root. OpenClaw loads it automatically.
Quick Reference
| Situation | Action |
|---|---|
| User asks for flights | Run search_searchapi.py, score results, then save via flight-price-monitor |
| Round-trip search | Add --return-date AND --top 5 to get return flight details |
| User says "around [date]" | Use --days 3 centered on that date |
| User says "cheapest in March" | Use --days 3 and pick a representative start date |
| Specific date | Use --days 1 (or --days 3 for ±1 flexibility) |
| Direct only | Add --stops 0 |
| Multi-passenger | Add --adults N |
Usage
# One-way search
python {baseDir}/scripts/search_searchapi.py \
--from TLV --to LON --date 2026-03-15 --days 3 --currency USD
# Round-trip with return flight details for top 5 (RECOMMENDED for round-trips)
python {baseDir}/scripts/search_searchapi.py \
--from TLV --to BKK --date 2026-03-28 --return-date 2026-04-14 --top 5
All Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
--from | Yes | — | Origin IATA code (e.g. TLV) |
--to | Yes | — | Destination IATA code (e.g. LON, LHR, LGW) |
--date | Yes | — | Outbound date YYYY-MM-DD |
--return-date | No | — | Return date YYYY-MM-DD (makes it a round-trip search) |
--days | No | 1 | Number of days to search forward from --date (max: 3) |
--currency | No | USD | Currency code (USD, EUR, ILS) |
--adults | No | 1 | Number of adult passengers |
--stops | No | any | 0 = direct only, 1 = up to 1 stop, 2 = up to 2 stops |
--class | No | economy | 1=economy, 2=premium_economy, 3=business, 4=first_class |
--top | No | — | Auto-fetch return flight details for top N outbound results. Use --top 5 for round-trips. |
--departure-token | No | — | Fetch return flights for a specific outbound (advanced, rarely needed directly) |
--booking-token | No | — | Fetch booking options (real airline/OTA URLs) for a specific flight using its booking_token |
Destination codes
Google Flights accepts:
- Airport codes:
LHR,CDG,TLV - City codes:
LON(all London airports),PAR(all Paris),NYC
Use city codes when the user hasn't specified a preferred airport.
Output Format
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-galdayan-google-flights-search": {
"enabled": true,
"auto_update": true
}
}
}