法航航班追踪

技能简介

连接 Air France–KLM 开放数据 API，实现航班状态查询、持续监控与变更提醒。支持按航班号与日期检索起降信息、登机口变动、机型及尾号，并追踪前序航班链以预判延误风险。

业务背景

面向差旅管理与出行服务场景，提供法航航班全链路动态追踪能力。通过对接官方开放数据，实现从行前规划到落地抵达的自动化监控，帮助用户及时掌握延误风险与设施变更信息，优化行程安排与升舱决策时机。

落地案例：企业差旅平台为高管预订巴黎往返航班后，系统自动按航班号与日期发起监控。起飞前12小时检测到前序航班延误90分钟，触发预警通知并建议备选方案；登机口临时变更时再次推送更新，确保接机方同步调整。全程遵守每秒1次的API调用限制，无状态变化时不产生冗余通知。

能做什么

• 查询指定日期的航班实时状态（计划/实际起降时间、登机口、航站楼）
• 监控航班动态，在延误、取消、登机口变更或机型调整时自动推送通知
• 追溯前序航班链条，评估当前航班受前段延误影响的可能性
• 通过飞机尾号推断客舱配置年代与 Wi-Fi 可用性，辅助升舱决策

使用说明

1. 获取 API 凭证

1. 访问 developer.airfranceklm.com 注册账号
2. 订阅 Open Data 产品中的 Flight Status API
3. 生成 API Key（部分账号同时提供 API Secret）

2. 配置凭证（二选一）

• 环境变量：设置 AFKL_API_KEY 及可选的 AFKL_API_SECRET
• 文件方式：在状态目录（CLAWDBOT_STATE_DIR 或 ./state）创建 afkl_api_key.txt，权限设为 600；如有 Secret 则另建 afkl_api_secret.txt

3. 单次查询

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

注意：请求频率须 ≤ 1 次/秒，多调用时间隔约 1100 毫秒。

4. 启动持续监控

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

默认轮询策略：起飞前 36 小时以上每 60 分钟、36–12 小时每 30 分钟、12–3 小时每 15 分钟、最后 3 小时每 5–10 分钟、起飞后每 30 分钟直至到达。脚本通过状态文件自节流，无变更时不输出，便于配合 cron 仅在有更新时发送通知。

输入与输出

见下方输入与输出表格。

风险提示

• API 存在速率限制（≤1 请求/秒），超限可能导致临时封禁
• Open Data 不保证座位级客舱细节，机型推断为尽力而为，存在误差
• 跨午夜长途航班的日期解析需明确出发地时区，否则可能产生歧义
• API 返回格式为 HAL+JSON，需正确处理 Accept: */* 头

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/iclems/airfrance-afkl/SKILL.md
来源类型：GitHub 仓库