variflight

✈️ 实时航班火车一站式查询

基于飞常准官方 API,提供航班动态、火车票查询及机场天气等一站式出行数据服务,助力智能行程规划。

收藏
3.9k
安装
825
版本
v1.0.1
CLS 安全性认证2026-05-03
点击查看完整报告 >

使用说明

Variflight(飞常准)Skill 是一款专为 AI 助手和开发者设计的出行数据查询工具,通过调用飞常准官方 HTTP API,提供航班信息、火车票、机场天气等一站式旅行数据服务。该工具以纯 Python 标准库实现,支持多种配置方式,可无缝集成到各类开发环境和 CI/CD 流程中。

核心用法:该 Skill 通过 https://ai.variflight.com/api/v1/mcp/data 端点提供 9 类核心功能,包括按航线或航班号查询航班、获取实时航班状态与准点率、查询火车票信息、获取机场天气预报、检索航班价格、规划多式联运行程以及查询航班舒适度指标(幸福指数)。用户可通过环境变量、配置文件(JSON 格式)或命令行参数三种方式配置 API Key,支持 Shell 脚本直接调用或集成到 Claude Code、Cursor、GitHub Actions 及 Docker 等开发环境中。

显著优点:首先,技术实现轻量安全,仅依赖 Python 标准库(urllib、json、os 等),无外部依赖包,避免了供应链攻击风险。其次,配置灵活度高,支持项目级、用户级及 XDG 标准路径的配置文件,同时兼容环境变量和命令行传参,适应不同部署场景。第三,功能覆盖全面,不仅支持国内主流机场(如 PEK、PVG、CAN 等)的航班查询,还整合了火车票查询、机场天气、航班舒适度评估等特色功能,满足多模态出行规划需求。第四,集成友好,专为 OpenClaw 优化,提供开箱即用的 Shell 脚本封装,错误处理完善且不暴露敏感信息。

潜在缺点与局限性:作为 T3 来源的社区项目,非飞常准官方直接维护,长期维护稳定性和功能更新存在一定不确定性。功能上依赖外部网络环境,无法在内网或离线环境使用。此外,API 调用需要用户自行申请并配置 Key,对于无技术背景的用户存在使用门槛。输入验证仅覆盖基础必填项,缺乏严格的日期格式和机场代码白名单校验,可能导致无效请求。

适合的目标群体:主要面向开发者和技术团队,特别是需要集成航班数据到 AI 助手、聊天机器人或自动化工作流的场景。适合构建旅行规划类应用、企业差旅管理系统、航班监控告警系统的后端支持。同时也适用于个人开发者进行旅行数据分析、价格监控等 side project 开发。

使用风险:性能方面,受限于飞常准 API 的响应速度和可用性,高峰期可能出现延迟。安全层面,虽代码本身安全,但 T3 来源意味着需关注仓库更新和维护者变更风险。网络依赖性强,若目标域名访问受限或 API 服务调整,功能将完全不可用。API Key 管理需用户自行负责,存在配置泄露风险,建议配合密钥管理系统使用。

安全解读

核心用法

Variflight Skill 通过官方 HTTP API 提供航班、铁路及旅行数据查询能力。支持按航线或航班号搜索航班、查询实时状态与准点率、获取机场天气预报、比价机票、规划空铁联运,以及查询「飞行舒适度指数」。配置方式灵活,支持环境变量、配置文件或命令行参数传入 API Key。

主要功能场景:

  • 航班搜索(按起降机场或航班号)
  • 飞机实时位置追踪
  • 机场未来天气预报
  • 火车票查询与中转方案
  • 航班舒适度评分(happiness index)

显著优点

1. 零依赖架构:纯 Python 标准库实现,无第三方包,供应链攻击面极小
2. 配置安全规范:API Key 通过环境变量或配置文件读取,拒绝硬编码

3. 多场景覆盖:航空+铁路+天气的多模态出行数据一站式解决

4. 轻量易集成:提供 Shell 脚本封装,兼容 OpenClaw、Claude Code、Cursor 等主流 Agent 框架

潜在缺点与局限性

  • 来源可信度待提升:T3 级别(个人开发者维护),GitHub 仓库当前不可访问,长期维护存在不确定性
  • 外部 API 依赖:需稳定网络连接至 ai.variflight.com,国内网络环境偶有波动
  • 功能边界:仅支持查询类操作,无法完成预订、值机等交易动作
  • 数据覆盖:部分小众航线或国际航班数据可能不如头部 OTA 平台全面

适合人群

  • 商旅人士需高频查询航班动态与准点率
  • 开发者构建智能行程助手或差旅管理工具
  • 需要空铁联运规划的多城市通勤用户
  • 关注飞行舒适度(机型、座位、准点历史)的挑剔旅客

常规风险

  • API Key 泄露风险:若误将配置文件提交至代码仓库,可能导致 Key 被盗用
  • 服务连续性风险:T3 来源项目,若维护者停止更新,可能存在功能失效隐患
  • 数据时效性:航班动态依赖官方数据推送,极端天气或突发事件下可能存在分钟级延迟
  • 隐私合规:查询行为会上传至 Variflight 服务器,敏感行程需注意数据主权问题

variflight 内容

scripts文件夹
手动下载zip · 10.7 kB
flight.shtext/x-shellscript
请选择文件