flights

TotalClaw 作者 totalclaw

通过 Amadeus API 查询航班报价（价格、时刻表、可用性）。当用户询问航班/机票/航班价格、时刻表或可用性时使用。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw skills install shop:totalclaw:totalclaw~kirorab-amadeus-flights

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~kirorab-amadeus-flights/file -o kirorab-amadeus-flights.md

# Flight Query (Amadeus)

Query real-time flight offers including price, schedule, stops, and seat availability.

## Setup

Set environment variables (or hardcoded defaults are used):

```bash
export AMADEUS_API_KEY=your_key
export AMADEUS_API_SECRET=your_secret
# For production (real data):
export AMADEUS_BASE_URL=https://api.amadeus.com
```

## Query Flights

```bash
node {baseDir}/scripts/query.mjs <FROM_IATA> <TO_IATA> [-d YYYY-MM-DD] [options]
```

### Examples

```bash
# Hong Kong to Shanghai
node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25

# Direct flights only
node {baseDir}/scripts/query.mjs SWA HGH -d 2026-02-24 --direct

# Business class
node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25 -c BUSINESS

# JSON output
node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25 --json
```

### Options

- `-d, --date <YYYY-MM-DD>`: Departure date (default: today)
- `-a, --adults <n>`: Number of adults (default: 1)
- `-c, --class <class>`: ECONOMY, PREMIUM_ECONOMY, BUSINESS, FIRST
- `--direct`: Non-stop flights only
- `-n, --max <n>`: Max results (default: 20)
- `--currency <code>`: Currency code (default: CNY)
- `--json`: Raw JSON output

## Airport Lookup

```bash
node {baseDir}/scripts/airports.mjs 揭阳    # → SWA
node {baseDir}/scripts/airports.mjs 杭州    # → HGH
node {baseDir}/scripts/airports.mjs tokyo   # API lookup
```

Built-in mappings for 40+ Chinese cities. Falls back to Amadeus API for others.

## Notes

- Test environment returns simulated data; production returns real prices
- Switch to production: set `AMADEUS_BASE_URL=https://api.amadeus.com`
- Free tier: 2000 calls/month (production)