Variflight

Query flight information, train tickets, and travel data using Variflight (飞常准) HTTP API. Use when the user needs to (1) search flights by route or flight number, (2) check flight status and punctuality, (3) find train tickets, (4) get airport weather forecasts, (5) check flight prices, (6) plan multi-modal trips (flight+train), or (7) get flight comfort metrics (happiness index).

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install variflight

Variflight HTTP API Tool

Official Variflight Agent Skills enabling AI assistants to retrieve flight and railway data via zero-dependency tools.

API Endpoint

Base URL: https://ai.variflight.com/api/v1/mcp/data
Method: POST
Header: X-VARIFLIGHT-KEY: your_api_key
Content-Type: application/json

Configuration

支持多种配置方式（按优先级排序）：

1. 环境变量（推荐用于 CI/CD）

export VARIFLIGHT_API_KEY="sk-xxxxxxxxxxxxxxxx"

2. 配置文件

按以下顺序查找（找到即停止）：

./.variflight.json（项目级配置）
~/.variflight.json（用户级配置）
~/.config/variflight/config.json（XDG 标准）

配置格式：

{
  "api_key": "sk-xxxxxxxxxxxxxxxx"
}

3. 命令行参数

./flights.sh --api-key sk-xxxx PEK SHA 2025-02-15

Quick Start

Installation

# Clone or copy the skill
git clone https://github.com/variflight-ai/variflight-skill.git

# Or copy to your project
cp -r variflight-skill/scripts ./scripts

Get API Key

Visit https://ai.variflight.com

Setup

方式一：环境变量

export VARIFLIGHT_API_KEY="sk-xxxxxxxxxxxxxxxx"

方式二：配置文件

echo '{"api_key": "sk-xxxxxxxxxxxxxxxx"}' > ~/.variflight.json

Usage

# Search flights
./scripts/flights.sh PEK SHA 2025-02-15

# Search by flight number
./scripts/flight.sh MU2157 2025-02-15

# Search train tickets
./scripts/train.sh "上海" "合肥" 2025-02-15

# Airport weather
./scripts/weather.sh PEK

# With explicit API key
./scripts/flights.sh --api-key sk-xxxx PEK SHA 2025-02-15

Available Endpoints

Endpoint	Description	Parameters
`flights`	Search by departure/arrival	dep, arr, date, depcity, arrcity
`flight`	Search by flight number	fnum, date, dep, arr
`transfer`	Flight transfer info	depcity, arrcity, depdate
`happiness`	Flight comfort index	fnum, date, dep, arr
`realtimeLocation`	Aircraft location	anum
`futureAirportWeather`	Airport weather	code, type="1"
`searchFlightItineraries`	Flight itineraries	depCityCode, arrCityCode, depDate
`trainStanTicket`	Train tickets	cdep, carr, date
`searchTrainStations`	Train stations	query
`getFlightPriceByCities`	Flight prices	dep_city, arr_city, dep_date

Common Airport Codes

City	Airport	Code
北京	首都机场	PEK
北京	大兴机场	PKX
上海	虹桥机场	SHA
上海	浦东机场	PVG
广州	白云机场	CAN
深圳	宝安机场	SZX
成都	双流机场	CTU
杭州	萧山机场	HGH
合肥	新桥机场	HFE
西安	咸阳机场	XIY

Response Format

{
  "code": 200,
  "message": "Success",
  "data": { ... }
}

Error Handling

401 - Invalid API key
400 - Bad request
500 - Server error

Integration Examples

OpenClaw (特别支持)

OpenClaw 会自动识别并加载本 skill。

安装：

# 通过 ClawHub 安装
openclaw skill install variflight

# 或手动安装
cp -r variflight-skill ~/.openclaw/workspace/skills/variflight

配置：

# OpenClaw 专用环境文件
echo 'VARIFLIGHT_API_KEY=sk-xxxx' > ~/.openclaw/workspace/.env.variflight

# 或使用通用配置
echo '{"api_key": "sk-xxxx"}' > ~/.variflight.json

使用：

./skills/variflight/scripts/flights.sh PEK SHA 2025-02-15
./skills/variflight/scripts/train.sh "上海" "合肥" 2025-02-15

Claude Code / Cursor

Add to your settings:

{
  "variflight_api_key": "sk-xxxxxxxxxxxxxxxx"
}

Or set environment variable in your shell config:

export VARIFLIGHT_API_KEY="sk-xxxxxxxxxxxxxxxx"

GitHub Actions

- name: Setup Variflight
  env:
    VARIFLIGHT_API_KEY: ${{ secrets.VARIFLIGHT_API_KEY }}
  run: |
    ./scripts/flights.sh PEK SHA 2025-02-15

Docker

ENV VARIFLIGHT_API_KEY=sk-xxxxxxxxxxxxxxxx
COPY scripts/ /app/scripts/