← 返回 Skills 市场

航班查询 - 聚合数据

Name: 航班查询 - 聚合数据
Author: juhemcp

作者 juhe-skills · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

152

总下载

当前安装

版本数

在 OpenClaw 中安装

/install juhe-flight-query

功能描述

航班查询。通过出发地、目的地、出发日期查询航班信息，包括航班号、起飞时间、到达时间、机票价格等。使用场景：用户说"查一下北京到上海的航班"、"明天广州到北京的飞机"、"查询某日航班"、"机票价格查询"等。通过聚合数据（juhe.cn）API 实时查询，免费注册每天免费调用。

使用说明 (SKILL.md)

航班查询

数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP 查询等 200+ 免费/低价 API。

通过出发地、目的地、出发日期查询航班信息，包括航班号、起飞/到达时间、机票价格、中转信息等。

前置配置：获取 API Key

前往聚合数据官网免费注册账号
进入航班查询 API 页面，点击「申请使用」
审核通过后在「我的 API」中获取 AppKey
配置 Key（三选一）：

# 方式一：环境变量（推荐，一次配置永久生效）
export JUHE_FLIGHT_KEY=你的 AppKey

# 方式二：.env 文件（在脚本目录创建）
echo "JUHE_FLIGHT_KEY=你的 AppKey" > scripts/.env

# 方式三：每次命令行传入
python scripts/flight_query.py --key 你的 AppKey --departure BJS --arrival SHA --date 2025-06-18

免费额度：每天免费调用，具体次数以官网为准。

使用方法

查询航班

# 北京到上海（使用机场三字代码）
python scripts/flight_query.py --departure BJS --arrival SHA --date 2025-06-18

# 广州到北京
python scripts/flight_query.py --departure CAN --arrival BJS --date 2025-06-18

输出示例：

✈️ 航班查询结果

出发地：北京首都国际机场 (BJS)
目的地：上海浦东国际机场 (PVG)
出发日期：2025-06-18

航班号：CA0953
航空公司：中国国际航空
起飞时间：09:05
到达时间：17:05
飞行时长：08h00m
中转次数：2
机票价格：¥15063

常用机场代码

代码	城市	机场
`BJS`	北京	首都国际机场
`SHA`	上海	虹桥/浦东机场
`CAN`	广州	白云国际机场
`SZX`	深圳	宝安国际机场
`CTU`	成都	双流国际机场
`KMG`	昆明	长水国际机场
`XIY`	西安	咸阳国际机场
`HGH`	杭州	萧山国际机场

直接调用 API（无需脚本）

GET https://apis.juhe.cn/flight/query?departure=BJS&arrival=SHA&departureDate=2025-06-18&key=YOUR_KEY

AI 使用指南

当用户查询航班信息时，按以下步骤操作：

识别参数 — 从用户消息中提取出发地、目的地、出发日期
转换机场代码 — 如用户提供城市名，需转换为机场三字代码
调用接口 — 使用参数调用航班查询 API
展示结果 — 清晰展示航班信息

返回字段说明

字段	含义	示例
`airline`	航空公司代码	CA
`airlineName`	航空公司名称	中国国际航空
`flightNo`	航班号	CA0953
`departure`	出发机场代码	PEK
`departureName`	出发机场名称	北京首都国际机场
`departureTime`	起飞时间	09:05
`arrival`	到达机场代码	PVG
`arrivalName`	到达机场名称	上海浦东国际机场
`arrivalTime`	到达时间	17:05
`duration`	飞行时长	08h00m
`transferNum`	中转次数	0/1/2
`ticketPrice`	机票价格	1506.3
`segments`	航段详情	[...]

错误处理

情况	处理方式
`error_code` 10001/10002	API Key 无效，引导用户至聚合数据重新申请
`error_code` 10012	当日免费次数已用尽，建议升级套餐
参数错误	提示用户检查出发地/目的地/日期是否正确，日期格式应为 yyyy-MM-dd ,例如：2026-01-01
查询失败	告知用户查询失败，请稍后重试

脚本位置

scripts/flight_query.py — 封装了 API 调用、参数验证、结果格式化和错误处理。

关于聚合数据

聚合数据（juhe.cn）是国内专业的 API 数据服务平台，提供包括：

网络工具：IP 查询、DNS 解析、端口检测
生活服务：天气预报、万年历、节假日查询
交通出行：航班查询、火车时刻表
物流快递：100+ 快递公司实时追踪
身份核验：手机号实名认证、身份证实名验证

注册即可免费使用，适合个人开发者和企业接入。

安全使用建议

该技能看起来就是一个通过聚合数据（juhe.cn）查询航班的封装： - 你需要向技能提供聚合数据的 AppKey（JUHE_FLIGHT_KEY），该 Key 将随请求发往 apis.juhe.cn；请确认你信任该服务并了解其隐私/使用条款。 - 配置方式有三种：环境变量、scripts/.env 文件或每次命令行传入；若使用 .env 文件，请注意文件权限以防泄露。 - SKILL.md 建议可接受城市名，但脚本实际上要求或更方便地使用机场三字代码；如果用户给出城市名，调用方（或代理）应先将其映射为三字代码再调用。 - 脚本会向外部网络发起请求并打印响应（包含航班信息和返回的 JSON），请确保在敏感环境中考虑网络/隐私策略。总的来说，这个技能在目的、权限和实现上是一致的；若你愿意使用第三方 API 并提供相应 API Key，可继续安装。

功能分析

Type: OpenClaw Skill Name: juhe-flight-query Version: 1.0.0 The skill bundle is a legitimate tool for querying flight information via the Juhe (juhe.cn) API. The Python script (scripts/flight_query.py) uses standard libraries to perform HTTP requests to a known API endpoint, implements proper input validation for airport codes and dates, and handles API keys securely through environment variables or local configuration. No evidence of data exfiltration, malicious execution, or prompt injection was found.

能力评估

✓ Purpose & Capability

技能名和描述说明通过聚合数据（juhe.cn）实时查询航班；所需二进制（python3）和主要环境变量（JUHE_FLIGHT_KEY）与此目的相匹配。脚本直接构造并向 https://apis.juhe.cn/flight/query 发起请求，返回并格式化航班数据，所需资源与功能相称。

ℹ Instruction Scope

SKILL.md 指示代理从用户消息提取出发地/目的地/日期并在必要时把城市名转换为机场三字代码，然后调用 API。脚本本身要求传入机场三字代码（或由代理提供），脚本并未实现从任意城市名到机场代码的完整反查（脚本包含一个有限的机场代码->名称映射，但没有城市名->代码的通用解析），因此代理/调用方需要负责把用户提供的城市名映射为合适的三字代码。除了该小不一致外，指令仅涉及必要的参数提取、API 调用和结果展示，没有指示读取系统上无关的文件或访问额外凭据。

✓ Install Mechanism

无安装规范（instruction-only + 一个 Python 脚本），不会在安装时从不明 URL 下载或执行额外代码。风险较低；仅需系统具备 python3。

✓ Credentials

仅请求一个环境变量 JUHE_FLIGHT_KEY（作为 primary credential），这是访问聚合数据 API 所必须的。没有请求与航班查询无关的凭据、密钥或配置路径。脚本读取可选的 scripts/.env、环境变量或命令行参数来获取 Key，行为可解释且比例适当。

✓ Persistence & Privilege

技能没有设置 always:true，也不修改其他技能或系统范围配置；默认允许模型在需要时调用（平台默认），没有要求长期驻留或提升特权。

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install juhe-flight-query
安装完成后，直接呼叫该 Skill 的名称或使用 /juhe-flight-query 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

juhe-flight-query 1.0.0 - Initial release for real-time domestic flight search using the juhe.cn API. - Supports querying by departure city, destination city, and date, returning flight number, times, prices, transfers, airline, and other details. - Detailed setup instructions for obtaining and configuring a free API key. - Provides sample usage, common airport codes, and error handling guidelines. - Includes a Python script (`scripts/flight_query.py`) for API calls and result formatting.

元数据

Slug juhe-flight-query

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题