Menu
Fast flight and hotel search via FGP daemon (Kiwi/Xotelo APIs)
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | travel-fgp |
| description | Fast flight and hotel search via FGP daemon (Kiwi/Xotelo APIs) |
| tools | ["Bash"] |
| triggers | ["flight","flights","hotel","hotels","travel","airfare","book a trip","find flights","cheapest flight","airport"] |
Fast flight and hotel search using the FGP daemon protocol. Token-optimized responses for efficient LLM interactions.
fgp start travel or build with cargo build --release| Method | Description | Tokens |
|---|---|---|
travel.find_location | Search airports/cities (instant, local DB) | 90-700 |
travel.search_flights | One-way flight search | 500-3,500 |
travel.search_roundtrip | Round-trip flight search | 600-6,000 |
travel.search_hotels | Hotel search by city | 750-1,500 |
travel.hotel_rates | Real-time hotel rates | 200-800 |
| Method | Description | Token Savings |
|---|---|---|
travel.price_check | Ultra-light price check (~55 tokens) | 10x vs search_flights |
travel.search_cheapest_day | Find cheapest day in date range | 30x for month search |
travel.search_cheapest_route | Find cheapest destination | 5x vs N searches |
travel.search_flexible_dates | Search ±N days around date | 7x vs N searches |
travel.search_direct_only | Non-stop flights only | 2-3x (fewer segments) |
travel.batch_search | Multiple searches in one call | Reduces overhead |
Instant lookup from local database (7,988 locations). No API call required.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
term | string | Yes | - | Search term (airport code, city name) |
limit | integer | No | 10 | Maximum results |
fgp call travel.find_location -p '{"term": "SFO"}'
fgp call travel.find_location -p '{"term": "San Francisco", "limit": 5}'
Response: (~70 tokens/location)
{
"locations": [
{
"id": "SFO",
"name": "San Francisco International",
"city": "San Francisco",
"country": "US",
"type": "airport"
}
],
"count": 1
}
Get just the price without flight details. 10x more token-efficient than search_flights.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
origin | string | Yes | Origin airport code |
destination | string | Yes | Destination airport code |
date | string | Yes | Departure date (YYYY-MM-DD) |
fgp call travel.price_check -p '{"origin": "SFO", "destination": "LAX", "date": "2026-02-15"}'
Response: (~55 tokens)
{
"origin": "SFO",
"destination": "LAX",
"date": "2026-02-15",
"price": 83.0,
"stops": 0
}
Full flight search with airline, times, and segment details.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
origin | string | Yes | - | Origin airport code |
destination | string | Yes | - | Destination airport code |
departure_from | string | Yes | - | Departure date (YYYY-MM-DD) |
departure_to | string | No | same as from | Date range end |
limit | integer | No | 5 | Maximum results |
fgp call travel.search_flights -p '{"origin": "SFO", "destination": "BER", "departure_from": "2026-02-15", "limit": 5}'
Response: (~500 tokens/flight)
{
"flights": [
{
"id": "abc123",
"price": 450.0,
"currency": "USD",
"departure": "2026-02-15T08:00:00",
"arrival": "2026-02-16T06:30:00",
"duration_hours": 14.5,
"stops": 1,
"airlines": ["United", "Lufthansa"],
"segments": [...]
}
],
"count": 5
}
Search for outbound and return flights together.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
origin | string | Yes | - | Origin airport code |
destination | string | Yes | - | Destination airport code |
departure_from | string | Yes | - | Outbound date (YYYY-MM-DD) |
return_from | string | Yes | - | Return date (YYYY-MM-DD) |
limit | integer | No | 5 | Maximum results |
fgp call travel.search_roundtrip -p '{"origin": "SFO", "destination": "BER", "departure_from": "2026-02-15", "return_from": "2026-02-22", "limit": 5}'
Search entire date range in parallel to find the cheapest travel day. 30x more efficient than individual searches.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
origin | string | Yes | Origin airport code |
destination | string | Yes | Destination airport code |
date_from | string | Yes | Start of date range |
date_to | string | Yes | End of date range |
fgp call travel.search_cheapest_day -p '{"origin": "SFO", "destination": "BER", "date_from": "2026-02-01", "date_to": "2026-02-28"}'
Response: (~470 tokens for 28 days)
{
"cheapest": {
"date": "2026-02-04",
"price": 225.0
},
"prices": [
{"date": "2026-02-01", "price": 350.0},
{"date": "2026-02-02", "price": 280.0},
...
],
"days_searched": 28
}
Compare prices to multiple destinations in parallel.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
origin | string | Yes | - | Origin airport code |
destinations | array | Yes | - | List of destination codes (max 20) |
date | string | Yes | - | Travel date |
fgp call travel.search_cheapest_route -p '{"origin": "SFO", "destinations": ["LAX", "SEA", "DEN", "PHX", "LAS"], "date": "2026-02-15"}'
Response: (~110 tokens for 5 destinations)
{
"cheapest": {
"destination": "PHX",
"price": 50.0
},
"routes": [
{"destination": "PHX", "price": 50.0},
{"destination": "LAS", "price": 65.0},
{"destination": "LAX", "price": 83.0},
{"destination": "SEA", "price": 120.0},
{"destination": "DEN", "price": 145.0}
]
}
Search ±N days around a target date for price flexibility.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
origin | string | Yes | - | Origin airport code |
destination | string | Yes | - | Destination airport code |
date | string | Yes | - | Target date (YYYY-MM-DD) |
flexibility | integer | No | 3 | Days before/after to search |
fgp call travel.search_flexible_dates -p '{"origin": "SFO", "destination": "BER", "date": "2026-02-15", "flexibility": 3}'
Response: (~185 tokens for ±3 days)
{
"cheapest": {
"date": "2026-02-13",
"price": 420.0
},
"prices": [
{"date": "2026-02-12", "price": 480.0},
{"date": "2026-02-13", "price": 420.0},
{"date": "2026-02-14", "price": 450.0},
{"date": "2026-02-15", "price": 490.0},
{"date": "2026-02-16", "price": 460.0},
{"date": "2026-02-17", "price": 440.0},
{"date": "2026-02-18", "price": 510.0}
],
"target_date": "2026-02-15",
"flexibility": 3
}
Search for direct (non-stop) flights only. Smaller response since no connecting segments.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
origin | string | Yes | - | Origin airport code |
destination | string | Yes | - | Destination airport code |
date | string | Yes | - | Travel date |
limit | integer | No | 5 | Maximum results |
fgp call travel.search_direct_only -p '{"origin": "SFO", "destination": "LAX", "date": "2026-02-15", "limit": 3}'
Execute multiple independent price checks in a single call.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
searches | array | Yes | List of search objects (max 10) |
Each search object:
| Field | Type | Required | Description |
|---|---|---|---|
origin | string | Yes | Origin airport code |
destination | string | Yes | Destination airport code |
date | string | Yes | Travel date |
fgp call travel.batch_search -p '{"searches": [
{"origin": "SFO", "destination": "LAX", "date": "2026-02-15"},
{"origin": "SFO", "destination": "SEA", "date": "2026-02-15"},
{"origin": "SFO", "destination": "BER", "date": "2026-02-15"}
]}'
Response: (~160 tokens for 3 routes)
{
"results": [
{"origin": "SFO", "destination": "LAX", "result": {"price": 83.0, "stops": 0}},
{"origin": "SFO", "destination": "SEA", "result": {"price": 120.0, "stops": 0}},
{"origin": "SFO", "destination": "BER", "result": {"price": 450.0, "stops": 1}}
],
"count": 3
}
Search hotels by city.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
location | string | Yes | - | City name |
limit | integer | No | 10 | Maximum results |
fgp call travel.search_hotels -p '{"location": "Berlin", "limit": 5}'
Get real-time rates for a specific hotel.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
hotel_key | string | Yes | Hotel identifier from search |
checkin | string | Yes | Check-in date (YYYY-MM-DD) |
checkout | string | Yes | Check-out date (YYYY-MM-DD) |
fgp call travel.hotel_rates -p '{"hotel_key": "abc123", "checkin": "2026-02-15", "checkout": "2026-02-18"}'
| User Request | Best Method | Why |
|---|---|---|
| "What's the cheapest price to LAX?" | price_check | 10x fewer tokens |
| "Which day in February is cheapest?" | search_cheapest_day | Parallel search, single response |
| "Where can I fly for under $100?" | search_cheapest_route | Compare multiple destinations |
| "I'm flexible ±3 days" | search_flexible_dates | Shows price calendar |
| "Non-stop flights only" | search_direct_only | Smaller response |
| "Check prices to 5 cities" | batch_search | One call, parallel execution |
| "Show me flight options" | search_flights | Full details needed |
| "Find airport code for..." | find_location | Instant, no API call |
| Operation | Latency | Notes |
|---|---|---|
| Location search | 1-10ms | Local database (7,988 entries) |
| Price check | 400-600ms | Single API call |
| Flight search | 400-1000ms | Kiwi API |
| Hotel search | 300-700ms | Xotelo API |
| Cheapest day (28 days) | 1-2s | Parallel API calls |
| Cache hit | <1ms | In-memory LRU |
| Issue | Check | Fix |
|---|---|---|
| Daemon not running | fgp status travel | fgp start travel |
| Location not found | Try airport code | Use 3-letter IATA code |
| No flights returned | Check date format | Use YYYY-MM-DD |
| Hotel location not found | Check city spelling | 224 major cities supported |
# Find airport codes
fgp call travel.find_location -p '{"term": "Berlin"}'
# Check cheapest day to travel
fgp call travel.search_cheapest_day -p '{"origin": "SFO", "destination": "BER", "date_from": "2026-02-01", "date_to": "2026-02-28"}'
# Get flight details for that day
fgp call travel.search_flights -p '{"origin": "SFO", "destination": "BER", "departure_from": "2026-02-04", "limit": 5}'
# Find hotels
fgp call travel.search_hotels -p '{"location": "Berlin", "limit": 10}'
# Find cheapest destination from multiple options
fgp call travel.search_cheapest_route -p '{"origin": "SFO", "destinations": ["LAX", "SEA", "PDX", "LAS", "PHX", "DEN", "SLC"], "date": "2026-02-15"}'
# Check if direct flights available
fgp call travel.search_direct_only -p '{"origin": "SFO", "destination": "PHX", "date": "2026-02-15"}'