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

Common Airport Codes

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/

Links

• Variflight AI: https://ai.variflight.com
• ClawHub: https://clawhub.com