Seoul Subway

---

name: seoul-subway description: Seoul Subway assistant for real-time arrivals, route planning, and service alerts (Korean/English) model: sonnet metadata: {"moltbot":{"emoji":"🚇"}} homepage: https://github.com/dukbong/seoul-subway user-invocable: true

---

Seoul Subway Skill

Query real-time Seoul Subway information. No API key required - uses proxy server.

Features

| Feature | Description | Trigger Example (KO) | Trigger Example (EN) | |---------|-------------|----------------------|----------------------| | Real-time Arrival | Train arrival times by station | "강남역 도착정보" | "Gangnam station arrivals" | | Station Search | Line and station code lookup | "강남역 몇호선?" | "What line is Gangnam?" | | Route Search | Shortest path with time/fare | "신도림에서 서울역" | "Sindorim to Seoul Station" | | Service Alerts | Delays, incidents, non-stops | "지하철 지연 있어?" | "Any subway delays?" | | Last Train | Last train times by station | "홍대 막차 몇 시야?" | "Last train to Hongdae?" | | Exit Info | Exit numbers for landmarks | "코엑스 몇 번 출구?" | "Which exit for COEX?" | | Accessibility | Elevators, escalators, wheelchair lifts | "강남역 엘리베이터" | "Gangnam elevators" | | Quick Exit | Best car for facilities | "강남역 빠른하차" | "Gangnam quick exit" | | Restrooms | Restroom locations | "강남역 화장실" | "Gangnam restrooms" |

Natural Language Triggers / 자연어 트리거

다양한 자연어 표현을 인식합니다:

#### Real-time Arrival / 실시간 도착 | English | 한국어 | |---------|--------| | "When's the next train at Gangnam?" | "강남 몇 분 남았어?" | | "Trains at Gangnam" | "강남 열차" | | "Gangnam arrivals" | "강남 언제 와?" | | "Next train to Gangnam" | "다음 열차 강남" |

#### Route Search / 경로 검색 | English | 한국어 | |---------|--------| | "How do I get to Seoul Station from Gangnam?" | "강남에서 서울역 어떻게 가?" | | "Gangnam → Seoul Station" | "강남 → 서울역" | | "Gangnam to Seoul Station" | "강남에서 서울역 가는 길" | | "Route from Gangnam to Hongdae" | "강남부터 홍대까지" |

#### Service Alerts / 운행 알림 | English | 한국어 | |---------|--------| | "Is Line 2 running normally?" | "2호선 정상 운행해?" | | "Any delays on Line 1?" | "1호선 지연 있어?" | | "Subway status" | "지하철 상황" | | "Line 3 alerts" | "3호선 알림" |

#### Last Train / 막차 시간 | English | 한국어 | |---------|--------| | "Last train to Gangnam?" | "강남 막차 몇 시야?" | | "When is the last train at Hongdae?" | "홍대입구 막차 시간" | | "Final train to Seoul Station" | "서울역 막차" | | "Last train on Saturday?" | "토요일 막차 시간" |

#### Exit Info / 출구 정보 | English | 한국어 | |---------|--------| | "Which exit for COEX?" | "코엑스 몇 번 출구?" | | "Exit for Lotte World" | "롯데월드 출구" | | "DDP which exit?" | "DDP 몇 번 출구?" | | "Gyeongbokgung Palace exit" | "경복궁 나가는 출구" |

#### Accessibility / 접근성 정보 | English | 한국어 | |---------|--------| | "Gangnam station elevators" | "강남역 엘리베이터" | | "Escalators at Seoul Station" | "서울역 에스컬레이터" | | "Wheelchair lifts at Jamsil" | "잠실역 휠체어리프트" | | "Accessibility info for Hongdae" | "홍대입구 접근성 정보" |

#### Quick Exit / 빠른하차 | English | 한국어 | |---------|--------| | "Quick exit at Gangnam" | "강남역 빠른하차" | | "Which car for elevator?" | "엘리베이터 몇 번째 칸?" | | "Best car for exit 3" | "3번 출구 가까운 칸" | | "Fastest exit at Samsung" | "삼성역 빠른 하차 위치" |

#### Restrooms / 화장실 | English | 한국어 | |---------|--------| | "Restrooms at Gangnam" | "강남역 화장실" | | "Where's the bathroom at Myeongdong?" | "명동역 화장실 어디야?" | | "Accessible restroom at Seoul Station" | "서울역 장애인 화장실" | | "Baby changing station at Jamsil" | "잠실역 기저귀 교환대" |

---

First Time Setup / 첫 사용 안내

When you first use this skill, you'll see a permission prompt for the proxy domain.

처음 사용 시 프록시 도메인 접근 확인 창이 뜹니다.

Recommended / 권장: Select Yes to allow access for this session.

이 세션에서 접근을 허용하려면 Yes를 선택하세요.

> Note / 참고: You may also select Yes, and don't ask again for convenience, > but only if you trust the proxy server. The proxy receives only station names > and search parameters -- never your conversation context or personal data. > See Data Privacy below for details. > > 편의를 위해 Yes, and don't ask again을 선택할 수도 있지만, > 프록시 서버를 신뢰하는 경우에만 권장합니다. > 자세한 내용은 아래 데이터 프라이버시 섹션을 참조하세요.

---

Data Privacy / 데이터 프라이버시

This skill sends requests to a proxy server at vercel-proxy-henna-eight.vercel.app.

이 스킬은 vercel-proxy-henna-eight.vercel.app 프록시 서버에 요청을 보냅니다.

What is sent / 전송되는 데이터

Station names (Korean or English, e.g., "강남", "Gangnam")

Search parameters (departure/arrival stations for routes, line filters for alerts, pagination values)

Standard HTTP headers (IP address, User-Agent)

역 이름, 검색 매개변수 및 표준 HTTP 헤더만 전송됩니다.

What is NOT sent / 전송되지 않는 데이터

Your conversation history or context

Personal information, files, or project data

Authentication credentials of any kind

대화 내용, 개인 정보, 파일 또는 프로젝트 데이터는 전송되지 않습니다.

Proxy server protections / 프록시 서버 보호 조치

Input validation: Station names limited to 50 characters, Korean/English/numbers only

Rate limiting: 100 requests per minute per IP

Sensitive data masking: API keys and tokens are masked in all server logs

No authentication required: No user accounts or tracking

Open source: Proxy source code is available at github.com/dukbong/seoul-subway

입력 검증, 속도 제한, 로그에서의 민감 정보 마스킹, 인증 불필요, 오픈 소스.

---

Proxy API Reference

All API calls go through the proxy server. No API keys needed for users.

> Note: The curl commands below are for API reference only. > Claude uses WebFetch to call these endpoints -- no binary tools are required. > > 아래 curl 명령은 API 참조용입니다. Claude는 WebFetch를 사용하여 이 엔드포인트를 호출합니다.

Base URL

https://vercel-proxy-henna-eight.vercel.app

1. Real-time Arrival Info

Endpoint

GET /api/realtime/{station}?start=0&end=10

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | station | Yes | Station name (Korean, URL-encoded) | | start | No | Start index (default: 0) | | end | No | End index (default: 10) | | format | No | formatted (markdown, default) or raw (JSON) | | lang | No | ko (default) or en |

Response Fields

| Field | Description | |-------|-------------| | subwayId | Line ID (1002=Line 2, 1077=Sinbundang) | | trainLineNm | Direction (e.g., "성수행 - 역삼방면") | | arvlMsg2 | Arrival time (e.g., "4분 20초 후") | | arvlMsg3 | Current location | | isFastTrain | Fast train flag (1=급행) |

Example

curl "https://vercel-proxy-henna-eight.vercel.app/api/realtime/강남"

---

2. Station Search

Endpoint

GET /api/stations?station={name}&start=1&end=10

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | station | Yes | Station name to search | | start | No | Start index (default: 1) | | end | No | End index (default: 10) |

Response Fields

| Field | Description | |-------|-------------| | STATION_CD | Station code | | STATION_NM | Station name | | LINE_NUM | Line name (e.g., "02호선") | | FR_CODE | External station code |

Example

curl "https://vercel-proxy-henna-eight.vercel.app/api/stations?station=강남"

---

3. Route Search

Endpoint

GET /api/route?dptreStnNm={departure}&arvlStnNm={arrival}

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | dptreStnNm | Yes | Departure station | | arvlStnNm | Yes | Arrival station | | searchDt | No | Datetime (yyyy-MM-dd HH:mm:ss) | | searchType | No | duration / distance / transfer | | format | No | formatted (markdown, default) or raw (JSON) | | lang | No | ko (default) or en |

Response Fields

| Field | Description | |-------|-------------| | totalDstc | Total distance (m) | | totalreqHr | Total time (seconds) | | totalCardCrg | Fare (KRW) | | paths[].trainno | Train number | | paths[].trainDptreTm | Departure time | | paths[].trainArvlTm | Arrival time | | paths[].trsitYn | Transfer flag |

Example

curl "https://vercel-proxy-henna-eight.vercel.app/api/route?dptreStnNm=신도림&arvlStnNm=서울역"

---

4. Service Alerts

Endpoint

GET /api/alerts?pageNo=1&numOfRows=10&format=enhanced

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | pageNo | No | Page number (default: 1) | | numOfRows | No | Results per page (default: 10) | | lineNm | No | Filter by line | | format | No | default or enhanced (structured response) |

Response Fields (Default)

| Field | Description | |-------|-------------| | ntceNo | Notice number | | ntceSj | Notice title | | ntceCn | Notice content | | lineNm | Line name | | regDt | Registration date |

Response Fields (Enhanced)

| Field | Description | |-------|-------------| | summary.delayedLines | Lines with delays | | summary.suspendedLines | Lines with service suspended | | summary.normalLines | Lines operating normally | | alerts[].lineName | Line name (Korean) | | alerts[].lineNameEn | Line name (English) | | alerts[].status | normal, delayed, or suspended | | alerts[].severity | low, medium, or high | | alerts[].title | Alert title |

Example

# Default format
curl "https://vercel-proxy-henna-eight.vercel.app/api/alerts"
Enhanced format with status summary
curl "https://vercel-proxy-henna-eight.vercel.app/api/alerts?format=enhanced"

---

5. Last Train Time

> 참고: 이 API는 주요 역 77개의 막차 시간을 정적 데이터로 제공합니다. > 서울교통공사 2025년 1월 기준 데이터입니다. > > 지원 역 (77개): > 가산디지털단지, 강남, 강남구청, 강변, 건대입구, 경복궁, 고속터미널, 공덕, 광나루, 광화문, 교대, 구로, 군자, 김포공항, 노량진, 당산, 대림, 동대문, 동대문역사문화공원, 디지털미디어시티, 뚝섬, 마포구청, 명동, 모란, 몽촌토성, 복정, 불광, 사가정, 사당, 삼각지, 삼성, 상봉, 서울대입구, 서울역, 선릉, 성수, 수유, 시청, 신논현, 신당, 신도림, 신사, 신촌, 안국, 압구정, 약수, 양재, 여의도, 역삼, 연신내, 영등포, 옥수, 올림픽공원, 왕십리, 용산, 을지로3가, 을지로4가, 을지로입구, 응암, 이대, 이촌, 이태원, 인천공항1터미널, 인천공항2터미널, 잠실, 정자, 종각, 종로3가, 종합운동장, 천호, 청담, 충무로, 판교, 합정, 혜화, 홍대입구, 효창공원앞

Endpoint

GET /api/last-train/{station}?direction=up&weekType=1

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | station | Yes | Station name (Korean or English) | | direction | No | up, down, or all (default: all) | | weekType | No | 1=Weekday, 2=Saturday, 3=Sunday/Holiday (default: auto) |

Response Fields

| Field | Description | |-------|-------------| | station | Station name (Korean) | | stationEn | Station name (English) | | lastTrains[].direction | Direction (Korean) | | lastTrains[].directionEn | Direction (English) | | lastTrains[].time | Last train time (HH:MM) | | lastTrains[].weekType | Day type (Korean) | | lastTrains[].weekTypeEn | Day type (English) | | lastTrains[].line | Line name | | lastTrains[].lineEn | Line name (English) | | lastTrains[].destination | Final destination | | lastTrains[].destinationEn | Destination (English) |

Example

# Auto-detect day type
curl "https://vercel-proxy-henna-eight.vercel.app/api/last-train/홍대입구"
English station name
curl "https://vercel-proxy-henna-eight.vercel.app/api/last-train/Hongdae"
Specific direction and day
curl "https://vercel-proxy-henna-eight.vercel.app/api/last-train/강남?direction=up&weekType=1"

---

6. Exit Information

> 참고: 이 API는 주요 역 77개의 출구 정보를 정적 데이터로 제공합니다. > > 지원 역 (77개): > 가산디지털단지, 강남, 강남구청, 강변, 건대입구, 경복궁, 고속터미널, 공덕, 광나루, 광화문, 교대, 구로, 군자, 김포공항, 노량진, 당산, 대림, 동대문, 동대문역사문화공원, 디지털미디어시티, 뚝섬, 마포구청, 명동, 모란, 몽촌토성, 복정, 불광, 사가정, 사당, 삼각지, 삼성, 상봉, 서울대입구, 서울역, 선릉, 성수, 수유, 시청, 신논현, 신당, 신도림, 신사, 신촌, 안국, 압구정, 약수, 양재, 여의도, 역삼, 연신내, 영등포, 옥수, 올림픽공원, 왕십리, 용산, 을지로3가, 을지로4가, 을지로입구, 응암, 이대, 이촌, 이태원, 인천공항1터미널, 인천공항2터미널, 잠실, 정자, 종각, 종로3가, 종합운동장, 천호, 청담, 충무로, 판교, 합정, 혜화, 홍대입구, 효창공원앞

Endpoint

GET /api/exits/{station}

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | station | Yes | Station name (Korean or English) |

Error Response (Unsupported Station)

{
  "code": "INVALID_STATION",
  "message": "Exit information not available for this station",
  "hint": "Exit information is available for major tourist stations only"
}

Response Fields

| Field | Description | |-------|-------------| | station | Station name (Korean) | | stationEn | Station name (English) | | line | Line name | | exits[].number | Exit number | | exits[].landmark | Nearby landmark (Korean) | | exits[].landmarkEn | Nearby landmark (English) | | exits[].distance | Walking distance | | exits[].facilities | Facility types |

Example

# Get COEX exit info
curl "https://vercel-proxy-henna-eight.vercel.app/api/exits/삼성"
English station name
curl "https://vercel-proxy-henna-eight.vercel.app/api/exits/Samsung"

---

7. Accessibility Info

Endpoint

GET /api/accessibility/{station}

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | station | Yes | Station name (Korean or English) | | type | No | elevator, escalator, wheelchair, or all (default: all) | | format | No | formatted (markdown, default) or raw (JSON) | | lang | No | ko (default) or en |

Response Fields

| Field | Description | |-------|-------------| | station | Station name (Korean) | | stationEn | Station name (English) | | elevators[].lineNm | Line name | | elevators[].dtlPstn | Detailed location | | elevators[].bgngFlr / endFlr | Floor level (start/end) | | elevators[].bgngFlrGrndUdgdSe | Ground/underground (지상/지하) | | elevators[].oprtngSitu | Operation status (M=normal) | | escalators[] | Same structure as elevators | | wheelchairLifts[] | Same structure as elevators |

Example

# All accessibility info
curl "https://vercel-proxy-henna-eight.vercel.app/api/accessibility/강남"
Elevators only
curl "https://vercel-proxy-henna-eight.vercel.app/api/accessibility/강남?type=elevator"
English output
curl "https://vercel-proxy-henna-eight.vercel.app/api/accessibility/Gangnam?lang=en"
Raw JSON
curl "https://vercel-proxy-henna-eight.vercel.app/api/accessibility/강남?format=raw"

---

8. Quick Exit Info

Endpoint

GET /api/quick-exit/{station}

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | station | Yes | Station name (Korean or English) | | facility | No | elevator, escalator, exit, or all (default: all) | | format | No | formatted (markdown, default) or raw (JSON) | | lang | No | ko (default) or en |

Response Fields

| Field | Description | |-------|-------------| | station | Station name (Korean) | | stationEn | Station name (English) | | quickExits[].lineNm | Line name | | quickExits[].drtnInfo | Direction | | quickExits[].qckgffVhclDoorNo | Best car/door number | | quickExits[].plfmCmgFac | Facility type (엘리베이터/계단/에스컬레이터) | | quickExits[].upbdnbSe | Up/down direction (상행/하행) | | quickExits[].elvtrNo | Elevator number (if applicable) |

Example

# All quick exit info
curl "https://vercel-proxy-henna-eight.vercel.app/api/quick-exit/강남"
Filter by elevator
curl "https://vercel-proxy-henna-eight.vercel.app/api/quick-exit/강남?facility=elevator"
English station name
curl "https://vercel-proxy-henna-eight.vercel.app/api/quick-exit/Gangnam"

---

9. Restroom Info

Endpoint

GET /api/restrooms/{station}

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | station | Yes | Station name (Korean or English) | | format | No | formatted (markdown, default) or raw (JSON) | | lang | No | ko (default) or en |

Response Fields

| Field | Description | |-------|-------------| | station | Station name (Korean) | | stationEn | Station name (English) | | restrooms[].lineNm | Line name | | restrooms[].dtlPstn | Detailed location | | restrooms[].stnFlr | Floor level (e.g., B1) | | restrooms[].grndUdgdSe | Ground/underground (지상/지하) | | restrooms[].gateInoutSe | Inside/outside gate (내부/외부) | | restrooms[].rstrmInfo | Restroom type info | | restrooms[].whlchrAcsPsbltyYn | Wheelchair accessible (Y/N) |

Example

# Get restroom info
curl "https://vercel-proxy-henna-eight.vercel.app/api/restrooms/강남"
English output
curl "https://vercel-proxy-henna-eight.vercel.app/api/restrooms/Gangnam?lang=en"
Raw JSON
curl "https://vercel-proxy-henna-eight.vercel.app/api/restrooms/강남?format=raw"

---

Landmark → Station Mapping

외국인 관광객이 자주 찾는 랜드마크와 해당 역 정보입니다.

| Landmark | Station | Line | Exit | |----------|---------|------|------| | COEX / 코엑스 | 삼성 Samsung | 2호선 | 5-6 | | Lotte World / 롯데월드 | 잠실 Jamsil | 2호선 | 4 | | Lotte World Tower | 잠실 Jamsil | 2호선 | 3 | | Gyeongbokgung Palace / 경복궁 | 경복궁 Gyeongbokgung | 3호선 | 5 | | Changdeokgung Palace / 창덕궁 | 안국 Anguk | 3호선 | 3 | | DDP / 동대문디자인플라자 | 동대문역사문화공원 | 2호선 | 1 | | Myeongdong / 명동 | 명동 Myeongdong | 4호선 | 6 | | N Seoul Tower / 남산타워 | 명동 Myeongdong | 4호선 | 3 | | Bukchon Hanok Village | 안국 Anguk | 3호선 | 6 | | Insadong / 인사동 | 안국 Anguk | 3호선 | 1 | | Hongdae / 홍대 | 홍대입구 Hongik Univ. | 2호선 | 9 | | Itaewon / 이태원 | 이태원 Itaewon | 6호선 | 1 | | Gangnam / 강남 | 강남 Gangnam | 2호선 | 10-11 | | Yeouido Park / 여의도공원 | 여의도 Yeouido | 5호선 | 5 | | IFC Mall | 여의도 Yeouido | 5호선 | 1 | | 63 Building | 여의도 Yeouido | 5호선 | 3 | | Gwanghwamun Square / 광화문광장 | 광화문 Gwanghwamun | 5호선 | 2 | | Namdaemun Market / 남대문시장 | 서울역 Seoul Station | 1호선 | 10 | | Cheonggyecheon Stream / 청계천 | 을지로입구 Euljiro 1-ga | 2호선 | 6 | | Express Bus Terminal | 고속터미널 Express Terminal | 3호선 | 4,8 | | Gimpo Airport | 김포공항 Gimpo Airport | 5호선 | 1,3 | | Incheon Airport T1 | 인천공항1터미널 | 공항철도 | 1 | | Incheon Airport T2 | 인천공항2터미널 | 공항철도 | 1 |

---

Static Data (GitHub Raw)

For static data like station lists and line mappings, use GitHub raw URLs:

# Station list
curl "https://raw.githubusercontent.com/dukbong/seoul-subway/main/data/stations.json"
Line ID mappings
curl "https://raw.githubusercontent.com/dukbong/seoul-subway/main/data/lines.json"
Station name translations
curl "https://raw.githubusercontent.com/dukbong/seoul-subway/main/data/station-names.json"

---

Line ID Mapping

| Line | ID | Line | ID | |------|----|------|----| | Line 1 | 1001 | Line 6 | 1006 | | Line 2 | 1002 | Line 7 | 1007 | | Line 3 | 1003 | Line 8 | 1008 | | Line 4 | 1004 | Line 9 | 1009 | | Line 5 | 1005 | Sinbundang | 1077 | | Gyeongui-Jungang | 1063 | Gyeongchun | 1067 | | Airport Railroad | 1065 | Suin-Bundang | 1075 |

---

Station Name Mapping (English → Korean)

주요 역 이름의 영어-한글 매핑 테이블입니다. API 호출 시 영어 입력을 한글로 변환해야 합니다.

Line 1 (1호선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Seoul Station | 서울역 | City Hall | 시청 | | Jonggak | 종각 | Jongno 3-ga | 종로3가 | | Jongno 5-ga | 종로5가 | Dongdaemun | 동대문 | | Cheongnyangni | 청량리 | Yongsan | 용산 | | Noryangjin | 노량진 | Yeongdeungpo | 영등포 | | Guro | 구로 | Incheon | 인천 | | Bupyeong | 부평 | Suwon | 수원 |

Line 2 (2호선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Gangnam | 강남 | Yeoksam | 역삼 | | Samseong | 삼성 | Jamsil | 잠실 | | Sindorim | 신도림 | Hongdae (Hongik Univ.) | 홍대입구 | | Hapjeong | 합정 | Dangsan | 당산 | | Yeouido | 여의도 | Konkuk Univ. | 건대입구 | | Seolleung | 선릉 | Samsung | 삼성 | | Sports Complex | 종합운동장 | Gangbyeon | 강변 | | Ttukseom | 뚝섬 | Seongsu | 성수 | | Wangsimni | 왕십리 | Euljiro 3-ga | 을지로3가 | | Euljiro 1-ga | 을지로입구 | City Hall | 시청 | | Chungjeongno | 충정로 | Ewha Womans Univ. | 이대 | | Sinchon | 신촌 | Sadang | 사당 | | Nakseongdae | 낙성대 | Seoul Nat'l Univ. | 서울대입구 | | Guro Digital Complex | 구로디지털단지 | Mullae | 문래 |

Line 3 (3호선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Gyeongbokgung | 경복궁 | Anguk | 안국 | | Jongno 3-ga | 종로3가 | Chungmuro | 충무로 | | Dongguk Univ. | 동대입구 | Yaksu | 약수 | | Apgujeong | 압구정 | Sinsa | 신사 | | Express Bus Terminal | 고속터미널 | Gyodae | 교대 | | Nambu Bus Terminal | 남부터미널 | Yangjae | 양재 | | Daehwa | 대화 | Juyeop | 주엽 |

Line 4 (4호선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Myeongdong | 명동 | Hoehyeon | 회현 | | Seoul Station | 서울역 | Sookmyung Women's Univ. | 숙대입구 | | Dongdaemun History & Culture Park | 동대문역사문화공원 | Hyehwa | 혜화 | | Hansung Univ. | 한성대입구 | Mia | 미아 | | Mia Sageori | 미아사거리 | Gireum | 길음 | | Chongshin Univ. | 총신대입구 | Sadang | 사당 |

Line 5 (5호선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Gwanghwamun | 광화문 | Jongno 3-ga | 종로3가 | | Dongdaemun History & Culture Park | 동대문역사문화공원 | Cheonggu | 청구 | | Wangsimni | 왕십리 | Haengdang | 행당 | | Yeouido | 여의도 | Yeouinaru | 여의나루 | | Mapo | 마포 | Gongdeok | 공덕 | | Gimpo Airport | 김포공항 | Banghwa | 방화 |

Line 6 (6호선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Itaewon | 이태원 | Samgakji | 삼각지 | | Noksapyeong | 녹사평 | Hangang | 한강진 | | Sangsu | 상수 | Hapjeong | 합정 | | World Cup Stadium | 월드컵경기장 | Digital Media City | 디지털미디어시티 |

Line 7 (7호선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Gangnam-gu Office | 강남구청 | Cheongdam | 청담 | | Konkuk Univ. | 건대입구 | Children's Grand Park | 어린이대공원 | | Junggok | 중곡 | Ttukseom Resort | 뚝섬유원지 | | Express Bus Terminal | 고속터미널 | Nonhyeon | 논현 | | Hakdong | 학동 | Bogwang | 보광 | | Jangam | 장암 | Dobongsan | 도봉산 |

Line 8 (8호선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Jamsil | 잠실 | Mongchontoseong | 몽촌토성 | | Gangdong-gu Office | 강동구청 | Cheonho | 천호 | | Bokjeong | 복정 | Sanseong | 산성 | | Moran | 모란 | Amsa | 암사 |

Line 9 (9호선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Sinnonhyeon | 신논현 | Express Bus Terminal | 고속터미널 | | Dongjak | 동작 | Noryangjin | 노량진 | | Yeouido | 여의도 | National Assembly | 국회의사당 | | Dangsan | 당산 | Yeomchang | 염창 | | Gimpo Airport | 김포공항 | Gaehwa | 개화 | | Olympic Park | 올림픽공원 | Sports Complex | 종합운동장 |

Sinbundang Line (신분당선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Gangnam | 강남 | Sinsa | 신사 | | Yangjae | 양재 | Yangjae Citizen's Forest | 양재시민의숲 | | Pangyo | 판교 | Jeongja | 정자 | | Dongcheon | 동천 | Suji District Office | 수지구청 | | Gwanggyo | 광교 | Gwanggyo Jungang | 광교중앙 |

Gyeongui-Jungang Line (경의중앙선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Seoul Station | 서울역 | Hongdae (Hongik Univ.) | 홍대입구 | | Gongdeok | 공덕 | Hyochang Park | 효창공원앞 | | Yongsan | 용산 | Oksu | 옥수 | | Wangsimni | 왕십리 | Cheongnyangni | 청량리 | | DMC | 디지털미디어시티 | Susaek | 수색 | | Ilsan | 일산 | Paju | 파주 |

Airport Railroad (공항철도)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Seoul Station | 서울역 | Gongdeok | 공덕 | | Hongdae (Hongik Univ.) | 홍대입구 | Digital Media City | 디지털미디어시티 | | Gimpo Airport | 김포공항 | Incheon Airport T1 | 인천공항1터미널 | | Incheon Airport T2 | 인천공항2터미널 | Cheongna Int'l City | 청라국제도시 |

Suin-Bundang Line (수인분당선)

| English | Korean | English | Korean | |---------|--------|---------|--------| | Wangsimni | 왕십리 | Seolleung | 선릉 | | Gangnam-gu Office | 강남구청 | Seonjeongneung | 선정릉 | | Jeongja | 정자 | Migeum | 미금 | | Ori | 오리 | Jukjeon | 죽전 | | Suwon | 수원 | Incheon | 인천 |

---

Usage Examples

Real-time Arrival

curl "https://vercel-proxy-henna-eight.vercel.app/api/realtime/강남"

Station Search

curl "https://vercel-proxy-henna-eight.vercel.app/api/stations?station=강남"

Route Search

curl "https://vercel-proxy-henna-eight.vercel.app/api/route?dptreStnNm=신도림&arvlStnNm=서울역"

Service Alerts

curl "https://vercel-proxy-henna-eight.vercel.app/api/alerts"
Enhanced format with delay summary
curl "https://vercel-proxy-henna-eight.vercel.app/api/alerts?format=enhanced"

Last Train

# Korean station name
curl "https://vercel-proxy-henna-eight.vercel.app/api/last-train/홍대입구"
English station name
curl "https://vercel-proxy-henna-eight.vercel.app/api/last-train/Gangnam"

Exit Information

# For COEX
curl "https://vercel-proxy-henna-eight.vercel.app/api/exits/삼성"
For Lotte World
curl "https://vercel-proxy-henna-eight.vercel.app/api/exits/잠실"

Accessibility

# All accessibility info
curl "https://vercel-proxy-henna-eight.vercel.app/api/accessibility/강남"
Elevators only
curl "https://vercel-proxy-henna-eight.vercel.app/api/accessibility/강남?type=elevator"

Quick Exit

# Quick exit for elevators
curl "https://vercel-proxy-henna-eight.vercel.app/api/quick-exit/강남?facility=elevator"

Restrooms

# Restroom locations
curl "https://vercel-proxy-henna-eight.vercel.app/api/restrooms/강남"

---

Line Color Mapping / 노선 색상 매핑

| Line / 호선 | Color / 색상 | Emoji | |-------------|--------------|-------| | 1호선 / Line 1 | Blue / 파랑 | 🔵 | | 2호선 / Line 2 | Green / 초록 | 🟢 | | 3호선 / Line 3 | Orange / 주황 | 🟠 | | 4호선 / Line 4 | Sky Blue / 하늘 | 🔵 | | 5호선 / Line 5 | Purple / 보라 | 🟣 | | 6호선 / Line 6 | Brown / 갈색 | 🟤 | | 7호선 / Line 7 | Olive / 올리브 | 🟢 | | 8호선 / Line 8 | Pink / 분홍 | 🔴 | | 9호선 / Line 9 | Gold / 금색 | 🟡 | | 신분당선 / Sinbundang | Red / 빨강 | 🔴 | | 경의중앙선 / Gyeongui-Jungang | Cyan / 청록 | 🔵 | | 공항철도 / Airport Railroad | Blue / 파랑 | 🔵 | | 수인분당선 / Suin-Bundang | Yellow / 노랑 | 🟡 |

---

Output Format Guide

Real-time Arrival

Korean:

[강남역 Gangnam]
| 호선 | 방향 | 도착 | 위치 | 유형 |
|------|------|------|------|------|
| 🟢 2 | 성수 (Seongsu) | 3분 | 역삼 | 일반 |
| 🟢 2 | 신촌 (Sinchon) | 5분 | 선정릉 | 일반 |

English:

[Gangnam Station 강남역]
| Line | Direction | Arrival | Location | Type |
|------|-----------|---------|----------|------|
| 🟢 2 | Seongsu (성수) | 3 min | Yeoksam | Regular |
| 🟢 2 | Sinchon (신촌) | 5 min | Seonjeongneung | Regular |

Station Search

Korean:

[강남역]
| 호선 | 역코드 | 외부코드 |
|------|--------|----------|
| 2호선 | 222 | 0222 |

English:

[Gangnam Station]
| Line | Station Code | External Code |
|------|--------------|---------------|
| Line 2 | 222 | 0222 |

Route Search

Korean:

[강남 → 홍대입구]
소요시간: 38분 | 거리: 22.1km | 요금: 1,650원 | 환승: 1회
🟢 강남 ─2호선─▶ 🟢 신도림 ─2호선─▶ 🟢 홍대입구
| 구분 | 역 | 호선 | 시간 |
|------|-----|------|------|
| 출발 | 강남 Gangnam | 🟢 2 | 09:03 |
| 환승 | 신도림 Sindorim | 🟢 2→2 | 09:18 |
| 도착 | 홍대입구 Hongdae | 🟢 2 | 09:42 |

English:

[Gangnam → Hongdae]
Time: 38 min | Distance: 22.1 km | Fare: 1,650 KRW | Transfer: 1
🟢 Gangnam ─Line 2─▶ 🟢 Sindorim ─Line 2─▶ 🟢 Hongdae
| Step | Station | Line | Time |
|------|---------|------|------|
| Depart | Gangnam 강남 | 🟢 2 | 09:03 |
| Transfer | Sindorim 신도림 | 🟢 2→2 | 09:18 |
| Arrive | Hongdae 홍대입구 | 🟢 2 | 09:42 |

Service Alerts

Korean:

[운행 알림]
🔵 1호선 | 종로3가역 무정차 (15:00 ~ 15:22)
└─ 코레일 열차 연기 발생으로 인함
🟢 2호선 | 정상 운행

English:

[Service Alerts]
🔵 Line 1 | Jongno 3-ga Non-stop (15:00 ~ 15:22)
└─ Due to smoke from Korail train
🟢 Line 2 | Normal operation

Last Train

Korean:

[홍대입구 막차 시간]
| 방향 | 시간 | 종착역 | 요일 |
|------|------|--------|------|
| 🟢 내선순환 | 00:32 | 성수 | 평일 |
| 🟢 외선순환 | 00:25 | 신도림 | 평일 |

English:

[Last Train - Hongik Univ.]
| Direction | Time | Destination | Day |
|-----------|------|-------------|-----|
| 🟢 Inner Circle | 00:32 | Seongsu | Weekday |
| 🟢 Outer Circle | 00:25 | Sindorim | Weekday |

Exit Info

Korean:

[삼성역 출구 정보]
| 출구 | 시설 | 거리 |
|------|------|------|
| 5번 | 코엑스몰 | 도보 3분 |
| 6번 | 코엑스 아쿠아리움 | 도보 5분 |
| 7번 | 봉은사 | 도보 10분 |

English:

[Samsung Station Exits]
| Exit | Landmark | Distance |
|------|----------|----------|
| #5 | COEX Mall | 3 min walk |
| #6 | COEX Aquarium | 5 min walk |
| #7 | Bongeunsa Temple | 10 min walk |

Accessibility Info

Korean:

[강남역 접근성 정보 Gangnam]
🛗 엘리베이터
| 호선 | 위치 | 층 | 구분 |
|------|------|-----|------|
| 2호선 | 대합실 | 지하 B1 | 일반 |
| 신분당선 | 개찰구 | 지하 B2 | 일반 |
운영 현황
| 번호 | 위치 | 상태 | 운영시간 |
|------|------|------|----------|
| 1 | 대합실 | 🟢 정상 | 05:30 ~ 24:00 |
↗️ 에스컬레이터
| 호선 | 위치 | 층 | 구분 |
|------|------|-----|------|
| 2호선 | 출구 1 | 지하 B1 | 상행 |
♿ 휠체어리프트
| 호선 | 번호 | 위치 | 상태 |
|------|------|------|------|
| 2호선 | 1 | 3번 출구 | 🟢 정상 |

English:

[Gangnam Station Accessibility 강남역]
🛗 Elevators
| Line | Location | Floor | Type |
|------|----------|-------|------|
| Line 2 | Concourse | Underground B1 | General |
↗️ Escalators
| Line | Location | Floor | Type |
|------|----------|-------|------|
| Line 2 | Exit 1 | Underground B1 | Up |
♿ Wheelchair Lifts
| Line | No. | Location | Status |
|------|-----|----------|--------|
| Line 2 | 1 | Exit 3 | 🟢 Normal |

Quick Exit

Korean:

[강남역 빠른하차 정보 Gangnam]
| 호선 | 방향 | 칸 | 출구 | 계단 | 엘리베이터 | 에스컬레이터 |
|------|------|-----|------|------|------------|--------------|
| 2호선 | 외선 | 3-2 | 1 | 1 | 1 | 1 |
| 2호선 | 내선 | 7-1 | 5 | 2 | 2 | 2 |

English:

[Gangnam Station Quick Exit 강남역]
| Line | Direction | Car | Exit | Stairs | Elevator | Escalator |
|------|-----------|-----|------|--------|----------|-----------|
| Line 2 | Outer | 3-2 | 1 | 1 | 1 | 1 |
| Line 2 | Inner | 7-1 | 5 | 2 | 2 | 2 |

Restrooms

Korean:

[강남역 화장실 정보 Gangnam]
| 호선 | 위치 | 층 | 개찰구 | 구분 | 변기수 | 기저귀교환대 |
|------|------|-----|--------|------|--------|--------------|
| 2호선 | 대합실 | 지하 B1 | 개찰구 내 | 일반 | 남 3 (소 5) 여 5 ♿ 1 | 👶 있음 |
| 2호선 | 출구1 | 지하 B1 | 개찰구 외 | 일반 | 남 2 (소 3) 여 3 | 없음 |
요약: 총 2개 | 개찰구 내 1개 | 개찰구 외 1개 | 장애인화장실 1개 | 기저귀교환대 있음

English:

[Gangnam Station Restrooms 강남역]
| Line | Location | Floor | Gate | Type | Toilets | Baby Station |
|------|----------|-------|------|------|---------|--------------|
| Line 2 | Concourse | Under B1 | Inside gate | General | M:3 (U:5) W:5 ♿:1 | 👶 Yes |
| Line 2 | Exit 1 | Under B1 | Outside gate | General | M:2 (U:3) W:3 | No |
Summary: Total 2 | Inside gate: 1 | Outside gate: 1 | Accessible: 1 | Baby station: Yes

Error

Korean:

오류: 역을 찾을 수 없습니다.
"강남" (역 이름만)으로 검색해 보세요.

English:

Error: Station not found.
Try searching with "Gangnam" (station name only).