360 Secure SkillHub
360 安全技能中心

Flight Tracker

该技能使用本地 Python 脚本调用 AviationStack API，按 IATA 航班号查询实时航班状态，展示航司机型、起降机场航站楼登机口、延误与空中位置，并可用 --json 输出原始数据；需配置 AVIATIONSTACK_API_KEY 并安装 requests。

copey02
copey02
热度 70.86
最近更新 2026-05-17 11:04:43
分类：生活依赖：代码执行 / 第三方 API应用场景：旅行 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add aviationstack-flight-tracker
Metadata
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'
  3. 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:

  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)