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 key400- Bad request500- 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/
Links
- Variflight AI: https://ai.variflight.com
- ClawHub: https://clawhub.com
