{"id":"a94af679-2449-4d11-88b6-37b2c8f59b59","entityType":"agent","slug":"clawhub-lancenas-mcporter-railway-query-repo","name":"Mcporter Railway Query Repo","canonicalUrl":"https://www.xpersona.co/agent/clawhub-lancenas-mcporter-railway-query-repo","canonicalPath":"/agent/clawhub-lancenas-mcporter-railway-query-repo","generatedAt":"2026-10-10T07:21:17.140Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat availability, or plan rail travel between Chinese cities. Supports filtering by date, time range, train type, and sorting results. Skill: Mcporter Railway Query Repo Owner: Lancenas Summary: Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat availability, or plan rail travel between Chinese cities. Supports filtering by date, time range, train type, and sorting results. Tags: latest:1.0.2 Version history: v1.0.2 | 2026-02-12T05:48:13.188Z |","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 689 downloads reported by the source. Last updated 4/15/2026.","installCommand":"clawhub skill install kn7473nwmwpv2j47ck4x8z7ead80zt96:mcporter-railway-query-repo","sourceUrl":"https://clawhub.ai/Lancenas/mcporter-railway-query-repo","homepage":"https://clawhub.ai/Lancenas/mcporter-railway-query-repo","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/Lancenas/mcporter-railway-query-repo","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":57,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat av"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"stars":null,"forks":null,"downloads":689,"packageName":null,"latestVersion":"1.0.2","tractionLabel":"689 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-03-01T03:08:03.115Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-03-01T03:08:03.115Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-02T03:08:03.115Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.2","createdAt":"2026-02-12T05:48:13.188Z","changelog":"- Updated documentation in README.md and README_zh.md. - No changes to functionality or code; documentation only.","fileCount":10,"zipByteSize":9254},{"version":"1.0.1","createdAt":"2026-02-12T05:37:03.136Z","changelog":"- Added SECURITY.md to provide security-related information. - Updated README.md and README_zh.md with documentation improvements. - No functional changes to code or interface.","fileCount":10,"zipByteSize":8813},{"version":"1.0.0","createdAt":"2026-02-11T05:39:14.738Z","changelog":"Initial release of mcporter-railway-query skill. - Enables querying and booking Chinese railway tickets via 12306 using mcporter CLI. - Supports searching G/D/C train tickets, checking train schedules, and querying seat availability. - Filtering available by date, time range, train type, and sorting options. - Includes workflow guides, station code lookup, parameter references, and troubleshooting. - Provides example scripts and command-line usage for quick start.","fileCount":null,"zipByteSize":null}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install kn7473nwmwpv2j47ck4x8z7ead80zt96:mcporter-railway-query-repo","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lancenas-mcporter-railway-query-repo/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lancenas-mcporter-railway-query-repo/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lancenas-mcporter-railway-query-repo/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lancenas-mcporter-railway-query-repo/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lancenas-mcporter-railway-query-repo/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lancenas-mcporter-railway-query-repo/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T07:21:17.139Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lancenas-mcporter-railway-query-repo/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lancenas-mcporter-railway-query-repo/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lancenas-mcporter-railway-query-repo/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lancenas-mcporter-railway-query-repo/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"Skill: Mcporter Railway Query Repo\n\nOwner: Lancenas\n\nSummary: Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat availability, or plan rail travel between Chinese cities. Supports filtering by date, time range, train type, and sorting results.\n\nTags: latest:1.0.2\n\nVersion history:\n\nv1.0.2 | 2026-02-12T05:48:13.188Z | auto\n\n- Updated documentation in README.md and README_zh.md.\n- No changes to functionality or code; documentation only.\n\nv1.0.1 | 2026-02-12T05:37:03.136Z | auto\n\n- Added SECURITY.md to provide security-related information.\n- Updated README.md and README_zh.md with documentation improvements.\n- No functional changes to code or interface.\n\nv1.0.0 | 2026-02-11T05:39:14.738Z | auto\n\nInitial release of mcporter-railway-query skill.\n\n- Enables querying and booking Chinese railway tickets via 12306 using mcporter CLI.\n- Supports searching G/D/C train tickets, checking train schedules, and querying seat availability.\n- Filtering available by date, time range, train type, and sorting options.\n- Includes workflow guides, station code lookup, parameter references, and troubleshooting.\n- Provides example scripts and command-line usage for quick start.\n\nArchive index:\n\nArchive v1.0.2: 10 files, 9254 bytes\n\nFiles: README_zh.md (2690b), README.md (3020b), references/query-examples.md (2049b), references/station-codes.md (2108b), scripts/get-station-code.sh (703b), scripts/query-afternoon.sh (853b), scripts/query-tickets.sh (789b), SECURITY.md (464b), SKILL.md (3254b), _meta.json (146b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: mcporter-railway-query\ndescription: Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat availability, or plan rail travel between Chinese cities. Supports filtering by date, time range, train type, and sorting results.\n---\n\n# mcporter Railway Ticket Query\n\n使用 mcporter 命令行工具查询 12306 中国铁路车票信息。\n\n## Prerequisites\n\n1. 安装 mcporter CLI\n2. 配置 12306 MCP 服务器\n3. 确认 mcporter.json 配置路径（默认 ~/.mcporter/mcporter.json）\n\n## Quick Start\n\n### 1. 使用快捷脚本查询\n\n```bash\n# 查询下午班次 (12:00-18:00)\n./scripts/query-afternoon.sh 2026-02-18 SHH KYH\n\n# 查询全天班次\n./scripts/query-tickets.sh 2026-02-18 AOH HZH\n\n# 查询车站代码\n./scripts/get-station-code.sh \"上海虹桥\"\n```\n\n### 2. 直接 mcporter 命令\n\n```bash\n# 基础查询\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  --config ~/.mcporter/mcporter.json\n\n# 下午班次\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n## Workflow\n\n### Step 1: 获取车站代码\n\n不知道车站代码时：\n\n```bash\nmcporter call 12306.get-station-code-of-citys \\\n  citys=\"上海|杭州\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n或查看参考表 [station-codes.md](references/station-codes.md)\n\n### Step 2: 查询车票\n\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"YYYY-MM-DD\" \\\n  fromStation=\"出发站代码\" \\\n  toStation=\"到达站代码\" \\\n  [可选过滤参数] \\\n  --config ~/.mcporter/mcporter.json\n```\n\n### Step 3: 解析结果\n\n- 有票: \"**有票**\" 或显示剩余票数 \"剩余X张票\"\n- 无票: \"无票\"\n- *票: 特殊标记票\n\n## Parameters Reference\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| date | string | 必填 | 日期格式 YYYY-MM-DD |\n| fromStation | string | 必填 | 出发站代码 (如 SHH) |\n| toStation | string | 必填 | 到达站代码 (如 KYH) |\n| trainFilterFlags | string | \"\" | G=高铁, D=动车, GD=高铁+动车 |\n| earliestStartTime | number | 0 | 最早出发时间 (0-24) |\n| latestStartTime | number | 24 | 最晚出发时间 (0-24) |\n| sortFlag | string | \"\" | startTime/arriveTime/duration |\n| sortReverse | boolean | false | 是否倒序 |\n| limitedNum | number | 0 | 限制结果数量 |\n| format | string | text | text/json/csv |\n\n## Common Station Codes\n\n| 城市 | 代码 | 城市 | 代码 |\n|------|------|------|------|\n| 上海 | SHH | 上海虹桥 | AOH |\n| 杭州东 | HZH | 无锡 | WXH |\n| 江阴 | KYH | 南京南 | NKH |\n\n完整列表见 [station-codes.md](references/station-codes.md)\n\n## Troubleshooting\n\n### mcporter not found\n```bash\nnpm install -g mcporter\n```\n\n### 12306 MCP 未配置\n创建 ~/.mcporter/mcporter.json 配置文件。\n\n### 查询无结果\n- 确认车站代码正确\n- 确认日期格式为 YYYY-MM-DD\n- 检查 mcporter.json 路径\n\n## Examples\n\n更多查询示例见 [query-examples.md](references/query-examples.md)\n\nFile v1.0.2:README.md\n\n# mcporter-railway-query\n\nAn OpenClaw skill for querying Chinese railway tickets via 12306 using mcporter CLI.\n\n## Overview\n\nThis skill provides tools to search for G/D/C train tickets, check train schedules, query seat availability, and plan rail travel between Chinese cities. It supports filtering by date, time range, train type, and sorting results.\n\n## Project Structure\n\nmcporter-railway-query/\n├── scripts/              # Shell helper scripts\n├── references/           # Station code reference\n├── README.md\n├── README_zh.md\n└── LICENSE\n\n## Prerequisites\n\n1. Install mcporter CLI: `npm install -g mcporter`\n2. Configure 12306 MCP server in `~/.mcporter/mcporter.json`\n    ```\n      {\n        \"mcpServers\": {\n           \"12306\": {\n              \"type\": \"sse\",\n               \"url\": \"http://127.0.0.1:8080/sse\",\n              \"name\": \"12306 高铁动车查询\",\n              \"description\": \"查询高铁（G开头）和动车（D开头）余票，支持出发站、到达站、日期、时间段过滤。只返回G/D车次。\",\n              \"enabled\": true\n            }\n        }\n     }\n    ```\n3. Ensure MCP server is running\n\n## Installation\n\nThis is an OpenClaw skill. Install using:\n\n```bash\nopenclaw skills install mcporter-railway-query.skill\n```\n\n## Usage\n\nThe skill provides several helper scripts:\n\n### Query afternoon trains (12:00-18:00)\n```bash\n./scripts/query-afternoon.sh 2026-02-18 SHH KYH\n```\n\n### Query all-day trains\n```bash\n./scripts/query-tickets.sh 2026-02-18 AOH HZH\n```\n\n### Get station codes\n```bash\n./scripts/get-station-code.sh \"上海虹桥\"\n```\n\n### Direct mcporter commands\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n## Features\n\n- Query train tickets with departure time filtering\n- Support for G (high-speed), D (bullet train), and C (city train) trains\n- Seat availability checking (商务座, 一等座, 二等座, etc.)\n- Station code lookup\n- Comprehensive station code reference table\n\n## Common Station Codes\n\n| Station | Code | Notes |\n|---------|------|-------|\n| 上海 | SHH | Shanghai Station |\n| 上海虹桥 | AOH | Shanghai Hongqiao Station |\n| 杭州东 | HZH | Hangzhou East Station |\n| 江阴 | KYH | Jiangyin Station |\n\nSee `references/station-codes.md` for the complete list.\n\n## License\n\nMIT\n\n## Security & Compliance\n\nThis project is a read-only OpenClaw skill that:\n\n- Does NOT collect user data\n- Does NOT store credentials\n- Does NOT perform ticket booking\n- Does NOT bypass 12306 authentication\n- Does NOT execute arbitrary system commands\n- Does NOT write to local file system\n- Does NOT open network listeners\n- Does NOT include obfuscated or encrypted code\n\nAll queries are executed through official 12306 MCP interfaces configured by the user.\n\nThis repository contains only helper scripts and configuration examples.\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7473nwmwpv2j47ck4x8z7ead80zt96\",\n  \"slug\": \"mcporter-railway-query-repo\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1770875293188\n}\n\nFile v1.0.2:references/query-examples.md\n\n# mcporter 火车票查询示例\n\n## 基础查询命令\n\n### 1. 查询车票\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-14\" \\\n  fromStation=\"SHH\" \\\n  toStation=\"KYH\" \\\n  trainFilterFlags=\"GD\" \\\n  sortFlag=\"startTime\" \\\n  format=\"text\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n### 2. 查询下午班次（12:00-18:00）\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-14\" \\\n  fromStation=\"SHH\" \\\n  toStation=\"KYH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n### 3. 查询指定车次详情\n```bash\nmcporter call 12306.get-train-route-stations \\\n  trainCode=\"G7134\" \\\n  departDate=\"2026-02-14\" \\\n  format=\"text\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n## 查询参数说明\n\n| 参数 | 说明 | 示例 |\n|------|------|------|\n| date | 日期 (YYYY-MM-DD) | \"2026-02-14\" |\n| fromStation | 出发站代码 | \"SHH\" |\n| toStation | 到达站代码 | \"KYH\" |\n| trainFilterFlags | 车次类型过滤 | \"G\"=高铁, \"D\"=动车, \"GD\"=高铁+动车 |\n| earliestStartTime | 最早出发时间 (0-24) | 12 |\n| latestStartTime | 最晚出发时间 (0-24) | 18 |\n| sortFlag | 排序方式 | \"startTime\" / \"arriveTime\" / \"duration\" |\n| sortReverse | 是否倒序 | true / false |\n| limitedNum | 限制返回数量 | 10 |\n| format | 输出格式 | \"text\" / \"json\" / \"csv\" |\n\n## 常用查询场景\n\n### 场景1: 上海虹桥到杭州东 下午高铁\n```bash\n./scripts/query-afternoon.sh 2026-02-18 AOH HZH\n```\n\n### 场景2: 上海到江阴 全天班次\n```bash\n./scripts/query-tickets.sh 2026-02-14 SHH KYH\n```\n\n### 场景3: 获取车站代码\n```bash\n./scripts/get-station-code.sh \"上海虹桥\"\n```\n\n## 配置说明\n\nmcporter 配置文件 `~/.mcporter/mcporter.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"12306\": {\n      \"type\": \"sse\",\n      \"url\": \"http://127.0.0.1:8080/sse\",\n      \"name\": \"12306 高铁动车查询\",\n      \"description\": \"查询高铁（G开头）和动车（D开头）余票\",\n      \"enabled\": true\n    }\n  }\n}\n```\n\nFile v1.0.2:references/station-codes.md\n\n# 12306 常用车站代码表\n\n## 上海地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 上海 | SHH | 上海站 |\n| 上海虹桥 | AOH | 虹桥火车站 |\n| 上海南 | SNH | 南站 |\n| 上海西 | SXH | 西站 |\n| 上海松江 | IMH | 松江南站/松江站 |\n| 金山北 | EGH | 金山北站 |\n\n## 江苏地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 江阴 | KYH | 江阴站 |\n| 无锡 | WXH | 无锡站 |\n| 无锡东 | WGH | 无锡东站 |\n| 无锡新区 | IFH | 无锡新区站 |\n| 惠山 | VCH | 惠山站 |\n| 常州 | CZH | 常州站 |\n| 南京 | NJH | 南京站 |\n| 南京南 | NKH | 南京南站 |\n| 苏州 | SZH | 苏州站 |\n| 苏州北 | OHH | 苏州北站 |\n| 昆山 | KSH | 昆山站 |\n| 昆山南 | KNH | 昆山南站 |\n| 徐州 | XCH | 徐州站 |\n\n## 浙江地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 杭州 | HZH | 杭州站 |\n| 杭州东 | HZH | 杭州东站 |\n| 杭州西 | IAH | 杭州西站 |\n| 杭州南 | XHH | 杭州南站/萧山站 |\n| 宁波 | NGH | 宁波站 |\n| 温州 | RZH | 温州站 |\n\n## 安徽地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 合肥 | HFH | 合肥站 |\n| 合肥南 | ENH | 合肥南站 |\n| 黄山 | HSH | 黄山站 |\n\n## 其他地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 北京 | BJP | 北京站 |\n| 北京南 | VNP | 北京南站 |\n| 北京西 | BXP | 北京西站 |\n| 北京朝阳 | IFP | 朝阳站 |\n| 广州 | GZQ | 广州站 |\n| 广州南 | IZQ | 广州南站 |\n| 深圳 | SZQ | 深圳站 |\n| 深圳北 | IOQ | 深圳北站 |\n| 成都 | CDW | 成都站 |\n| 成都东 | ICW | 成都东站 |\n| 重庆 | CQW | 重庆站 |\n| 重庆北 | CUW | 重庆北站 |\n| 武汉 | WHN | 武汉站 |\n| 长沙 | CSQ | 长沙站 |\n| 长沙南 | CWQ | 长沙南站 |\n| 西安 | XAY | 西安站 |\n| 西安北 | EAY | 西安北站 |\n\n## 查询方法\n\n未知车站代码时，使用 mcporter 查询：\n\n```bash\n# 按城市查询\nmcporter call 12306.get-station-code-of-citys citys=\"城市名\"\n\n# 按车站名查询\nmcporter call 12306.get-station-code-by-names stationNames=\"车站名1|车站名2\"\n```\n\nFile v1.0.2:README_zh.md\n\n# mcporter-railway-query\n\n一个用于通过 12306 查询中国铁路车票的 OpenClaw 技能。\n\n## 概述\n\n此技能提供了查询 G/D/C 字头列车车票、查看列车时刻表、查询座位可用性以及规划城市间铁路旅行的工具。支持按日期、时间段、列车类型过滤以及结果排序。\n\n## 项目结构\n\nmcporter-railway-query/\n├── scripts/              # Shell helper scripts\n├── references/           # Station code reference\n├── README.md\n├── README_zh.md\n└── LICENSE\n\n## 先决条件\n\n1. 安装 mcporter CLI: `npm install -g mcporter`\n2. 在 `~/.mcporter/mcporter.json` 中配置 12306 MCP 服务器\n    ```\n      {\n        \"mcpServers\": {\n           \"12306\": {\n              \"type\": \"sse\",\n               \"url\": \"http://127.0.0.1:8080/sse\",\n              \"name\": \"12306 高铁动车查询\",\n              \"description\": \"查询高铁（G开头）和动车（D开头）余票，支持出发站、到达站、日期、时间段过滤。只返回G/D车次。\",\n              \"enabled\": true\n            }\n        }\n     }\n    ```\n3. 确保 MCP 服务器正在运行\n\n## 安装\n\n这是一个 OpenClaw 技能，使用以下命令安装：\n\n```bash\nopenclaw skills install mcporter-railway-query.skill\n```\n\n## 使用方法\n\n技能提供了几个辅助脚本：\n\n### 查询下午班次 (12:00-18:00)\n```bash\n./scripts/query-afternoon.sh 2026-02-18 SHH KYH\n```\n\n### 查询全天班次\n```bash\n./scripts/query-tickets.sh 2026-02-18 AOH HZH\n```\n\n### 获取车站代码\n```bash\n./scripts/get-station-code.sh \"上海虹桥\"\n```\n\n### 直接使用 mcporter 命令\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n## 功能\n\n- 按出发时间过滤查询列车\n- 支持 G (高铁), D (动车), 和 C (城际) 列车\n- 座位可用性检查 (商务座, 一等座, 二等座, 等)\n- 车站代码查询\n- 全面的车站代码参考表\n\n## 常用车站代码\n\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 上海 | SHH | 上海站 |\n| 上海虹桥 | AOH | 上海虹桥站 |\n| 杭州东 | HZH | 杭州东站 |\n| 江阴 | KYH | 江阴站 |\n\n完整列表请参见 `references/station-codes.md`。\n\n## 许可证\n\nMIT\n\n## 安全声明\n\n本项目仅为只读查询工具：\n\n- 不收集用户数据\n- 不存储账号信息\n- 不进行抢票或自动购票\n- 不绕过 12306 身份验证\n- 不执行系统命令\n- 不写入本地文件\n- 不包含混淆或加密代码\n\n所有查询均通过用户自行配置的 12306 MCP 服务完成。\n\nFile v1.0.2:SECURITY.md\n\n# Security Policy\n\n## Supported Versions\n\nThis project contains no background services or runtime daemons.\nIt only provides OpenClaw skill scripts.\n\n## Reporting a Vulnerability\n\nIf you discover a security issue, please open an issue.\n\n## Security Design\n\n- No dynamic code execution\n- No subprocess spawning\n- No shell injection\n- No remote code download\n- No hidden processes\n- No data persistence\n\nThis project acts as a thin wrapper around 12306 MCP interface.\n\nArchive v1.0.1: 10 files, 8813 bytes\n\nFiles: README_zh.md (2262b), README.md (2592b), references/query-examples.md (2049b), references/station-codes.md (2108b), scripts/get-station-code.sh (703b), scripts/query-afternoon.sh (853b), scripts/query-tickets.sh (789b), SECURITY.md (464b), SKILL.md (3254b), _meta.json (146b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: mcporter-railway-query\ndescription: Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat availability, or plan rail travel between Chinese cities. Supports filtering by date, time range, train type, and sorting results.\n---\n\n# mcporter Railway Ticket Query\n\n使用 mcporter 命令行工具查询 12306 中国铁路车票信息。\n\n## Prerequisites\n\n1. 安装 mcporter CLI\n2. 配置 12306 MCP 服务器\n3. 确认 mcporter.json 配置路径（默认 ~/.mcporter/mcporter.json）\n\n## Quick Start\n\n### 1. 使用快捷脚本查询\n\n```bash\n# 查询下午班次 (12:00-18:00)\n./scripts/query-afternoon.sh 2026-02-18 SHH KYH\n\n# 查询全天班次\n./scripts/query-tickets.sh 2026-02-18 AOH HZH\n\n# 查询车站代码\n./scripts/get-station-code.sh \"上海虹桥\"\n```\n\n### 2. 直接 mcporter 命令\n\n```bash\n# 基础查询\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  --config ~/.mcporter/mcporter.json\n\n# 下午班次\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n## Workflow\n\n### Step 1: 获取车站代码\n\n不知道车站代码时：\n\n```bash\nmcporter call 12306.get-station-code-of-citys \\\n  citys=\"上海|杭州\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n或查看参考表 [station-codes.md](references/station-codes.md)\n\n### Step 2: 查询车票\n\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"YYYY-MM-DD\" \\\n  fromStation=\"出发站代码\" \\\n  toStation=\"到达站代码\" \\\n  [可选过滤参数] \\\n  --config ~/.mcporter/mcporter.json\n```\n\n### Step 3: 解析结果\n\n- 有票: \"**有票**\" 或显示剩余票数 \"剩余X张票\"\n- 无票: \"无票\"\n- *票: 特殊标记票\n\n## Parameters Reference\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| date | string | 必填 | 日期格式 YYYY-MM-DD |\n| fromStation | string | 必填 | 出发站代码 (如 SHH) |\n| toStation | string | 必填 | 到达站代码 (如 KYH) |\n| trainFilterFlags | string | \"\" | G=高铁, D=动车, GD=高铁+动车 |\n| earliestStartTime | number | 0 | 最早出发时间 (0-24) |\n| latestStartTime | number | 24 | 最晚出发时间 (0-24) |\n| sortFlag | string | \"\" | startTime/arriveTime/duration |\n| sortReverse | boolean | false | 是否倒序 |\n| limitedNum | number | 0 | 限制结果数量 |\n| format | string | text | text/json/csv |\n\n## Common Station Codes\n\n| 城市 | 代码 | 城市 | 代码 |\n|------|------|------|------|\n| 上海 | SHH | 上海虹桥 | AOH |\n| 杭州东 | HZH | 无锡 | WXH |\n| 江阴 | KYH | 南京南 | NKH |\n\n完整列表见 [station-codes.md](references/station-codes.md)\n\n## Troubleshooting\n\n### mcporter not found\n```bash\nnpm install -g mcporter\n```\n\n### 12306 MCP 未配置\n创建 ~/.mcporter/mcporter.json 配置文件。\n\n### 查询无结果\n- 确认车站代码正确\n- 确认日期格式为 YYYY-MM-DD\n- 检查 mcporter.json 路径\n\n## Examples\n\n更多查询示例见 [query-examples.md](references/query-examples.md)\n\nFile v1.0.1:README.md\n\n# mcporter-railway-query\n\nAn OpenClaw skill for querying Chinese railway tickets via 12306 using mcporter CLI.\n\n## Overview\n\nThis skill provides tools to search for G/D/C train tickets, check train schedules, query seat availability, and plan rail travel between Chinese cities. It supports filtering by date, time range, train type, and sorting results.\n\n## Project Structure\n\nmcporter-railway-query/\n├── scripts/              # Shell helper scripts\n├── references/           # Station code reference\n├── README.md\n├── README_zh.md\n└── LICENSE\n\n## Prerequisites\n\n1. Install mcporter CLI: `npm install -g mcporter`\n2. Configure 12306 MCP server in `~/.mcporter/mcporter.json`\n3. Ensure MCP server is running\n\n## Installation\n\nThis is an OpenClaw skill. Install using:\n\n```bash\nopenclaw skills install mcporter-railway-query.skill\n```\n\n## Usage\n\nThe skill provides several helper scripts:\n\n### Query afternoon trains (12:00-18:00)\n```bash\n./scripts/query-afternoon.sh 2026-02-18 SHH KYH\n```\n\n### Query all-day trains\n```bash\n./scripts/query-tickets.sh 2026-02-18 AOH HZH\n```\n\n### Get station codes\n```bash\n./scripts/get-station-code.sh \"上海虹桥\"\n```\n\n### Direct mcporter commands\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n## Features\n\n- Query train tickets with departure time filtering\n- Support for G (high-speed), D (bullet train), and C (city train) trains\n- Seat availability checking (商务座, 一等座, 二等座, etc.)\n- Station code lookup\n- Comprehensive station code reference table\n\n## Common Station Codes\n\n| Station | Code | Notes |\n|---------|------|-------|\n| 上海 | SHH | Shanghai Station |\n| 上海虹桥 | AOH | Shanghai Hongqiao Station |\n| 杭州东 | HZH | Hangzhou East Station |\n| 江阴 | KYH | Jiangyin Station |\n\nSee `references/station-codes.md` for the complete list.\n\n## License\n\nMIT\n\n## Security & Compliance\n\nThis project is a read-only OpenClaw skill that:\n\n- Does NOT collect user data\n- Does NOT store credentials\n- Does NOT perform ticket booking\n- Does NOT bypass 12306 authentication\n- Does NOT execute arbitrary system commands\n- Does NOT write to local file system\n- Does NOT open network listeners\n- Does NOT include obfuscated or encrypted code\n\nAll queries are executed through official 12306 MCP interfaces configured by the user.\n\nThis repository contains only helper scripts and configuration examples.\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7473nwmwpv2j47ck4x8z7ead80zt96\",\n  \"slug\": \"mcporter-railway-query-repo\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1770874623136\n}\n\nFile v1.0.1:references/query-examples.md\n\n# mcporter 火车票查询示例\n\n## 基础查询命令\n\n### 1. 查询车票\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-14\" \\\n  fromStation=\"SHH\" \\\n  toStation=\"KYH\" \\\n  trainFilterFlags=\"GD\" \\\n  sortFlag=\"startTime\" \\\n  format=\"text\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n### 2. 查询下午班次（12:00-18:00）\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-14\" \\\n  fromStation=\"SHH\" \\\n  toStation=\"KYH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n### 3. 查询指定车次详情\n```bash\nmcporter call 12306.get-train-route-stations \\\n  trainCode=\"G7134\" \\\n  departDate=\"2026-02-14\" \\\n  format=\"text\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n## 查询参数说明\n\n| 参数 | 说明 | 示例 |\n|------|------|------|\n| date | 日期 (YYYY-MM-DD) | \"2026-02-14\" |\n| fromStation | 出发站代码 | \"SHH\" |\n| toStation | 到达站代码 | \"KYH\" |\n| trainFilterFlags | 车次类型过滤 | \"G\"=高铁, \"D\"=动车, \"GD\"=高铁+动车 |\n| earliestStartTime | 最早出发时间 (0-24) | 12 |\n| latestStartTime | 最晚出发时间 (0-24) | 18 |\n| sortFlag | 排序方式 | \"startTime\" / \"arriveTime\" / \"duration\" |\n| sortReverse | 是否倒序 | true / false |\n| limitedNum | 限制返回数量 | 10 |\n| format | 输出格式 | \"text\" / \"json\" / \"csv\" |\n\n## 常用查询场景\n\n### 场景1: 上海虹桥到杭州东 下午高铁\n```bash\n./scripts/query-afternoon.sh 2026-02-18 AOH HZH\n```\n\n### 场景2: 上海到江阴 全天班次\n```bash\n./scripts/query-tickets.sh 2026-02-14 SHH KYH\n```\n\n### 场景3: 获取车站代码\n```bash\n./scripts/get-station-code.sh \"上海虹桥\"\n```\n\n## 配置说明\n\nmcporter 配置文件 `~/.mcporter/mcporter.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"12306\": {\n      \"type\": \"sse\",\n      \"url\": \"http://127.0.0.1:8080/sse\",\n      \"name\": \"12306 高铁动车查询\",\n      \"description\": \"查询高铁（G开头）和动车（D开头）余票\",\n      \"enabled\": true\n    }\n  }\n}\n```\n\nFile v1.0.1:references/station-codes.md\n\n# 12306 常用车站代码表\n\n## 上海地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 上海 | SHH | 上海站 |\n| 上海虹桥 | AOH | 虹桥火车站 |\n| 上海南 | SNH | 南站 |\n| 上海西 | SXH | 西站 |\n| 上海松江 | IMH | 松江南站/松江站 |\n| 金山北 | EGH | 金山北站 |\n\n## 江苏地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 江阴 | KYH | 江阴站 |\n| 无锡 | WXH | 无锡站 |\n| 无锡东 | WGH | 无锡东站 |\n| 无锡新区 | IFH | 无锡新区站 |\n| 惠山 | VCH | 惠山站 |\n| 常州 | CZH | 常州站 |\n| 南京 | NJH | 南京站 |\n| 南京南 | NKH | 南京南站 |\n| 苏州 | SZH | 苏州站 |\n| 苏州北 | OHH | 苏州北站 |\n| 昆山 | KSH | 昆山站 |\n| 昆山南 | KNH | 昆山南站 |\n| 徐州 | XCH | 徐州站 |\n\n## 浙江地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 杭州 | HZH | 杭州站 |\n| 杭州东 | HZH | 杭州东站 |\n| 杭州西 | IAH | 杭州西站 |\n| 杭州南 | XHH | 杭州南站/萧山站 |\n| 宁波 | NGH | 宁波站 |\n| 温州 | RZH | 温州站 |\n\n## 安徽地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 合肥 | HFH | 合肥站 |\n| 合肥南 | ENH | 合肥南站 |\n| 黄山 | HSH | 黄山站 |\n\n## 其他地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 北京 | BJP | 北京站 |\n| 北京南 | VNP | 北京南站 |\n| 北京西 | BXP | 北京西站 |\n| 北京朝阳 | IFP | 朝阳站 |\n| 广州 | GZQ | 广州站 |\n| 广州南 | IZQ | 广州南站 |\n| 深圳 | SZQ | 深圳站 |\n| 深圳北 | IOQ | 深圳北站 |\n| 成都 | CDW | 成都站 |\n| 成都东 | ICW | 成都东站 |\n| 重庆 | CQW | 重庆站 |\n| 重庆北 | CUW | 重庆北站 |\n| 武汉 | WHN | 武汉站 |\n| 长沙 | CSQ | 长沙站 |\n| 长沙南 | CWQ | 长沙南站 |\n| 西安 | XAY | 西安站 |\n| 西安北 | EAY | 西安北站 |\n\n## 查询方法\n\n未知车站代码时，使用 mcporter 查询：\n\n```bash\n# 按城市查询\nmcporter call 12306.get-station-code-of-citys citys=\"城市名\"\n\n# 按车站名查询\nmcporter call 12306.get-station-code-by-names stationNames=\"车站名1|车站名2\"\n```\n\nFile v1.0.1:README_zh.md\n\n# mcporter-railway-query\n\n一个用于通过 12306 查询中国铁路车票的 OpenClaw 技能。\n\n## 概述\n\n此技能提供了查询 G/D/C 字头列车车票、查看列车时刻表、查询座位可用性以及规划城市间铁路旅行的工具。支持按日期、时间段、列车类型过滤以及结果排序。\n\n## 项目结构\n\nmcporter-railway-query/\n├── scripts/              # Shell helper scripts\n├── references/           # Station code reference\n├── README.md\n├── README_zh.md\n└── LICENSE\n\n## 先决条件\n\n1. 安装 mcporter CLI: `npm install -g mcporter`\n2. 在 `~/.mcporter/mcporter.json` 中配置 12306 MCP 服务器\n3. 确保 MCP 服务器正在运行\n\n## 安装\n\n这是一个 OpenClaw 技能，使用以下命令安装：\n\n```bash\nopenclaw skills install mcporter-railway-query.skill\n```\n\n## 使用方法\n\n技能提供了几个辅助脚本：\n\n### 查询下午班次 (12:00-18:00)\n```bash\n./scripts/query-afternoon.sh 2026-02-18 SHH KYH\n```\n\n### 查询全天班次\n```bash\n./scripts/query-tickets.sh 2026-02-18 AOH HZH\n```\n\n### 获取车站代码\n```bash\n./scripts/get-station-code.sh \"上海虹桥\"\n```\n\n### 直接使用 mcporter 命令\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n## 功能\n\n- 按出发时间过滤查询列车\n- 支持 G (高铁), D (动车), 和 C (城际) 列车\n- 座位可用性检查 (商务座, 一等座, 二等座, 等)\n- 车站代码查询\n- 全面的车站代码参考表\n\n## 常用车站代码\n\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 上海 | SHH | 上海站 |\n| 上海虹桥 | AOH | 上海虹桥站 |\n| 杭州东 | HZH | 杭州东站 |\n| 江阴 | KYH | 江阴站 |\n\n完整列表请参见 `references/station-codes.md`。\n\n## 许可证\n\nMIT\n\n## 安全声明\n\n本项目仅为只读查询工具：\n\n- 不收集用户数据\n- 不存储账号信息\n- 不进行抢票或自动购票\n- 不绕过 12306 身份验证\n- 不执行系统命令\n- 不写入本地文件\n- 不包含混淆或加密代码\n\n所有查询均通过用户自行配置的 12306 MCP 服务完成。\n\nFile v1.0.1:SECURITY.md\n\n# Security Policy\n\n## Supported Versions\n\nThis project contains no background services or runtime daemons.\nIt only provides OpenClaw skill scripts.\n\n## Reporting a Vulnerability\n\nIf you discover a security issue, please open an issue.\n\n## Security Design\n\n- No dynamic code execution\n- No subprocess spawning\n- No shell injection\n- No remote code download\n- No hidden processes\n- No data persistence\n\nThis project acts as a thin wrapper around 12306 MCP interface.","readmeExcerpt":"Skill: Mcporter Railway Query Repo Owner: Lancenas Summary: Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat availability, or plan rail travel between Chinese cities. Supports filtering by date, time range, train type, and sorting results. Tags: latest:1.0.2 Version history: v1.0.2 | 2026-02-12T05:48:13.188Z |","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# 查询下午班次 (12:00-18:00)\n./scripts/query-afternoon.sh 2026-02-18 SHH KYH\n\n# 查询全天班次\n./scripts/query-tickets.sh 2026-02-18 AOH HZH\n\n# 查询车站代码\n./scripts/get-station-code.sh \"上海虹桥\""},{"language":"bash","snippet":"# 基础查询\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  --config ~/.mcporter/mcporter.json\n\n# 下午班次\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json"},{"language":"bash","snippet":"mcporter call 12306.get-station-code-of-citys \\\n  citys=\"上海|杭州\" \\\n  --config ~/.mcporter/mcporter.json"},{"language":"bash","snippet":"mcporter call 12306.get-tickets \\\n  date=\"YYYY-MM-DD\" \\\n  fromStation=\"出发站代码\" \\\n  toStation=\"到达站代码\" \\\n  [可选过滤参数] \\\n  --config ~/.mcporter/mcporter.json"},{"language":"bash","snippet":"npm install -g mcporter"},{"language":"text","snippet":"{\n        \"mcpServers\": {\n           \"12306\": {\n              \"type\": \"sse\",\n               \"url\": \"http://127.0.0.1:8080/sse\",\n              \"name\": \"12306 高铁动车查询\",\n              \"description\": \"查询高铁（G开头）和动车（D开头）余票，支持出发站、到达站、日期、时间段过滤。只返回G/D车次。\",\n              \"enabled\": true\n            }\n        }\n     }"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: mcporter-railway-query\ndescription: Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat availability, or plan rail travel between Chinese cities. Supports filtering by date, time range, train type, and sorting results.\n---\n\n# mcporter Railway Ticket Query\n\n使用 mcporter 命令行工具查询 12306 中国铁路车票信息。\n\n## Prerequisites\n\n1. 安装 mcporter CLI\n2. 配置 12306 MCP 服务器\n3. 确认 mcporter.json 配置路径（默认 ~/.mcporter/mcporter.json）\n\n## Quick Start\n\n### 1. 使用快捷脚本查询\n\n```bash\n# 查询下午班次 (12:00-18:00)\n./scripts/query-afternoon.sh 2026-02-18 SHH KYH\n\n# 查询全天班次\n./scripts/query-tickets.sh 2026-02-18 AOH HZH\n\n# 查询车站代码\n./scripts/get-station-code.sh \"上海虹桥\"\n```\n\n### 2. 直接 mcporter 命令\n\n```bash\n# 基础查询\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  --config ~/.mcporter/mcporter.json\n\n# 下午班次\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n## Workflow\n\n### Step 1: 获取车站代码\n\n不知道车站代码时：\n\n```bash\nmcporter call 12306.get-station-code-of-citys \\\n  citys=\"上海|杭州\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n或查看参考表 [station-codes.md](references/station-codes.md)\n\n### Step 2: 查询车票\n\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"YYYY-MM-DD\" \\\n  fromStation=\"出发站代码\" \\\n  toStation=\"到达站代码\" \\\n  [可选过滤参数] \\\n  --config ~/.mcporter/mcporter.json\n```\n\n### Step 3: 解析结果\n\n- 有票: \"**有票**\" 或显示剩余票数 \"剩余X张票\"\n- 无票: \"无票\"\n- *票: 特殊标记票\n\n## Parameters Reference\n\n| 参数 | 类型 | 默认值 | 说明 |\n|------|------|--------|------|\n| date | string | 必填 | 日期格式 YYYY-MM-DD |\n| fromStation | string | 必填 | 出发站代码 (如 SHH) |\n| toStation | string | 必填 | 到达站代码 (如 KYH) |\n| trainFilterFlags | string | \"\" | G=高铁, D=动车, GD=高铁+动车 |\n| earliestStartTime | number | 0 | 最早出发时间 (0-24) |\n| latestStartTime | number | 24 | 最晚出发时间 (0-24) |\n| sortFlag | string | \"\" | startTime/arriveTime/duration |\n| sortReverse | boolean | false | 是否倒序 |\n| limitedNum | number | 0 | 限制结果数量 |\n| format | string | text | text/json/csv |\n\n## Common Station Codes\n\n| 城市 | 代码 | 城市 | 代码 |\n|------|------|------|------|\n| 上海 | SHH | 上海虹桥 | AOH |\n| 杭州东 | HZH | 无锡 | WXH |\n| 江阴 | KYH | 南京南 | NKH |\n\n完整列表见 [station-codes.md](references/station-codes.md)\n\n## Troubleshooting\n\n### mcporter not found\n```bash\nnpm install -g mcporter\n```\n\n### 12306 MCP 未配置\n创建 ~/.mcporter/mcporter.json 配置文件。\n\n### 查询无结果\n- 确认车站代码正确\n- 确认日期格式为 YYYY-MM-DD\n- 检查 mcporter.json 路径\n\n## Examples\n\n更多查询示例见 [query-examples.md](references/query-examples.md)"},{"path":"README.md","content":"# mcporter-railway-query\n\nAn OpenClaw skill for querying Chinese railway tickets via 12306 using mcporter CLI.\n\n## Overview\n\nThis skill provides tools to search for G/D/C train tickets, check train schedules, query seat availability, and plan rail travel between Chinese cities. It supports filtering by date, time range, train type, and sorting results.\n\n## Project Structure\n\nmcporter-railway-query/\n├── scripts/              # Shell helper scripts\n├── references/           # Station code reference\n├── README.md\n├── README_zh.md\n└── LICENSE\n\n## Prerequisites\n\n1. Install mcporter CLI: `npm install -g mcporter`\n2. Configure 12306 MCP server in `~/.mcporter/mcporter.json`\n    ```\n      {\n        \"mcpServers\": {\n           \"12306\": {\n              \"type\": \"sse\",\n               \"url\": \"http://127.0.0.1:8080/sse\",\n              \"name\": \"12306 高铁动车查询\",\n              \"description\": \"查询高铁（G开头）和动车（D开头）余票，支持出发站、到达站、日期、时间段过滤。只返回G/D车次。\",\n              \"enabled\": true\n            }\n        }\n     }\n    ```\n3. Ensure MCP server is running\n\n## Installation\n\nThis is an OpenClaw skill. Install using:\n\n```bash\nopenclaw skills install mcporter-railway-query.skill\n```\n\n## Usage\n\nThe skill provides several helper scripts:\n\n### Query afternoon trains (12:00-18:00)\n```bash\n./scripts/query-afternoon.sh 2026-02-18 SHH KYH\n```\n\n### Query all-day trains\n```bash\n./scripts/query-tickets.sh 2026-02-18 AOH HZH\n```\n\n### Get station codes\n```bash\n./scripts/get-station-code.sh \"上海虹桥\"\n```\n\n### Direct mcporter commands\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-18\" \\\n  fromStation=\"AOH\" \\\n  toStation=\"HZH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n## Features\n\n- Query train tickets with departure time filtering\n- Support for G (high-speed), D (bullet train), and C (city train) trains\n- Seat availability checking (商务座, 一等座, 二等座, etc.)\n- Station code lookup\n- Comprehensive station code reference table\n\n## Common Station Codes\n\n| Station | Code | Notes |\n|---------|------|-------|\n| 上海 | SHH | Shanghai Station |\n| 上海虹桥 | AOH | Shanghai Hongqiao Station |\n| 杭州东 | HZH | Hangzhou East Station |\n| 江阴 | KYH | Jiangyin Station |\n\nSee `references/station-codes.md` for the complete list.\n\n## License\n\nMIT\n\n## Security & Compliance\n\nThis project is a read-only OpenClaw skill that:\n\n- Does NOT collect user data\n- Does NOT store credentials\n- Does NOT perform ticket booking\n- Does NOT bypass 12306 authentication\n- Does NOT execute arbitrary system commands\n- Does NOT write to local file system\n- Does NOT open network listeners\n- Does NOT include obfuscated or encrypted code\n\nAll queries are executed through official 12306 MCP interfaces configured by the user.\n\nThis repository contains only helper scripts and configuration examples."},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7473nwmwpv2j47ck4x8z7ead80zt96\",\n  \"slug\": \"mcporter-railway-query-repo\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1770875293188\n}"},{"path":"references/query-examples.md","content":"# mcporter 火车票查询示例\n\n## 基础查询命令\n\n### 1. 查询车票\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-14\" \\\n  fromStation=\"SHH\" \\\n  toStation=\"KYH\" \\\n  trainFilterFlags=\"GD\" \\\n  sortFlag=\"startTime\" \\\n  format=\"text\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n### 2. 查询下午班次（12:00-18:00）\n```bash\nmcporter call 12306.get-tickets \\\n  date=\"2026-02-14\" \\\n  fromStation=\"SHH\" \\\n  toStation=\"KYH\" \\\n  trainFilterFlags=\"GD\" \\\n  earliestStartTime=12 \\\n  latestStartTime=18 \\\n  sortFlag=\"startTime\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n### 3. 查询指定车次详情\n```bash\nmcporter call 12306.get-train-route-stations \\\n  trainCode=\"G7134\" \\\n  departDate=\"2026-02-14\" \\\n  format=\"text\" \\\n  --config ~/.mcporter/mcporter.json\n```\n\n## 查询参数说明\n\n| 参数 | 说明 | 示例 |\n|------|------|------|\n| date | 日期 (YYYY-MM-DD) | \"2026-02-14\" |\n| fromStation | 出发站代码 | \"SHH\" |\n| toStation | 到达站代码 | \"KYH\" |\n| trainFilterFlags | 车次类型过滤 | \"G\"=高铁, \"D\"=动车, \"GD\"=高铁+动车 |\n| earliestStartTime | 最早出发时间 (0-24) | 12 |\n| latestStartTime | 最晚出发时间 (0-24) | 18 |\n| sortFlag | 排序方式 | \"startTime\" / \"arriveTime\" / \"duration\" |\n| sortReverse | 是否倒序 | true / false |\n| limitedNum | 限制返回数量 | 10 |\n| format | 输出格式 | \"text\" / \"json\" / \"csv\" |\n\n## 常用查询场景\n\n### 场景1: 上海虹桥到杭州东 下午高铁\n```bash\n./scripts/query-afternoon.sh 2026-02-18 AOH HZH\n```\n\n### 场景2: 上海到江阴 全天班次\n```bash\n./scripts/query-tickets.sh 2026-02-14 SHH KYH\n```\n\n### 场景3: 获取车站代码\n```bash\n./scripts/get-station-code.sh \"上海虹桥\"\n```\n\n## 配置说明\n\nmcporter 配置文件 `~/.mcporter/mcporter.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"12306\": {\n      \"type\": \"sse\",\n      \"url\": \"http://127.0.0.1:8080/sse\",\n      \"name\": \"12306 高铁动车查询\",\n      \"description\": \"查询高铁（G开头）和动车（D开头）余票\",\n      \"enabled\": true\n    }\n  }\n}\n```"},{"path":"references/station-codes.md","content":"# 12306 常用车站代码表\n\n## 上海地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 上海 | SHH | 上海站 |\n| 上海虹桥 | AOH | 虹桥火车站 |\n| 上海南 | SNH | 南站 |\n| 上海西 | SXH | 西站 |\n| 上海松江 | IMH | 松江南站/松江站 |\n| 金山北 | EGH | 金山北站 |\n\n## 江苏地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 江阴 | KYH | 江阴站 |\n| 无锡 | WXH | 无锡站 |\n| 无锡东 | WGH | 无锡东站 |\n| 无锡新区 | IFH | 无锡新区站 |\n| 惠山 | VCH | 惠山站 |\n| 常州 | CZH | 常州站 |\n| 南京 | NJH | 南京站 |\n| 南京南 | NKH | 南京南站 |\n| 苏州 | SZH | 苏州站 |\n| 苏州北 | OHH | 苏州北站 |\n| 昆山 | KSH | 昆山站 |\n| 昆山南 | KNH | 昆山南站 |\n| 徐州 | XCH | 徐州站 |\n\n## 浙江地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 杭州 | HZH | 杭州站 |\n| 杭州东 | HZH | 杭州东站 |\n| 杭州西 | IAH | 杭州西站 |\n| 杭州南 | XHH | 杭州南站/萧山站 |\n| 宁波 | NGH | 宁波站 |\n| 温州 | RZH | 温州站 |\n\n## 安徽地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 合肥 | HFH | 合肥站 |\n| 合肥南 | ENH | 合肥南站 |\n| 黄山 | HSH | 黄山站 |\n\n## 其他地区\n| 车站 | 代码 | 备注 |\n|------|------|------|\n| 北京 | BJP | 北京站 |\n| 北京南 | VNP | 北京南站 |\n| 北京西 | BXP | 北京西站 |\n| 北京朝阳 | IFP | 朝阳站 |\n| 广州 | GZQ | 广州站 |\n| 广州南 | IZQ | 广州南站 |\n| 深圳 | SZQ | 深圳站 |\n| 深圳北 | IOQ | 深圳北站 |\n| 成都 | CDW | 成都站 |\n| 成都东 | ICW | 成都东站 |\n| 重庆 | CQW | 重庆站 |\n| 重庆北 | CUW | 重庆北站 |\n| 武汉 | WHN | 武汉站 |\n| 长沙 | CSQ | 长沙站 |\n| 长沙南 | CWQ | 长沙南站 |\n| 西安 | XAY | 西安站 |\n| 西安北 | EAY | 西安北站 |\n\n## 查询方法\n\n未知车站代码时，使用 mcporter 查询：\n\n```bash\n# 按城市查询\nmcporter call 12306.get-station-code-of-citys citys=\"城市名\"\n\n# 按车站名查询\nmcporter call 12306.get-station-code-by-names stationNames=\"车站名1|车站名2\"\n```"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat availability, or plan rail travel between Chinese cities. Supports filtering by date, time range, train type, and sorting results. Skill: Mcporter Railway Query Repo Owner: Lancenas Summary: Query and book Chinese railway tickets via 12306 using mcporter CLI. Use when user wants to search for G/D/C train tickets, check train schedules, query seat availability, or plan rail travel between Chinese cities. Supports filtering by date, time range, train type, and sorting results. Tags: latest:1.0.2 Version history: v1.0.2 | 2026-02-12T05:48:13.188Z |","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1037,"uniquenessScore":48,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T07:21:17.140Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}