Description

Flight tracking and scheduling. Track live flights in real-time by region, callsign, or airport using OpenSky Network. Search flight schedules between airports. Use for queries like "What flights are over Switzerland?" or "When do flights from Hamburg arrive in Zurich?" or "Track flight SWR123".

README (SKILL.md)

Flight Tracker

Name: A simple Flight Tracker
Author: xenofex7

Track flights in real-time and search flight schedules between airports.

Quick Commands

Live Flight Tracking

Flights over a region (bounding box)

# Switzerland (lat_min, lat_max, lon_min, lon_max)
curl -s "https://opensky-network.org/api/states/all?lamin=45.8&lomin=5.9&lamax=47.8&lomax=10.5" | \
  jq -r '.states[] | "\(.[1]) - \(.[2]) | Alt: \(.[7])m | Speed: \(.[9])m/s | From: \(.[5])"'

Track specific flight by callsign

curl -s "https://opensky-network.org/api/states/all?icao24=\x3Caircraft-icao>" | jq .

Get live flight info

# Use helper script
python3 scripts/track.py --region switzerland
python3 scripts/track.py --callsign SWR123
python3 scripts/track.py --airport LSZH

Flight Schedules

Search for scheduled flights between airports:

# Basic usage (shows search links)
python3 scripts/schedule.py HAM ZRH

# With specific date
python3 scripts/schedule.py --from HAM --to ZRH --date 2026-01-15

# With API key (optional, for detailed results)
export AVIATIONSTACK_API_KEY='your_key_here'
python3 scripts/schedule.py HAM ZRH

Without API key: Shows helpful search links (Google Flights, FlightRadar24, airline websites)

With API key: Fetches live schedule data with departure/arrival times, terminals, gates, and status

Free API key available at aviationstack.com (100 requests/month)

Regions

Pre-defined regions in the script:

switzerland: Swiss airspace
europe: European airspace (rough bounds)
zurich: Area around Zurich
geneva: Area around Geneva

API Endpoints

All states

GET https://opensky-network.org/api/states/all

Optional parameters:

lamin, lomin, lamax, lomax: Bounding box
icao24: Specific aircraft (hex code)
time: Unix timestamp (0 = now)

Response Format

Each flight state contains:

[0]  icao24      - Aircraft ICAO24 address (hex)
[1]  callsign    - Flight callsign (e.g., "SWR123")
[2]  origin_country - Country name
[5]  origin      - Origin airport (if available)
[7]  baro_altitude - Altitude in meters
[9]  velocity    - Speed in m/s
[10] heading     - Direction in degrees
[11] vertical_rate - Climb/descent rate in m/s

Airport Codes

ICAO (for live tracking)

LSZH - Zurich
LSGG - Geneva
LSZB - Bern
LSZA - Lugano
LFSB - Basel-Mulhouse (EuroAirport)

IATA (for schedules)

ZRH - Zurich
GVA - Geneva
BSL - Basel
BRN - Bern
LUG - Lugano
HAM - Hamburg
FRA - Frankfurt
MUC - Munich
BER - Berlin
LHR - London Heathrow
CDG - Paris CDG
AMS - Amsterdam

Notes

Live Tracking (OpenSky Network)

Free API with rate limits (anonymous: 400/day)
Real-time data from ADS-B receivers worldwide
No API key required
Data updated every 10 seconds
Create account for higher limits and historical data

Flight Schedules (AviationStack)

Optional API key for detailed schedule data
Free tier: 100 requests/month
Without API: provides search links to Google Flights, FlightRadar24, etc.
Supports date-specific queries

Usage Guidance

The package is small, self-contained, and consistent with its stated purpose, but review these before installing: 1) Provenance: the skill source is listed as "unknown" in the metadata—if you require strong provenance, prefer packages from trusted authors or registries. 2) API key privacy: if you set AVIATIONSTACK_API_KEY, schedule.py currently uses http://api.aviationstack.com which would transmit the key unencrypted; avoid providing a key unless you confirm HTTPS usage (change to https://api.aviationstack.com/v1/flights) or run the script in an isolated environment. 3) Network access: the scripts make outbound HTTP(S) calls — if you are in a restricted environment, be aware of that. 4) Inspectability: all code is included and readable; you can audit or run it locally before granting any sensitive credentials. 5) Rate limits and account exposure: OpenSky anonymous access is rate-limited (noted in SKILL.md); if you create an AviationStack account, protect that API key and monitor usage.

Capability Analysis

Type: OpenClaw Skill Name: flight-tracker Version: 1.1.0 The skill bundle is designed for flight tracking and scheduling, interacting with legitimate APIs (OpenSky Network and AviationStack). The `SKILL.md` provides clear instructions and examples without any evidence of prompt injection attempts to mislead the agent or perform unauthorized actions. The Python scripts (`schedule.py` and `track.py`) make network calls only to the documented flight APIs and `schedule.py` reads an environment variable (`AVIATIONSTACK_API_KEY`) solely for authentication to the stated API, which is a standard and expected practice. There is no indication of data exfiltration, malicious execution, persistence, or obfuscation.

Capability Assessment

✓ Purpose & Capability

Name/description (OpenSky live tracking + optional AviationStack schedules) matches the included scripts and SKILL.md. No unrelated binaries, credentials, or config paths are requested. The optional AVIATIONSTACK_API_KEY in documentation matches the schedule.py behavior.

ℹ Instruction Scope

Runtime instructions and scripts only call public APIs (opensky-network and aviationstack) and print results; they do not read arbitrary local files or other environment variables. Minor implementation note: schedule.py uses the AviationStack endpoint with plain HTTP (http://api.aviationstack.com/...), which would send an API key unencrypted if provided — this is an implementation/privacy concern but not evidence of malicious intent.

✓ Install Mechanism

No install spec; the skill is instruction+script based. No archives or external installers are fetched, and all code is included in the package so behavior is inspectable.

✓ Credentials

No required environment variables. One optional env var (AVIATIONSTACK_API_KEY) is justified by the stated optional feature. The scripts only read that single variable when available and do not request unrelated secrets.

✓ Persistence & Privilege

Skill does not request always:true and does not modify system or other skills. It runs as a normal, user-invoked script or via autonomous invocation (platform default).

Version History

v1.1.0

**Added flight schedule search feature** - Introduced scripts/schedule.py for searching scheduled flights between airports. - Now supports both live flight tracking and schedule lookup via AviationStack API (optional, with API key). - SKILL.md updated: covers both live tracking (OpenSky) and flight schedule features (AviationStack), explains API usage, and clarifies supported airport code formats. - Added helpful fallback: without an API key, schedule search provides direct links to external flight search engines. - Project description updated to reflect new scheduling capabilities.

v1.0.0

Initial release - Simple flight tracker using OpenSky Network - Track flights over regions (Switzerland, Europe, Zurich, Geneva) - Filter by callsign (e.g., SWISS flights) - Real-time data: altitude, speed, heading, climb/descent - No dependencies - pure Python with urllib - No API key required - uses free OpenSky Network API - Live tracking of 36+ flights over Switzerland

Metadata

Slug flight-tracker

Version 1.1.0

License —

All-time Installs 20

Active Installs 19

Total Versions 2

Frequently Asked Questions

What is A simple Flight Tracker?

Flight tracking and scheduling. Track live flights in real-time by region, callsign, or airport using OpenSky Network. Search flight schedules between airports. Use for queries like "What flights are over Switzerland?" or "When do flights from Hamburg arrive in Zurich?" or "Track flight SWR123". It is an AI Agent Skill for Claude Code / OpenClaw, with 3681 downloads so far.

How do I install A simple Flight Tracker?

Run "/install flight-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is A simple Flight Tracker free?

Yes, A simple Flight Tracker is completely free (open-source). You can download, install and use it at no cost.

Which platforms does A simple Flight Tracker support?

A simple Flight Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created A simple Flight Tracker?

It is built and maintained by xenofex7 (@xenofex7); the current version is v1.1.0.

More Skills

A simple Flight Tracker