Agent Skills
› borski/travel-hacking-toolkit
› ignav
ignav
GitHub通过 Ignav API 执行航班搜索，支持单程/往返查询、机场代码解析及预订链接获取。提供结构化 JSON 结果并以 Markdown 表格展示，适用于比价和行程规划场景。
Trigger Scenarios
用户询问航班价格或时刻
需要查找特定路线的机票
生成旅行行程建议
Install
npx skills add borski/travel-hacking-toolkit --skill ignav -g -y
SKILL.md
Frontmatter
{
"name": "ignav",
"api_key": "Ignav (1,000 free)",
"summary": "Fast REST API cash prices. Market selection for arbitrage.",
"category": "flights",
"description": "Fast REST API flight search via ignav.com. Cash prices, booking links, market selection for price arbitrage. Include in every flight search alongside Duffel and other sources.",
"allowed-tools": "Bash(curl *)"
}
Flight Search via Ignav API
Fast REST API flight search at https://ignav.com. Returns structured JSON with prices, itineraries, and booking links. 1,000 free requests, no rate limit.
Setup
Get a free API key at https://ignav.com/signup (1,000 requests, no credit card).
Set IGNAV_API_KEY in your environment or .env file.
Workflow
- Parse the user's request (origin, destination, dates, trip type, passengers, cabin)
- Look up airport codes if user gave city names
- Search flights (one-way or round-trip)
- Present results in markdown table
- Get booking links if user wants to book
Endpoints
Search Airports
curl -s "https://ignav.com/api/airports?q=Barcelona&limit=5" \
-H "X-Api-Key: $IGNAV_API_KEY"
One-Way Flights
curl -s -X POST "https://ignav.com/api/fares/one-way" \
-H "X-Api-Key: $IGNAV_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"origin": "SFO",
"destination": "JFK",
"departure_date": "2026-05-15",
"adults": 1,
"cabin_class": "economy"
}'
Round-Trip Flights
curl -s -X POST "https://ignav.com/api/fares/round-trip" \
-H "X-Api-Key: $IGNAV_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"origin": "SFO",
"destination": "JFK",
"departure_date": "2026-05-15",
"return_date": "2026-05-20",
"adults": 1,
"cabin_class": "economy"
}'
Booking Links
curl -s -X POST "https://ignav.com/api/fares/booking-links" \
-H "X-Api-Key: $IGNAV_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ignav_id": "the_itinerary_id", "adults": 1}'
Parameters
| Parameter | Type | Description |
|---|---|---|
adults |
int | Number of adults (default: 1) |
children |
int | Number of children (default: 0) |
cabin_class |
string | economy, premium_economy, business, first |
max_stops |
int | 0 (direct only), 1, or 2 |
max_price |
int | Maximum price filter |
departure_time_range |
object | {"earliest_hour": 8, "latest_hour": 20} |
airlines_include |
array | Only these airline codes |
airlines_exclude |
array | Exclude these airline codes |
market |
string | Country code for pricing (default: "US"). Different markets return different prices. |
Response Structure
Each itinerary contains:
price:{"amount": 299, "currency": "USD"}outbound: carrier, duration_minutes, segments arrayinbound: same (null for one-way)cabin_class: the cabin classbags:{"carry_on": 1, "checked": 0}ignav_id: unique ID for booking links
Each segment: marketing_carrier_code, flight_number, departure_airport, departure_time_local, arrival_airport, arrival_time_local, duration_minutes, aircraft.
Output Format
Always use markdown tables.
| # | Airline | Stops | Duration | Depart | Arrive | Price | Bags |
|---|---|---|---|---|---|---|---|
| 1 | Vueling | Nonstop | 2h 15m | 8:30 AM | 10:45 AM | EUR 125 | 1 carry-on |
| 2 | Ryanair | Nonstop | 2h 20m | 6:15 AM | 8:35 AM | EUR 89 | 1 carry-on |
After the table, highlight cheapest, fastest, and best value. Call out tradeoffs. Offer booking links.
Notes
- Dates are required for all searches
- Default to round-trip and economy if not specified
- Use airport search endpoint for city name lookups
- Market affects prices. Same route can cost significantly less from a different market. Try departure country first, then destination country.
- Does NOT include Southwest. Use google-flights skill for SW.
Version History
- 8c12eda Current 2026-07-25 05:45
