HK Transport Skill

Query real-time Hong Kong public transport data. No API key needed.

APIs Overview

KMB Bus API

List All Routes

curl -s "https://data.etabus.gov.hk/v1/transport/kmb/route/" | python3 -m json.tool

Response: { data: [{ route, bound, service_type, orig_en, orig_tc, dest_en, dest_tc }] }

Route Stops

curl -s "https://data.etabus.gov.hk/v1/transport/kmb/route-stop/{ROUTE}/{inbound|outbound}/{SERVICE_TYPE}"

Response: { data: [{ route, bound, service_type, seq, stop }] } — stop is stop ID.

Stop Details

curl -s "https://data.etabus.gov.hk/v1/transport/kmb/stop/{STOP_ID}"

Response: { data: { stop, name_en, name_tc, lat, long } }

ETA at Stop

curl -s "https://data.etabus.gov.hk/v1/transport/kmb/stop-eta/{STOP_ID}"

Response: { data: [{ route, dir, service_type, seq, dest_en, dest_tc, eta, rmk_en, rmk_tc }] }

• •eta — ISO timestamp of estimated arrival (null if no data)
• •rmk_en — remarks (e.g., "Last Bus", "Scheduled")

ETA for Specific Route at Stop

curl -s "https://data.etabus.gov.hk/v1/transport/kmb/eta/{STOP_ID}/{ROUTE}/{SERVICE_TYPE}"

Citybus API

List Routes

curl -s "https://rt.data.gov.hk/v2/transport/citybus/route/ctb"

Response: { data: [{ co, route, orig_en, orig_tc, dest_en, dest_tc }] }

Route Stops

curl -s "https://rt.data.gov.hk/v2/transport/citybus/route-stop/ctb/{ROUTE}/{inbound|outbound}"

Stop Details

curl -s "https://rt.data.gov.hk/v2/transport/citybus/stop/{STOP_ID}"

ETA

curl -s "https://rt.data.gov.hk/v2/transport/citybus/eta/ctb/{STOP_ID}/{ROUTE}"

MTR API

Train Schedule

curl -s "https://rt.data.gov.hk/v1/transport/mtr/getSchedule.php?line={LINE}&sta={STATION}"

Response: { data: { "{LINE}-{STATION}": { UP: [...], DOWN: [...] } } }

Each entry: { seq, dest, plat, time, ttnt, valid, source }

• •ttnt — time to next train (minutes)
• •dest — destination station code

MTR Line Codes

MTR Station Codes

See references/mtr-stations.md for full station code list.

Workflow: Finding Bus ETA

1. •Search for the route: GET /kmb/route/ and filter by route number
2. •Get route stops: GET /kmb/route-stop/{ROUTE}/{DIRECTION}/1
3. •Find the stop nearest to user (by name or use hk-geodata skill)
4. •Get ETA: GET /kmb/eta/{STOP_ID}/{ROUTE}/1
5. •Parse eta timestamps and calculate minutes until arrival

GMB Minibus API

List All Routes

curl -s "https://data.etagmb.gov.hk/route"

Response: { data: { routes: { HKI: [...], KLN: [...], NT: [...] } } } — 569 routes total.

Route Detail

curl -s "https://data.etagmb.gov.hk/route/{REGION}/{ROUTE_CODE}"

Regions: HKI (Hong Kong Island), KLN (Kowloon), NT (New Territories). Response includes route_id, directions with origin/destination, headways.

Route Stops

curl -s "https://data.etagmb.gov.hk/route-stop/{ROUTE_ID}/{ROUTE_SEQ}"

Stop ETA

curl -s "https://data.etagmb.gov.hk/eta/route-stop/{ROUTE_ID}/{ROUTE_SEQ}/{STOP_SEQ}"

NLB (Lantau Bus) API

List Routes

curl -s "https://rt.data.gov.hk/v1/transport/nlb/route.php?action=list"

Response: { routes: [{ routeId, routeNo, routeName_e, routeName_c, overnightRoute, specialRoute }] } — 64 routes.

Route Stops

curl -s "https://rt.data.gov.hk/v1/transport/nlb/stop.php?action=list&routeId={ROUTE_ID}"

ETA

curl -s "https://rt.data.gov.hk/v1/transport/nlb/stop.php?action=estimatedArrivals&routeId={ROUTE_ID}&stopId={STOP_ID}&language=en"

Light Rail (LRT) API

Station Schedule

curl -s "https://rt.data.gov.hk/v1/transport/mtr/lrt/getSchedule?station_id={STATION_ID}"

Response: { platform_list: [{ platform_id, route_list: [{ route_no, dest_en, dest_ch, time_en, time_ch, train_length }] }] }

Station IDs are 3-digit numbers (e.g., 001=Tuen Mun Ferry Pier). See references/lrt-stations.md for full list.

Presentation Tips

• •Show next 2-3 arrivals with minutes remaining
• •Mention remarks (Last Bus, Scheduled, etc.)
• •For MTR, show both UP and DOWN directions
• •Use 🚌 for bus, 🚐 for minibus, 🚇 for MTR, 🚃 for Light Rail
• •Format times relative to now: "3 分鐘後", "12:45 (5 min)"