Flight Tracker
by @copey02
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.
clawhub install aviationstack-flight-trackerπ About This Skill
name: flight-tracker version: 1.0.0 description: 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.
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):
1. Get a free API key at https://aviationstack.com/signup/free (100 requests/month) 2. Set environment variable:
export AVIATIONSTACK_API_KEY='your-key-here'
pip3 install requests
For detailed setup instructions, see api-setup.md.
Output Format
The skill displays flight information in a clean, readable format with:
Status indicators:
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:
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:
The script automatically converts to uppercase and handles the lookup.
Error Handling
The script handles common errors:
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
π‘ Examples
Track a flight by its IATA code:
scripts/track_flight.py AA100
scripts/track_flight.py UA2402
scripts/track_flight.py BA123