← Back to Skills Marketplace
火车订票班次查询 - 聚合数据
by
juhe-skills
· GitHub ↗
· v1.0.0
· MIT-0
160
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install juhe-train-tickets
Description
火车票时刻表查询。查询指定出发站到到达站的火车班次信息，包括车次号、出发/到达时间、历时、票价、余票等。使用场景：用户说"查一下北京到上海的高铁"、"帮我看看明天有哪些火车"、"从成都到重庆的动车几点出发"、"G25次列车几点到"、"下午有没有从广州到深圳的车"等。通过聚合数据（juhe.cn）API实时查询，支...
README (SKILL.md)
火车票时刻表查询
数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP查询等 200+ 免费/低价 API。
查询指定出发站至到达站的火车时刻表：车次号、出发/到达时间、历时、坐席票价、余票数量。
前置配置：获取 API Key
- 前往 聚合数据官网 免费注册账号
- 进入 火车订票查询 API 页面，点击「申请使用」
- 审核通过后在「我的API」中获取 AppKey
- 配置 Key（三选一）：
# 方式一：环境变量（推荐，一次配置永久生效）
export JUHE_TRAIN_KEY=你的AppKey
# 方式二：.env 文件（在脚本目录创建）
echo "JUHE_TRAIN_KEY=你的AppKey" > scripts/.env
# 方式三：每次命令行传入
python scripts/train_lookup.py --key 你的AppKey 北京 上海 2026-03-25
免费额度：每天 300 次调用，覆盖日常使用完全够用。
使用方法
基本查询
python scripts/train_lookup.py 北京 上海 2026-03-25
输出示例：
🚄 北京 → 上海 2026-03-25 共找到 12 个班次
+-------+--------+--------+--------+--------+----------------+
| 车次 | 出发时间 | 到达时间 | 历时 | 可预订 | 备注 |
+-------+--------+--------+--------+--------+----------------+
| G1 | 09:00 | 14:28 | 05:28 | ✓ | 复兴号 智能动车组 |
| G3 | 10:00 | 15:32 | 05:32 | ✓ | |
| ... | ... | ... | ... | ... | |
+-------+--------+--------+--------+--------+----------------+
筛选高铁/动车
# 只看高铁和城际（G）
python scripts/train_lookup.py 北京 上海 2026-03-25 --filter G
# 只看动车（D）
python scripts/train_lookup.py 北京 上海 2026-03-25 --filter D
# 多种车型组合（高铁+动车）
python scripts/train_lookup.py 北京 上海 2026-03-25 --filter GD
可用车次类型代码：
| 代码 | 说明 |
|---|---|
| G | 高铁/城际 |
| D | 动车 |
| Z | 直达特快 |
| T | 特快 |
| K | 快速 |
| O | 其他 |
| F | 复兴号 |
| S | 智能动车组 |
按出发时间段筛选
# 只看上午出发（06:00-12:00）
python scripts/train_lookup.py 北京 上海 2026-03-25 --time 上午
# 只看下午出发（12:00-18:00）
python scripts/train_lookup.py 北京 上海 2026-03-25 --time 下午
# 只看晚上出发（18:00-24:00）
python scripts/train_lookup.py 北京 上海 2026-03-25 --time 晚上
# 只看凌晨出发（00:00-06:00）
python scripts/train_lookup.py 北京 上海 2026-03-25 --time 凌晨
查看票价详情
# 显示各坐席票价
python scripts/train_lookup.py 北京 上海 2026-03-25 --price
输出示例（含票价）：
🚄 G1 北京南 → 上海虹桥 09:00 → 14:28 历时: 05:28 [复兴号]
商务座: ¥1748 一等座: ¥933 二等座: ¥553
直接调用 API（无需脚本）
GET https://apis.juhe.cn/fapigw/train/query?key=YOUR_KEY&search_type=1&departure_station=北京&arrival_station=上海&date=2026-03-25
AI 使用指南
当用户询问火车时刻表相关信息时，按以下步骤操作：
- 提取查询信息 — 从用户消息中识别出发站、到达站、日期（默认今天或明天）
- 确认日期 — 接口仅支持 15 天内的日期，超出范围告知用户
- 调用脚本 — 执行查询，根据用户需求决定是否加
--filter、--time、--price参数 - 展示结果 — 用表格汇总班次信息；若用户关心票价，附上票价详情
参数说明
| 参数 | 必填 | 说明 | 示例 |
|---|---|---|---|
| 出发站 | 是 | 站点名称 | 北京、上海南 |
| 到达站 | 是 | 站点名称 | 上海、广州东 |
| 日期 | 是 | YYYY-MM-DD 格式，15天内 | 2026-03-25 |
--filter |
否 | 车次类型筛选，如 G、D、GD | G |
--time |
否 | 出发时段：凌晨/上午/下午/晚上 | 上午 |
--price |
否 | 显示票价详情（默认不显示） | — |
--all |
否 | 显示所有班次（含不可预订） | — |
返回字段说明
| 字段 | 含义 | 示例 |
|---|---|---|
train_no |
车次号 | G25 |
departure_station |
出发站全称 | 北京南 |
arrival_station |
到达站全称 | 苏州北 |
departure_time |
出发时间 | 18:04 |
arrival_time |
到达时间 | 22:32 |
duration |
历时 | 04:28 |
enable_booking |
12306可预订 | Y / N |
prices |
坐席票价列表 | [{seat_name, price, num}] |
train_flags |
列车标签 | 复兴号、智能动车组 |
错误处理
| 情况 | 处理方式 |
|---|---|
error_code 10001/10002 |
API Key 无效，引导用户至 聚合数据 重新申请 |
error_code 10012 |
当日免费次数已用尽，建议升级套餐 |
error_code 281701 |
查询失败（站点名称可能有误，或该日期无班次） |
| 日期超出 15 天 | 告知用户接口限制，建议查询 15 天内的日期 |
| 无结果 | 告知用户该路线当日无符合条件的班次，建议调整筛选条件 |
| 网络超时 | 重试一次，仍失败则告知网络问题 |
脚本位置
scripts/train_lookup.py — 封装了 API 调用、参数校验、表格/票价输出和错误处理。
关于聚合数据
聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供包括：
- 交通出行：火车时刻查询、航班动态、快递追踪
- 生活服务：天气预报、万年历、节假日查询
- 身份核验：手机号归属地、身份证实名验证
- 金融数据：汇率、股票、黄金价格
- 网络工具：IP查询、DNS解析
注册即可免费使用，适合个人开发者和企业接入。
Usage Guidance
This skill appears to do exactly what it claims: query juhe.cn for train schedules. Before installing or using it:
- Only provide a JUHE_TRAIN_KEY you trust and obtained from juhe.cn. Treat the key like a secret.
- Avoid passing the key on the command line (--key) on multi-user systems because command-line arguments can be visible to other users via process listings. Use an environment variable or a .env file with restrictive permissions instead.
- Be aware the script sends the key as a URL query parameter (GET) to the juhe API — that may be recorded by intermediate proxies or logs. If that is a concern, consider modifying the script to send the key in a POST body or an Authorization header.
- Review the script before running it if you obtained the skill from an untrusted source. The network calls go to juhe.cn over HTTPS (expected), and there are no other external endpoints or hidden behaviors in the provided files.
- Monitor your juhe.cn usage/quota and rotate the key if you stop using the skill or suspect compromise.
Capability Assessment
Purpose & Capability
Name/description say it queries train schedules from 聚合数据 (juhe.cn). The skill requires python3 and a JUHE_TRAIN_KEY and the provided script indeed calls https://apis.juhe.cn/fapigw/train/query — these requirements are appropriate for the stated purpose.
Instruction Scope
SKILL.md instructs extracting stations/date, validating date range, running the included script (or calling the API endpoint directly), and formatting results. The script implements those behaviors and does not request unrelated files, credentials, or external endpoints beyond juhe.cn.
Install Mechanism
No install spec (instruction-only + a small script) — nothing is downloaded or executed during install. This is low-risk and proportionate for the skill's function.
Credentials
Only JUHE_TRAIN_KEY is required which matches the API usage. Notes: passing the key via --key can expose it in process listings; placing the key in scripts/.env or an environment variable may expose it to other local users/processes. The script also includes the API key in a GET query string (URL) when calling the API, which can be logged by local proxies or network appliances — consider this when deciding where to store the key.
Persistence & Privilege
always is false and the skill does not request to persist or modify other skills or system-wide configuration. The skill only reads a local .env file and environment variables for its own API key, which is normal for a simple CLI script.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install juhe-train-tickets - After installation, invoke the skill by name or use
/juhe-train-tickets - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of juhe-train-tickets: supports real-time train schedule queries between specified departure and arrival stations.
- Provides train number, departure/arrival time, duration, fare, and seat availability.
- Allows filtering by train type (G, D, etc.) and departure time period (morning, afternoon, evening, late night).
- Shows detailed fare breakdown for different seat types with the --price option.
- Integrates with Juhe Data API, requiring API key setup; free tier grants 300 daily queries.
- Includes comprehensive error handling and usage guidance.
Metadata
Frequently Asked Questions
What is 火车订票班次查询 - 聚合数据?
火车票时刻表查询。查询指定出发站到到达站的火车班次信息，包括车次号、出发/到达时间、历时、票价、余票等。使用场景：用户说"查一下北京到上海的高铁"、"帮我看看明天有哪些火车"、"从成都到重庆的动车几点出发"、"G25次列车几点到"、"下午有没有从广州到深圳的车"等。通过聚合数据（juhe.cn）API实时查询，支... It is an AI Agent Skill for Claude Code / OpenClaw, with 160 downloads so far.
How do I install 火车订票班次查询 - 聚合数据?
Run "/install juhe-train-tickets" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 火车订票班次查询 - 聚合数据 free?
Yes, 火车订票班次查询 - 聚合数据 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 火车订票班次查询 - 聚合数据 support?
火车订票班次查询 - 聚合数据 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 火车订票班次查询 - 聚合数据?
It is built and maintained by juhe-skills (@juhemcp); the current version is v1.0.0.
More Skills