Skill: callum-kemp/ryanair-fare-finder (version 1.0.0)

--- name: ryanair-fare-finder description: > Build and interpret Ryanair fare-finder URLs for cheap flight searches. Use when the user wants to find budget flights from a specific UK airport, configure departure/return time windows, set overnight or multi-night trip parameters, filter by day of week, or constrain results by price and currency. Handles all fare-finder query parameters including passenger counts, date ranges, flexible dates, and promo codes. compatibility: Requires network access to reach ryanair.com fare-finder pages. metadata: author: Callum Kemp version: "1.0" base-url: "https://www.ryanair.com/gb/en/fare-finder" --- # Ryanair Fare Finder Generate, modify, and explain Ryanair fare-finder URLs from user requirements. ## Base URL ``` https://www.ryanair.com/gb/en/fare-finder ``` All parameters below are appended as query-string key-value pairs. ## Parameter Reference ### Route | Parameter | Type | Example | Description | |----------------------|---------|---------|-----------------------------------------------------------------------------| | `originIata` | string | `MAN` | IATA code of the departure airport (e.g. MAN, STN, LTN, EDI, BHX, LPL). | | `destinationIata` | string | `ANY` | IATA code of the arrival airport, or `ANY` for all destinations. | | `isMacDestination` | boolean | `false` | When `true`, filters to multi-airport city destinations only. | ### Trip type | Parameter | Type | Example | Description | |-------------|---------|---------|------------------------------------------------------| | `isReturn` | boolean | `true` | `true` for return (round-trip), `false` for one-way. | ### Passengers | Parameter | Type | Example | Description | |-----------|------|---------|--------------------------| | `adults` | int | `1` | Number of adults (16+). | | `teens` | int | `0` | Number of teens (12-15). | | `children`| int | `0` | Number of children (2-11).| | `infants` | int | `0` | Number of infants (< 2). | ### Date range | Parameter | Type | Example | Description | |---------------|---------|--------------|-----------------------------------------------------------------------------| | `dateOut` | date | `2026-02-01` | Start of the search window (YYYY-MM-DD). | | `dateIn` | date | `2027-01-31` | End of the search window (YYYY-MM-DD). | | `isExactDate` | boolean | `false` | `true` to search a specific date only; `false` to scan the full date range. | ### Day and flexibility | Parameter | Type | Example | Description | |------------------|---------|------------|--------------------------------------------------------------------| | `dayOfWeek` | enum | `SATURDAY` | Restrict outbound to a specific day. Values: `MONDAY`..`SUNDAY`. | | `isFlexibleDay` | boolean | `false` | When `true`, Ryanair widens the day-of-week filter by +/- 1 day. | ### Stay duration | Parameter | Type | Example | Description | |--------------|------|---------|--------------------------------------------------------| | `daysTrip` | int | `1` | Total trip length in days (outbound day counts as 1). | | `nightsFrom` | int | `0` | Minimum number of nights at the destination. | | `nightsTo` | int | `1` | Maximum number of nights at the destination. | ### Time windows | Parameter | Type | Example | Description | |--------------------|--------|---------|--------------------------------------------------| | `outboundFromHour` | string | `00:00` | Earliest acceptable outbound departure time. | | `outboundToHour` | string | `11:00` | Latest acceptable outbound departure time. | | `inboundFromHour` | string | `13:00` | Earliest acceptable return departure time. | | `inboundToHour` | string | `23:59` | Latest acceptable return departure time. | ### Pricing | Parameter | Type | Example | Description | |----------------|--------|---------|--------------------------------------------------------------------| | `currency` | string | `GBP` | ISO 4217 currency code (GBP, EUR, etc.). | | `priceValueTo` | int | `80` | Maximum total return price. Leave empty for no cap. | | `promoCode` | string | *(empty)* | Ryanair promotional code, if applicable. | ## Example: Overnight Saturday getaway from Manchester The following URL searches for return flights from Manchester to anywhere, departing on a Saturday morning, returning the same day or next day in the afternoon/evening, across the full year, under GBP 80 return: ``` https://www.ryanair.com/gb/en/fare-finder?originIata=MAN&destinationIata=ANY&isReturn=true&isMacDestination=false&promoCode=&adults=1&teens=0&children=0&infants=0&dateOut=2026-02-01&dateIn=2027-01-31&daysTrip=1&nightsFrom=0&nightsTo=1&dayOfWeek=SATURDAY&isExactDate=false&outboundFromHour=00:00&outboundToHour=11:00&inboundFromHour=13:00&inboundToHour=23:59&priceValueTo=80&currency=GBP&isFlexibleDay=false ``` ### Why these time windows work for overnights - **Outbound 00:00-11:00** — arrive by early afternoon, giving a full day/evening at the destination. - **Inbound 13:00-23:59** — depart after checkout / lunch the next day, home by late evening. ## Step-by-step: building a URL from scratch 1. Start with the base URL. 2. Set `originIata` to the user's departure airport IATA code. 3. Set `destinationIata` to a specific IATA code or `ANY`. 4. Choose `isReturn=true` for returns or `false` for one-way. 5. Set passenger counts (`adults`, `teens`, `children`, `infants`). 6. Define the date search window with `dateOut` and `dateIn`. 7. Pick `dayOfWeek` and set `isExactDate=false` to scan all matching days. 8. Configure stay duration with `daysTrip`, `nightsFrom`, `nightsTo`. 9. Set outbound/inbound time windows to taste. 10. Set `currency` and optionally `priceValueTo` for a price cap. 11. Add `promoCode` if the user has one. ## Common UK origin airports | IATA | Airport | |------|---------------------| | MAN | Manchester | | STN | London Stansted | | LTN | London Luton | | LGW | London Gatwick | | EDI | Edinburgh | | BHX | Birmingham | | LPL | Liverpool | | BRS | Bristol | | EMA | East Midlands | | GLA | Glasgow | | BFS | Belfast Intl | | LBA | Leeds Bradford | | NCL | Newcastle | | ABZ | Aberdeen |


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)