中国铁路车票查询：mcporter CLI 技能 - Openclaw Skills

什么是 mcporter-railway-query？

mcporter-railway-query 技能提供了一个强大的命令行界面，用于与中国铁路 (12306) 数据进行交互。通过利用 Openclaw Skills，开发者可以以编程方式搜索整个中国铁路网的高铁选项，包括 G、D 和 C 类列车。

该工具专门设计用于通过绕过传统 Web 界面来简化出行规划。它支持按出发时间和列车类型进行精确过滤，是构建自动化出行助手或基于终端的生产力工作流用户的必备组件。

下载入口:https://github.com/openclaw/skills/tree/main/skills/lancenas/mcporter-railway-query

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install mcporter-railway-query

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 mcporter-railway-query。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

mcporter-railway-query 应用场景

• 搜索中国特定城市之间的高铁余票（G/D/C）。
• 根据城市名称获取官方铁路车站代码。
• 过滤列车时刻表以查找特定时间段内的出发班次（例如：仅限下午的列车）。
• 将实时车票数据导出为 JSON 或 CSV 格式，用于数据分析或自定义通知。

mcporter-railway-query 工作原理

1. 用户使用车站代码查询工具获取必要的车站代码（例如：上海为 SHH）。
2. 通过 mcporter CLI 发送查询请求，指定行程日期、起点和终点。
3. 该技能与 12306 MCP 服务器交互以获取实时余票和时刻数据。
4. 根据用户定义的参数（如列车类型或时间范围）对结果进行过滤，并以指定格式返回。

mcporter-railway-query 配置指南

要开始使用此技能，请确保已安装并配置 mcporter CLI：

# 全局安装 mcporter
npm install -g mcporter

# 在配置文件中配置您的 12306 MCP 服务器设置
# 默认位置：~/.mcporter/mcporter.json

mcporter-railway-query 数据架构与分类体系

该技能利用结构化参数集来查询铁路数据库。以下是 Openclaw Skills 集成中使用的核心字段：

参数	类型	描述
date	string	必填。格式：YYYY-MM-DD
fromStation	string	必填。始发站代码（如 AOH）
toStation	string	必填。终点站代码（如 HZH）
trainFilterFlags	string	按列车类型过滤（G, D 或 GD）
format	string	输出格式：text, json 或 csv
earliestStartTime	number	时间窗口起点 (0-24)

name: mcporter-railway-query
description：通过 mcporter CLI 查询和预订中国铁路票务。适用于用户想要搜索 G/D/C 车票、查看列车时刻表、查询座位可用性或规划中国城市之间的铁路旅行。支持按日期、时间范围、列车类型进行筛选，并对结果进行排序。

mcporter Railway Ticket Query

使用 mcporter 命令行工具查询 12306 中国铁路车票信息。

Prerequisites

1. 安装 mcporter CLI
2. 配置 12306 MCP 服务器
3. 确认 mcporter.json 配置路径（默认 ~/.mcporter/mcporter.json）

Quick Start

1. 使用快捷脚本查询

# 查询下午班次 (12:00-18:00)
./scripts/query-afternoon.sh 2026-02-18 SHH KYH

# 查询全天班次
./scripts/query-tickets.sh 2026-02-18 AOH HZH

# 查询车站代码
./scripts/get-station-code.sh "上海虹桥"

2. 直接 mcporter 命令

# 基础查询
mcporter call 12306.get-tickets r
  date="2026-02-18" r
  fromStation="AOH" r
  toStation="HZH" r
  trainFilterFlags="GD" r
  --config ~/.mcporter/mcporter.json

# 下午班次
mcporter call 12306.get-tickets r
  date="2026-02-18" r
  fromStation="AOH" r
  toStation="HZH" r
  trainFilterFlags="GD" r
  earliestStartTime=12 r
  latestStartTime=18 r
  sortFlag="startTime" r
  --config ~/.mcporter/mcporter.json

Workflow

Step 1: 获取车站代码

不知道车站代码时：

mcporter call 12306.get-station-code-of-citys r
  citys="上海|杭州" r
  --config ~/.mcporter/mcporter.json

或查看参考表 station-codes.md

Step 2: 查询车票

mcporter call 12306.get-tickets r
  date="YYYY-MM-DD" r
  fromStation="出发站代码" r
  toStation="到达站代码" r
  [可选过滤参数] r
  --config ~/.mcporter/mcporter.json

Step 3: 解析结果

• 有票: "有票" 或显示剩余票数 "剩余X张票"
• 无票: "无票"
• *票: 特殊标记票

Parameters Reference

Common Station Codes

完整列表见 station-codes.md

Troubleshooting

mcporter not found

npm install -g mcporter

12306 MCP 未配置

创建 ~/.mcporter/mcporter.json 配置文件。

查询无结果

• 确认车站代码正确
• 确认日期格式为 YYYY-MM-DD
• 检查 mcporter.json 路径

Examples

更多查询示例见 query-examples.md