Planefilter

透過 Node.js 腳本查詢指定航班號的機型與註冊號，並行呼叫 OpenSky、AeroDataBox（RapidAPI）與選用的 AirLabs，以加權投票計算信心分數、偵測機型更換，並輸出 JSON；另有健康檢查腳本確認金鑰與資料來源可用。

iml1s

热度 78.86

最近更新 2026-05-11 17:35:07

分类：搜索依赖：代码执行 / 第三方 API应用场景：旅行 / 研究

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add planefilter

Metadata

name: planefilter
description: Aviation flight lookup — query aircraft type, equipment changes, and confidence scoring for any flight number. Use when: looking up flight aircraft, checking equipment change, querying flight data, asking what plane a flight uses. Triggers on: flight lookup, aircraft type, what plane, 查機型, 航班查詢, equipment change, plane filter, flight number, CI101, 飛機型號.
homepage: https://github.com/ImL1s/planefilter-openclaw-skill
metadata: {"openclaw":{"emoji":"✈️","primaryEnv":"RAPIDAPI_KEY","requires":{"bins":["node"],"env":["RAPIDAPI_KEY"]},"install":[{"id":"node-brew","kind":"brew","formula":"node","bins":["node"],"label":"Install Node.js (brew)"}]}}

PlaneFilter — Flight Aircraft Type Lookup

Look up aircraft type, equipment changes, and confidence scoring for any flight by querying multiple aviation data sources (OpenSky, AeroDataBox, AirLabs) and merging results with weighted confidence scoring.

Prerequisites

Required

Node.js (v18+)
RAPIDAPI_KEY — Subscribe to AeroDataBox on RapidAPI (free Basic plan: 150 req/month)

Optional (more data sources)

AIRLABS_KEY — Get from AirLabs (free: 150 req/month)

Commands

1. Search Flight

node {baseDir}/scripts/search_flight.js --flight=CI101 [--date=2026-03-22]

Required env: RAPIDAPI_KEY Optional env: AIRLABS_KEY (adds another data source for higher confidence)

2. Health Check

node {baseDir}/scripts/health_check.js

Verifies all API keys are set and reachable. Shows which data sources are available.

Output Format

search_flight.js outputs JSON to stdout:

{
  "flightNumber": "CI101",
  "date": "2026-03-22",
  "airline": "China Airlines",
  "origin": "NRT",
  "destination": "TPE",
  "aircraftType": "A333",
  "registration": "B-18311",
  "confidence": 0.6,
  "equipmentChange": null,
  "typeDistribution": { "A333": 1 },
  "sources": ["aerodatabox"]
}

Output Interpretation

When presenting results to the user, follow these rules:

Field	How to Interpret
`confidence` ≥ 0.8	High confidence — present the aircraft type directly
`confidence` 0.5–0.8	Medium — mention "likely" or "most probable"
`confidence` < 0.5	Low — warn that data is uncertain, show `typeDistribution`
`equipmentChange` not null	⚠️ Important — Highlight this! The actual aircraft differs from the scheduled one. Show `from`, `to`, and `changeType` (upgrade/downgrade/lateral)
`typeDistribution`	Shows agreement across sources. Multiple entries = sources disagree
`sources` empty	No data found — suggest trying a different date

Note on aircraft type codes: The script automatically normalizes model names (e.g. "Airbus A330-300" → "A333") and filters invalid typecodes. In rare cases, an unrecognized model name may pass through as-is.

How It Works

Parallel query — Hits OpenSky (free, no key) + AeroDataBox (RapidAPI) + AirLabs (optional) simultaneously
Confidence scoring — Weighted votes from each source (AeroDataBox 0.9, OpenSky 0.7, AirLabs 0.6)
Equipment change detection — If scheduled aircraft ≠ actual aircraft, classifies as Upgrade/Downgrade/Lateral

Troubleshooting

Error	Cause	Fix
`RAPIDAPI_KEY not set`	Missing env var	`export RAPIDAPI_KEY=your_key` or set in `~/.openclaw/openclaw.json`
`403 from AeroDataBox`	Invalid or expired key	Check your RapidAPI subscription
`No flight data found`	Flight not in any database	Try with a different date or a major airline flight