variflight-global-flight-fares
# Variflight Global Flight Fares
## Overview
Use the bundled script to query the Variflight ticket API and return one-way flight options for a single route and date.
## Workflow
1. Collect `dep`, `arr`, and `date`.
2. Validate `dep` and `arr` as three-letter IATA city codes and `date` as `YYYY-MM-DD`.
3. If the user gives city names instead of codes, infer only when the mapping is unambiguous; otherwise ask for the IATA codes.
4. Run `python3 scripts/query_flights.py --dep BJS --arr SHA --date 2026-04-21`.
5. Summarize the result with departure airport, arrival airport, times, duration, price, transfer info, and the flight tag text.
## Output Rules
- Treat API `code != 0` as a failure and surface the returned `msg`.
- Treat an empty `data.list` as a valid "no flights found" result.
- Use `--limit N` when the user only wants a subset of results.
- Use `--json` only when the user asks for raw payload data.
- Mention transfer flights separately from direct flights when summarizing.
- Do not ask the user to provide an API key for this skill.
## Script
- `scripts/query_flights.py` accepts:
- `--dep`
- `--arr`
- `--date`
- `--limit`
- `--json`
- The script sends the fixed request parameter `flightNum=10`.
## Example
Run `python3 scripts/query_flights.py --dep BJS --arr SHA --date 2026-04-21 --limit 5` to fetch the first five displayed results for Beijing to Shanghai on April 21, 2026.
标签
skill
ai