airfrance-afkl

⚠Review·Scanned 2/18/2026

Tracks Air France flights using Air France–KLM Open Data and enrichment from public sources. The skill reads credentials from AFKL_API_KEY/AFKL_API_SECRET or afkl_api_key.txt/afkl_api_secret.txt, runs node scripts, and calls https://api.airfranceklm.com and https://api.planespotters.net.

from clawhub.ai·v5930167·35.9 KB·0 installs
Scanned from 1.0.1 at 5930167 · Transparency log ↗
$ vett add clawhub.ai/iclems/airfrance-afklReview findings below

airfrance-afkl-skill

Clawdbot skill to track Air France flights using the Air France–KLM Open Data APIs (Flight Status).

It’s designed for day-to-day travel monitoring:

  • Flight status + schedule vs latest published times
  • Terminal / gate (when published)
  • Boarding close time (when available)
  • Aircraft tail number + cabin configuration summary (best-effort)
  • Previous-flight chain (useful to estimate delay risk)
  • Compact alerts: you only get pinged when displayed fields change

Prerequisites

  1. Register and create an API key on the AFKL developer portal:
  1. Subscribe to Open Data products (at least Flight Status API).

Configuration

Provide credentials via environment variables (recommended):

export AFKL_API_KEY="..."
# optional
export AFKL_API_SECRET="..."

Or via files in your state dir:

  • Set CLAWDBOT_STATE_DIR to your state directory (or it falls back to ./state)
  • Create:
    • afkl_api_key.txt
    • afkl_api_secret.txt (optional)

Usage

One-off query

node skills/airfrance-afkl/scripts/afkl_flightstatus_query.mjs \
  --carrier AF --flight 7 --origin JFK --dep-date 2026-01-29

Watcher (poll + change-only output)

node skills/airfrance-afkl/scripts/afkl_watch_flight.mjs \
  --carrier AF --flight 7 --origin JFK --dep-date 2026-01-29 --prev-depth 2

Output behavior:

  • Prints nothing when nothing changed
  • Prints a ready-to-send multi-line message when something changed

The message is designed to be compact and human-readable:

  • Emojis for 🛫/🕤/🛬/✈️/📶
  • Weekday + date + time (to avoid timezone ambiguity)
  • Tail + aircraft type + cabin config summary
  • Wi‑Fi line (fast/slow) when available
  • Previous-flight chain summary (e.g. ↩️ Dubai → Paris → New York (on time))
  • Optional headline line highlighting what changed (new time, inbound delay, new aircraft, boarding started)

Rate limits

AFKL Open Data is rate-limited (commonly 1 request/second and a daily quota). The watcher is designed to be schedule-aware and to avoid unnecessary calls.

Notes / disclaimers

  • Aircraft “intel” (age, first flight, etc.) is best-effort and relies on public sources.
  • Cabin configuration identifiers can vary by fleet and may not guarantee the exact seat product.

License

MIT (recommended) — add a LICENSE file if you want.