How do I install the Aviationstack Flight Tracker skill?

Run npx skillmds@latest add infometa/aviationstack-flight-tracker in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Aviationstack Flight Tracker safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Aviationstack Flight Tracker?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Aviationstack Flight Tracker free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Aviationstack Flight Tracker?

infometa (@infometa) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Aviationstack Flight Tracker by infometa

Name: Aviationstack Flight Tracker
Rating: 4.2 (5 reviews)
Author: infometa

Aviationstack 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. Requires AVIATIONSTACK_API_KEY.

infometa Updated Sep 9, 2026 228 repo stars

File contents

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 --json flag

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)

---name: aviationstack-flight-trackerdescription: 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. Requires AVIATIONSTACK_API_KEY.--- # 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: ```bash 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): 1. **Get a free API key** at https://aviationstack.com/signup/free (100 requests/month) 2. **Set environment variable:** ```bash export AVIATIONSTACK_API_KEY='your-key-here' ``` 3. **Install dependencies:** ```bash pip3 install requests ``` For detailed setup instructions, see [api-setup.md](references/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:** ```bash scripts/track_flight.py AA100 --json ``` **Check help:** ```bash scripts/track_flight.py --help ``` ## Workflow When a user asks to track a flight: 1. Extract the flight number from the request 2. Run the tracking script with the flight number 3. Present the formatted output to the user 4. If data is needed for further processing, use `--json` flag ## 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)

Frequently asked questions