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.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/rafaforesightai/track-flightFlight 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)
Metadata
Not sure this is the right skill?
Describe what you want to build â we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-rafaforesightai-track-flight": {
"enabled": true,
"auto_update": true
}
}
}