← Back to Skills Marketplace
111
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install aviasales-flights
Description
Search for cheap flights and airfare via Travelpayouts/Aviasales API. Supports date-specific search, price calendar, round-trip, cheapest-price monitoring, p...
README (SKILL.md)
Flights — Airfare Search via Travelpayouts/Aviasales
Prerequisites
Environment variable TRAVELPAYOUTS_TOKEN must be set with a valid Travelpayouts API token.
Quick Reference
| Task | Command |
|---|---|
| Search flights on a date | --from MOW --to LED --date 2026-04-15 [--return 2026-04-20] [--direct] [--limit 10] |
| Price calendar for a month | --from MOW --to LED --month 2026-04 |
| Lookup IATA code | --lookup "Istanbul" |
| Latest found prices | --from MOW --to AER --latest [--one-way] |
| Popular destinations | --from MOW --directions |
Usage
1. Resolve IATA codes
If the user provides a city name instead of an IATA code, resolve it first:
python3 scripts/search_flights.py --lookup "Istanbul"
Pick the most relevant result's code field.
2. Search flights on a specific date
python3 scripts/search_flights.py --from MOW --to LED --date 2026-04-15 --return 2026-04-20
Add --direct for non-stop only. Add --limit N to cap results (default 10).
3. Price calendar (cheapest days in a month)
python3 scripts/search_flights.py --from MOW --to LED --month 2026-04
Returns results sorted by price. Use to recommend the cheapest travel dates.
4. Latest found prices (price monitoring)
python3 scripts/search_flights.py --from MOW --latest
Shows recently found prices from the origin to any destination. Add --to AER to filter. Add --one-way for one-way only.
5. Popular destinations from a city
python3 scripts/search_flights.py --from MOW --directions
Returns destinations sorted by price — useful for "where can I fly cheaply from X?" queries.
Output Format
All commands output JSON to stdout:
{
"query": {"from": "MOW", "to": "LED", "date": "2026-04-15"},
"results": [
{
"price": 2454,
"airline": "Pobeda",
"airline_code": "DP",
"flight": "DP 209",
"from_airport": "VKO",
"to_airport": "LED",
"departure": "2026-04-07T07:50:00+03:00",
"duration_min": 90,
"duration_str": "1h 30min",
"transfers": 0,
"transfers_str": "non-stop",
"link": "https://aviasales.ru/search/..."
}
],
"cheapest": 2454,
"count": 5
}
Presenting Results to the User
- Highlight the cheapest option first.
- For each result show: price, airline, flight number, departure time, duration, stop type.
- Format the
linkfield as a clickable URL for booking. - For calendar queries, recommend the cheapest dates.
API Endpoints
| Method | URL | Purpose |
|---|---|---|
| GET | https://api.travelpayouts.com/aviasales/v3/prices_for_dates |
Prices for specific dates |
| GET | https://api.travelpayouts.com/aviasales/v3/get_latest_prices |
Latest found prices |
| GET | https://api.travelpayouts.com/aviasales/v3/grouped_prices |
Min prices by month/day |
| GET | https://api.travelpayouts.com/v1/city-directions |
Popular destinations |
| GET | https://autocomplete.travelpayouts.com/places2 |
IATA code autocomplete |
Common IATA Codes
| City | Code |
|---|---|
| Moscow (all airports) | MOW |
| Moscow Sheremetyevo | SVO |
| Moscow Domodedovo | DME |
| Moscow Vnukovo | VKO |
| Saint Petersburg | LED |
| Sochi | AER |
| Kazan | KZN |
| Minsk | MSQ |
| Istanbul | IST |
| Dubai | DXB |
| Yerevan | EVN |
| Tbilisi | TBS |
| Bishkek | FRU |
| Tashkent | TAS |
References
- Airline codes: See
references/airlines.mdfor a reference mapping of IATA airline codes to names. The script auto-fetches the latest mapping from the Travelpayouts API with a 24-hour cache; this file serves as a fallback.
Usage Guidance
This skill appears to be a legitimate Aviasales/Travelpayouts flight search tool, but there are practical concerns to resolve before installing: 1) The SKILL.md and script require TRAVELPAYOUTS_TOKEN, but the registry metadata does not declare any required environment variables — treat this as a red flag and confirm why the metadata is missing the token requirement. 2) The package has no install spec and the script depends on the Python 'requests' library; ensure the runtime has that dependency. 3) The script performs network calls to Travelpayouts/autocomplete/Aviasales and caches airline data to /tmp/airlines_cache.json — if you supply a token, make sure it has limited scope and is stored securely (not in a broadly readable file). 4) The source and homepage are unspecified; consider obtaining the skill from a known/trusted publisher or audit the included script yourself (it is present and readable) before providing API credentials. If you cannot verify the publisher, run the skill in a sandboxed environment and avoid reusing high-privilege tokens.
Capability Analysis
Type: OpenClaw Skill
Name: aviasales-flights
Version: 1.0.0
The skill bundle provides a legitimate tool for searching airfare via the Travelpayouts/Aviasales API. The Python script (scripts/search_flights.py) implements standard API interactions, handles IATA code lookups, and uses a local cache file in /tmp for airline metadata. No evidence of data exfiltration, malicious execution, or prompt injection was found; the code and instructions are strictly aligned with the stated purpose.
Capability Assessment
Purpose & Capability
Name/description match the code and instructions: the skill queries Travelpayouts/Aviasales endpoints to search flights and lookup IATA codes. Requiring a Travelpayouts API token is appropriate for this purpose. However, the registry metadata declares no required environment variables while SKILL.md and the script explicitly require TRAVELPAYOUTS_TOKEN — the metadata omission is an inconsistency.
Instruction Scope
SKILL.md instructs the agent to call the included Python script and to set TRAVELPAYOUTS_TOKEN. The runtime steps are limited to: autocomplete lookup, prices_for_dates, grouped_prices, get_latest_prices, and fetching airlines data. The script only reads the token environment variable, writes a cache to /tmp/airlines_cache.json, and performs HTTP requests to Travelpayouts/autocomplete/Aviasales endpoints — all within the expected scope of a flight search skill.
Install Mechanism
This is instruction-only with an included Python script and no install spec. The script imports the third-party 'requests' library but the skill does not declare dependencies or provide an install step — users must ensure 'requests' is available. Lack of a declared install mechanism is not malicious by itself but is an operational shortcoming that can cause runtime failures.
Credentials
The script requires a TRAVELPAYOUTS_TOKEN (checked via os.environ) and uses it to call Travelpayouts endpoints. That single credential is proportionate to the stated purpose. The problem: the registry metadata does not list this required env var (it lists none), creating an inconsistency that could mislead users into providing the token in an unexpected way or deploying without realizing a secret is required. No other unrelated credentials or sensitive paths are requested.
Persistence & Privilege
The skill does not request persistent platform privileges (always:false) and does not modify other skills or system-wide settings. It writes a transient cache to /tmp/airlines_cache.json (24h TTL), which is normal for this use case.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install aviasales-flights - After installation, invoke the skill by name or use
/aviasales-flights - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: search cheap flights via Aviasales/Travelpayouts API
Metadata
Frequently Asked Questions
What is Aviasales Flight Search?
Search for cheap flights and airfare via Travelpayouts/Aviasales API. Supports date-specific search, price calendar, round-trip, cheapest-price monitoring, p... It is an AI Agent Skill for Claude Code / OpenClaw, with 111 downloads so far.
How do I install Aviasales Flight Search?
Run "/install aviasales-flights" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Aviasales Flight Search free?
Yes, Aviasales Flight Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Aviasales Flight Search support?
Aviasales Flight Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Aviasales Flight Search?
It is built and maintained by aspalagin (@aspalagin); the current version is v1.0.0.
More Skills