victorlane/Flyan

An open-source unofficial API wrapper to get flight data from Ryanair.
> [!TIP]
> **New: MCP server for AI agents.** Plug Flyan into Claude Desktop,
> Claude Code, or Cursor and search Ryanair flights in natural language.
> Jump to the MCP Quickstart.
Contents
- Installation
- Quick Start
- API Reference
- Data Models
- Examples
- Explore Mode
- **Use with Claude, Cursor, and other MCP clients**
- Supported Airports
- Supported Currencies
- Rate Limiting
- Contributing
- Disclaimer
Installation
Or using uv:
Quick Start
API Reference
RyanAir Class
Constructor
Creates a new RyanAir client instance.
**Parameters:**
- currency (str, optional): Preferred currency for pricing. Defaults to "EUR". Must be a valid currency code from the supported currencies list.
**Example:**
Methods
get_oneways(params: FlightSearchParams) -> list[Flight]
Search for one-way flights.
**Parameters:**
- params (FlightSearchParams): Search parameters
**Returns:**
- list[Flight]: List of available flights
FlightSearchParams Class
Parameters for searching flights.
**Parameters:**
- from_airport (str): IATA code of departure airport (e.g., "DUB")
- from_date (datetime): Earliest departure date
- to_date (datetime): Latest departure date
- destination_country (str, optional): Country code for destination
- max_price (int, optional): Maximum price filter
- to_airport (str, optional): IATA code of arrival airport
- departure_time_from (str, optional): Earliest departure time (HH:MM format)
- departure_time_to (str, optional): Latest departure time (HH:MM format)
**Example:**
ReturnFlightSearchParams Class
Extended parameters for return flight searches.
Data Models
Flight
Represents a single flight.
**Attributes:**
- departure_airport (Airport): Departure airport information
- arrival_airport (Airport): Arrival airport information
- departure_date (datetime): Departure date and time
- arrival_date (datetime): Arrival date and time
- price (float): Flight price
- currency (str): Price currency
- flight_key (str): Unique flight identifier
- flight_number (str): Flight number
- previous_price (Optional[str | float]): Previous price if available
Airport
Represents airport information.
**Attributes:**
- country_name (str): Country name
- iata_code (str): IATA airport code
- name (str): Airport name
- seo_name (str): SEO-friendly name
- city_name (str): City name
- city_code (str): City code
- city_country_code (str): Country code
ReturnFlight
Represents a return flight booking.
**Attributes:**
- outbound (Flight): Outbound flight
- inbound (Flight): Return flight
- summary_price (float): Total price for both flights
- summary_currency (str): Currency for total price
- previous_price (str | float): Previous total price if available
NetworkAirport
Represents an airport in Ryanair's live network. Returned by the explore methods.
**Attributes:**
- iata_code (str): IATA airport code
- name (str): Airport name
- seo_name (str): SEO-friendly name
- country_code (str): Lowercase ISO2 country code (e.g. "ie", "es")
- city_code (str): City code (e.g. "LONDON", "DUBLIN")
- region_code (Optional[str]): Region code (e.g. "SCOTLAND", "ANDALUSIA")
- currency_code (str): Local currency code
- time_zone (str): IANA timezone (e.g. "Europe/Dublin")
- base (bool): True if this is a Ryanair base
- latitude (float), longitude (float): Coordinates
- routes (list[str]): Raw route strings (year-round)
- seasonal_routes (list[str]): Raw route strings (seasonal-only)
- categories (list[str]): Marketing categories assigned by Ryanair
- aliases (list[str]): Alternative names
Helpers: airport_routes(), country_routes(), seasonal_airport_routes(),
typed_routes(), typed_seasonal_routes().