航班查询 - 聚合数据

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

Security Scan

该技能的声明、所需权限和代码实现总体一致：它使用聚合数据 (juhe.cn) 的航班查询 API，唯一必要凭据是 JUHE_FLIGHT_KEY，脚本以 python3 运行并直接调用 apis.juhe.cn 接口，没有发现可疑或隐蔽的网络目标或权限越界。

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，也不修改其他技能或系统范围配置；默认允许模型在需要时调用（平台默认），没有要求长期驻留或提升特权。

Assessment

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

航班查询

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

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

---

前置配置：获取 API Key

1. 前往 聚合数据官网 免费注册账号
2. 进入 航班查询 API 页面，点击「申请使用」
3. 审核通过后在「我的 API」中获取 AppKey
4. 配置 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 使用指南

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

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

返回字段说明

字段	含义	示例
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+ 快递公司实时追踪
• 身份核验：手机号实名认证、身份证实名验证

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