amadeus-flights
by kirorab
TransportationBrief
Query flight offers (price, schedule, availability) via Amadeus API.
Description
What This Skill Does
Queries real-time flight offers via the Amadeus API, returning prices, schedules, stop counts, and seat availability. Supports IATA airport codes with built-in lookup for 40+ Chinese cities. Works in test or production mode depending on the configured base URL.
Amadeus provides real carrier pricing and availability in one API call, avoiding manual searches across multiple booking sites.
When to Use It
- Checking cheapest flights between two cities on a specific date
- Finding non-stop business class options for a work trip
- Looking up IATA codes for Chinese cities by name
- Comparing economy vs premium economy pricing
- Getting raw JSON flight data for further processing
Example Workflow
User asks: What are the cheapest flights from Hong Kong to Shanghai on March 20?
- 1
Resolve city names to IATA codes (HKG, PVG)
- 2
Run query.mjs HKG PVG -d 2026-03-20 to fetch offers from Amadeus API
- 3
Parse results for price, stops, and schedule
- 4
Return ranked list of flight options with prices in CNY
List of available flights with airline, departure time, stops, and price
Requirements
- AMADEUS_API_KEY environment variable
- AMADEUS_API_SECRET environment variable
- Amadeus developer account at developers.amadeus.com
Installation
clawhub install kirorab/amadeus-flightsRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.