TrainFinder CLI

TrainFinder is a terminal-based CLI library that allows you to search for domestic all train information in South Korea.
You can search for trains based on departure station, arrival station, and date.

⚡ Installation

npm install -g trainfinder

🚄 Train Types

⚠️ Only the train types listed below are accepted as valid input.

• normal (ITX-청춘, ITX-새마을, ITX-마음, 무궁화호, 새마을호, 통근열차, 누리로, AREX직통)
• ktx (KTX-산천, KTX-이음, KTX-청룡 )
• srt

🚉 Station List

trainfinder stationlist

🔍 Check Station Existence

⚠️ Station names must be entered in Korean.

trainfinder station --st <station_name>

# Example
trainfinder station --st 수서

🔎 Train Search

Search for trains based on departure station, arrival station, and date.

| Option | Description | Default | | --------- | ------------------------- | -------- | | --dep | Departure station name | — | | --arr | Arrival station name | — | | --date | Date to search (YYYYMMDD) | Today | | --train | Train type | ktx | | --time | After time list (Optional)| 00 (00~24)|

trainfinder search \
  --dep <departure_station> \
  --arr <arrival_station> \
  --date <YYYYMMDD> \
  --train <train_type> \
  --time <time> (optional)

# Example
trainfinder search --dep 서울 --arr 오송 --date 20251212 --train ktx --time 13 (optional)