Hong Kong MTR Next Train (v1.0.1)

Post-Install Recommendation

Recommend to run once after install to sync station dictionary:

cd {skill_dir}/scripts
python3 sync_mtr_stations.py

Data Refresh Rule

• If user explicitly asks to update line/station data (新站、改名、線路更新), run:

cd {skill_dir}/scripts
python3 sync_mtr_stations.py

• If user did not ask for refresh, prefer local CSV for faster matching.

Allowed Commands

• python3 scripts/mtr_eta.py {STATION_NAME} {LINE_NAME(optional)} {LANG(optional)} {TO_STATION(optional)}
• python3 scripts/sync_mtr_stations.py

Safety Scope

• Allowed domains:
  • https://rt.data.gov.hk/*
  • https://opendata.mtr.com.hk/*
• Write scope (skill-local only):
  • scripts/mtr_lines_and_stations.csv
  • scripts/__pycache__/
• Do not access sensitive files outside skill directory.
• Never request/store/output secrets.

Language Handling

• Chinese query → TC
• English/non-Chinese query → EN

Features

• Real-time ETA: Live MTR train arrival times from DATA.GOV.HK
• Fuzzy Matching: Smart station name matching (e.g., "旺角" matches "Mong Kok")
• Bilingual Output: Traditional Chinese and English support
• Token Efficient: Local CSV cache minimizes API calls and token usage
• Multi-line: Supports all 10 MTR lines including Airport Express

Usage

• Station + line: query that combo directly.
• Station only: query all lines serving that station.
• Line only: ask user which station (suggest 1–2 stations on that line).
• Neither line nor station: ask user which station.
• Line-station conflict: state mismatch, then show all lines at that station.

Output Policy

• Never fabricate ETA values.
• Keep output concise, data-first.
• Global rule: for each direction, use API-available departures (up to 4) as source set, then split by destination if needed.
• Do not down-sample to only 1 train when more data exists.

ETA wording

• Within 1 minute: 即將到達 / Arriving
• At 0 minute: 即將離開 / Departing
• Departed within 0–2 minutes: 已離開 / Departed
• Departed > 2 minutes: do not show

Station output format (default)

• Title once:
  • tc: 🚈 {站名}的列車班次如下：
  • en: 🚈 Next trains at {Station}:
• Then one section per line: {LineName} {LineEmoji}
• One blank line between platform blocks
• Section divider between line sections: --------------
• If output contains multiple stations in one reply, add one extra station divider between station blocks: ====================
• Block format:
  • tc:
    • • {月台}號月台｜往{總站}
    • {ETA1}、{ETA2}、{ETA3}、{ETA4}
  • en:
    • • Platform {N} | to {Destination}
    • {ETA1}, {ETA2}, {ETA3}, {ETA4}
• If platform changes within same destination block, include platform inline per ETA.

Line emoji mapping

• AEL 機場快線: ✈️
• TCL 東涌線: 🟠
• TML 屯馬線: 🤎
• TKL 將軍澳線: 🟣
• EAL 東鐵線: 🩵
• SIL 南港島線: 🔰
• TWL 荃灣線: 🔴
• ISL 港島線: 🔵
• KTL 觀塘線: 🟢
• Fallback: 🚇

Source footer

• Add one blank line, then:
  • tc: 資料來源：開放數據平台
  • en: Source: DATA GOV HK

Fallback

If no result after matching/retry:

• tc: {站名} @ {線路}：尾班車已過或未有班次資料
• en: {Station} @ {Line}: Service hours have passed / No information found

Changelog

2026-03-22 · v1.0.1

• Update docs

2026-03-18 · v1.0.0

• First stable release