trvl — Google Flights + Hotels from your terminal
Free. No API keys. Real-time prices. One binary.
$ trvl flights HEL NRT 2026-06-15
Found 86 flights (one_way)
| Price | Duration | Stops | Route | Airline | Departs |
+----------+----------+---------+--------------------------+-----------------------+------------------+
| EUR 603 | 24h 20m | 2 stops | HEL -> CPH -> AUH -> NRT | Scandinavian Airlines | 2026-06-15T06:10 |
| EUR 656 | 24h 10m | 2 stops | HEL -> CPH -> AUH -> NRT | Finnair | 2026-06-15T06:20 |
| EUR 875 | 31h 20m | 1 stop | HEL -> IST -> NRT | Turkish Airlines | 2026-06-15T19:35 |
$ trvl hotels "Tokyo" --checkin 2026-06-15 --checkout 2026-06-18
Found 20 hotels:
| Name | Stars | Rating | Reviews | Price |
+-----------------------------------+-------+--------+---------+---------+
| HOTEL MYSTAYS PREMIER Omori | 4 | 4.1 | 2059 | 150 EUR |
| Hotel JAL City Tokyo Toyosu | 4 | 4.2 | 1080 | 150 EUR |
| Koko Hotel Tsukiji Ginza | 4 | 3.9 | 650 | 89 EUR |
Why trvl?
Google Flights and Hotels have no public API. Your options are $50+/mo SERP proxies or fragile Selenium scrapers.
trvl talks directly to Google's internal protocol — the same one the website uses. No scraping, no headless browsers, no API keys, no monthly fees. Just real-time travel data in a 15MB binary.
Inspired by fli by Punit Arani, which pioneered this for flights in Python. trvl extends it to hotels and ships as a single Go binary.
Install
go install github.com/MikkoParkkola/trvl/cmd/trvl@latest
Or grab a binary from Releases.
Or build from source:
git clone https://github.com/MikkoParkkola/trvl.git && cd trvl && make build
Flights
trvl flights JFK LHR 2026-07-01 # One-way
trvl flights HEL BCN 2026-07-01 --return 2026-07-08 # Round-trip
trvl flights JFK LHR 2026-07-01 --cabin business --stops nonstop # Filters
trvl flights HEL NRT 2026-06-15 --format json # JSON output
trvl flights HEL NRT 2026-06-15 --sort duration # Sort by duration
trvl flights HEL NRT 2026-06-15 --airline AY,SK # Filter airlines
Filters: --cabin (economy/premium_economy/business/first), --stops (any/nonstop/one_stop/two_plus), --sort (cheapest/duration/departure/arrival), --airline (comma-separated IATA codes)
Cheapest Dates
trvl dates HEL NRT --from 2026-06-01 --to 2026-06-30 # One-way
trvl dates HEL BCN --from 2026-07-01 --to 2026-08-31 --duration 7 --round-trip # Round-trip
Searches each date in parallel (3 concurrent) and returns the cheapest price per day. Great for flexible travel planning.
Hotels
trvl hotels "Helsinki" --checkin 2026-06-15 --checkout 2026-06-18
trvl hotels "Tokyo" --checkin 2026-06-15 --checkout 2026-06-18 --stars 4 --sort rating
trvl hotels "Paris" --checkin 2026-07-01 --checkout 2026-07-05 --format json
Filters: --stars (minimum 1-5), --guests (default 2), --sort (price/rating), --currency (USD/EUR/etc.)
Hotel Price Comparison
trvl prices "<hotel_id>" --checkin 2026-06-15 --checkout 2026-06-18
Compares prices across Booking.com, Hotels.com, Expedia, and other providers. hotel_id comes from hotel search results.
MCP Server — AI Agent Integration
trvl ships a built-in Model Context Protocol server (v2025-11-25) for seamless AI assistant integration.
trvl mcp # stdio (Claude Code, Cursor, Windsurf, etc.)
trvl mcp --http # HTTP transport (gateway, remote access)
Claude Code / Claude Desktop
{
"mcpServers": {
"trvl": {
"command": "trvl",
"args": ["mcp"]
}
}
}
MCP Features
| Feature |
Details |
| Tools |
search_flights, search_dates, search_hotels, hotel_prices |
| Prompts |
plan-trip, find-cheapest-dates, compare-hotels |
| Resources |
Airport codes (50 major), flight/hotel help guides |
| Elicitation |
Interactive forms for search refinement (dates, cabin, stars) |
| Structured content |
Typed JSON (structuredContent) + human summary with audience annotations |
| Progressive disclosure |
Suggestions for follow-up searches (round-trip, nonstop, flexible dates) |
| Output schemas |
Full JSON Schema validation for all tool responses |
mcp-gateway
backends:
trvl:
transport: stdio
command: trvl mcp
How It Works
Google's travel frontend uses an internal gRPC-over-HTTP protocol called batchexecute. trvl speaks this protocol natively:
- Chrome TLS fingerprint — utls impersonates Chrome's exact TLS ClientHello to pass bot detection
- Flights —
FlightsFrontendService/GetShoppingResults with encoded filter arrays
- Hotels —
TravelFrontendUi embedded JSON parsing from AF_initDataCallback blocks
- Hotel prices —
TravelFrontendUi/data/batchexecute with rpcid yY52ce
- Rate limiting — 10 req/s token bucket with exponential backoff (1s/2s/4s) on 429/5xx
No Selenium. No Puppeteer. No browser. Just HTTP.
Features at a Glance
|
|
| Binary |
Single static 15MB binary. Zero runtime dependencies. |
| Data |
Real-time from Google Flights + Google Hotels |
| Auth |
None required. No API keys, no accounts, no tokens. |
| Output |
Pretty tables (default) or JSON (--format json) |
| MCP |
Full v2025-11-25 with elicitation, structured content, prompts |
| Platforms |
Linux, macOS (amd64, arm64) |
| Language |
Go 1.24+, pure Go, no CGO |
| Tests |
325 test functions, race-detector clean |
| License |
MIT |
Attribution
This project stands on the shoulders of:
- fli by Punit Arani — the original Google Flights reverse-engineering library.
trvl's flight search is a direct Go reimplementation of fli's approach.
- utls by Refraction Networking — Chrome TLS fingerprint impersonation
- icecreamsoft — Google Hotels batchexecute documentation
- SerpAPI — Hotel parameter reference documentation
Legal
trvl accesses Google's public-facing internal APIs. It does not bypass authentication, access protected content, or circumvent rate limits. This is the same approach used by fli (1K+ GitHub stars, actively maintained, MIT licensed).
Use responsibly. Respect rate limits.
License
MIT