/install aviationstack-flight-tracker
Flight Tracker
Track any flight worldwide using AviationStack API and display in a clean, Flighty-style format.
Quick Start
Track a flight by its IATA code:
scripts/track_flight.py AA100
scripts/track_flight.py UA2402
scripts/track_flight.py BA123
First-Time Setup
Before using this skill, you need an API key (one-time setup):
- Get a free API key at https://aviationstack.com/signup/free (100 requests/month)
- Set environment variable:
export AVIATIONSTACK_API_KEY='your-key-here' - Install dependencies:
pip3 install requests
For detailed setup instructions, see api-setup.md.
Output Format
The skill displays flight information in a clean, readable format with:
- ✈️ Airline and flight number
- 🛩️ Aircraft type and registration
- 🛫 Departure airport, terminal, gate, times
- 🛬 Arrival airport, terminal, gate, times
- 📊 Flight status with visual indicators
- ⏱️ Delay calculations (if applicable)
- 🌐 Live position, altitude, speed (when airborne)
Status indicators:
- 🟢 Active/Airborne/En-route
- ✅ Landed/Arrived
- 🟡 Scheduled
- 🟠 Delayed
- 🔴 Cancelled
Advanced Usage
Get raw JSON data:
scripts/track_flight.py AA100 --json
Check help:
scripts/track_flight.py --help
Workflow
When a user asks to track a flight:
- Extract the flight number from the request
- Run the tracking script with the flight number
- Present the formatted output to the user
- If data is needed for further processing, use
--jsonflag
Flight Number Formats
Accept IATA flight codes:
- AA100 (American Airlines)
- UA2402 (United)
- BA123 (British Airways)
- DL456 (Delta)
The script automatically converts to uppercase and handles the lookup.
Error Handling
The script handles common errors:
- Missing API key → Shows setup instructions
- Flight not found → Suggests verification
- API errors → Displays error message
- Rate limit exceeded → Indicates limit reached
API Limits
Free tier: 100 requests/month. Track usage to stay within limits. For heavy usage, consider upgrading or alternative APIs (see references/api-setup.md).
Notes
- Uses AviationStack free tier (no HTTPS on free plan)
- Real-time data updated frequently
- Historical flight data available
- Worldwide coverage (250+ countries, 13,000+ airlines)
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install aviationstack-flight-tracker - 安装完成后,直接呼叫该 Skill 的名称或使用
/aviationstack-flight-tracker触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Flight Tracker 是什么?
Track flights in real-time with detailed status, gate info, delays, and live position. Use when user asks to track a flight, check flight status, look up flight information by flight number (e.g., "track AA100", "what's the status of United 2402", "check my flight BA123"), or wants to display flight data in a formatted view similar to Flighty app. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2239 次。
如何安装 Flight Tracker?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install aviationstack-flight-tracker」即可一键安装,无需额外配置。
Flight Tracker 是免费的吗?
是的,Flight Tracker 完全免费(开源免费),可自由下载、安装和使用。
Flight Tracker 支持哪些平台?
Flight Tracker 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Flight Tracker?
由 copey02(@copey02)开发并维护,当前版本 v1.0.0。