← 返回 Skills 市场

Aviasales Flight Search

Name: Aviasales Flight Search
Author: aspalagin

作者 aspalagin · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

111

总下载

当前安装

版本数

在 OpenClaw 中安装

/install aviasales-flights

功能描述

Search for cheap flights and airfare via Travelpayouts/Aviasales API. Supports date-specific search, price calendar, round-trip, cheapest-price monitoring, p...

使用说明 (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 link field 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.md for 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.

安全使用建议

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.

功能分析

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.

能力评估

ℹ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install aviasales-flights
安装完成后，直接呼叫该 Skill 的名称或使用 /aviasales-flights 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release: search cheap flights via Aviasales/Travelpayouts API

元数据

Slug aviasales-flights

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题