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
CODEBLOCK0
1. Real-time Arrival Info
Endpoint
CODEBLOCK1
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 |
|---|
| INLINECODE14 | Line ID (1002=Line 2, 1077=Sinbundang) |
| INLINECODE15 |
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
CODEBLOCK3
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 |
|---|
| INLINECODE19 | Station code |
| INLINECODE20 |
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
CODEBLOCK5
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 |
|---|
| INLINECODE27 | Total distance (m) |
| INLINECODE28 |
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
CODEBLOCK7
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 |
|---|
| INLINECODE36 | Notice number |
| INLINECODE37 |
Notice title |
|
ntceCn | Notice content |
|
lineNm | Line name |
|
regDt | Registration date |
Response Fields (Enhanced)
| Field | Description |
|---|
| INLINECODE41 | Lines with delays |
| INLINECODE42 |
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
CODEBLOCK9
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 |
|---|
| INLINECODE61 | Station name (Korean) |
| INLINECODE62 |
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
CODEBLOCK11
Parameters
| Parameter | Required | Description |
|---|
| station | Yes | Station name (Korean or English) |
Error Response (Unsupported Station)
CODEBLOCK12
Response Fields
| Field | Description |
|---|
| INLINECODE72 | Station name (Korean) |
| INLINECODE73 |
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
CODEBLOCK14
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 |
|---|
| INLINECODE88 | Station name (Korean) |
| INLINECODE89 |
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
CODEBLOCK16
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 |
|---|
| INLINECODE106 | Station name (Korean) |
| INLINECODE107 |
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
CODEBLOCK18
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 |
|---|
| INLINECODE118 | Station name (Korean) |
| INLINECODE119 |
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:
CODEBLOCK20
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
CODEBLOCK21
Station Search
CODEBLOCK22
Route Search
CODEBLOCK23
Service Alerts
CODEBLOCK24
Last Train
CODEBLOCK25
Exit Information
CODEBLOCK26
Accessibility
CODEBLOCK27
Quick Exit
CODEBLOCK28
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:
CODEBLOCK30
English:
CODEBLOCK31
Station Search
Korean:
CODEBLOCK32
English:
CODEBLOCK33
Route Search
Korean:
CODEBLOCK34
English:
CODEBLOCK35
Service Alerts
Korean:
CODEBLOCK36
English:
CODEBLOCK37
Last Train
Korean:
CODEBLOCK38
English:
CODEBLOCK39
Exit Info
Korean:
CODEBLOCK40
English:
CODEBLOCK41
Accessibility Info
Korean:
CODEBLOCK42
English:
CODEBLOCK43
Quick Exit
Korean:
CODEBLOCK44
English:
CODEBLOCK45
Restrooms
Korean:
CODEBLOCK46
English:
CODEBLOCK47
Error
Korean:
CODEBLOCK48
English:
CODEBLOCK49
서울 지하철 스킬
실시간 서울 지하철 정보를 조회합니다. API 키 불필요 - 프록시 서버 사용.
기능
| 기능 | 설명 | 트리거 예시 (한국어) | 트리거 예시 (영어) |
|---|
| 실시간 도착 | 역별 열차 도착 시간 | 강남역 도착정보 | Gangnam station arrivals |
| 역 검색 |
호선 및 역 코드 조회 | 강남역 몇호선? | What line is Gangnam? |
| 경로 검색 | 시간/요금 포함 최단 경로 | 신도림에서 서울역 | Sindorim to Seoul Station |
| 운행 알림 | 지연, 사고, 무정차 | 지하철 지연 있어? | Any subway delays? |
|
막차 | 역별 막차 시간 | 홍대 막차 몇 시야? | Last train to Hongdae? |
|
출구 정보 | 랜드마크별 출구 번호 | 코엑스 몇 번 출구? | Which exit for COEX? |
|
접근성 | 엘리베이터, 에스컬레이터, 휠체어리프트 | 강남역 엘리베이터 | Gangnam elevators |
|
빠른하차 | 시설별 최적 칸 | 강남역 빠른하차 | Gangnam quick exit |
|
화장실 | 화장실 위치 | 강남역 화장실 | Gangnam restrooms |
자연어 트리거
다양한 자연어 표현을 인식합니다:
실시간 도착
| 영어 | 한국어 |
|---|
| Whens the next train at Gangnam? | 강남 몇 분 남았어? |
| Trains at Gangnam |
강남 열차 |
| Gangnam arrivals | 강남 언제 와? |
| Next train to Gangnam | 다음 열차 강남 |
경로 검색
| 영어 | 한국어 |
|---|
| How do I get to Seoul Station from Gangnam? | 강남에서 서울역 어떻게 가? |
| Gangnam → Seoul Station |
강남 → 서울역 |
| Gangnam to Seoul Station | 강남에서 서울역 가는 길 |
| Route from Gangnam to Hongdae | 강남부터 홍대까지 |
운행 알림
| 영어 | 한국어 |
|---|
| Is Line 2 running normally? | 2호선 정상 운행해? |
| Any delays on Line 1? |
1호선 지연 있어? |
| Subway status | 지하철 상황 |
| Line 3 alerts | 3호선 알림 |
막차 시간
| 영어 | 한국어 |
|---|
| Last train to Gangnam? | 강남 막차 몇 시야? |
| When is the last train at Hongdae? |
홍대입구 막차 시간 |
| Final train to Seoul Station | 서울역 막차 |
| Last train on Saturday? | 토요일 막차 시간 |
출구 정보
| 영어 | 한국어 |
|---|
| Which exit for COEX? | 코엑스 몇 번 출구? |
| Exit for Lotte World |
롯데월드 출구 |
| DDP which exit? | DDP 몇 번 출구? |
| Gyeongbokgung Palace exit | 경복궁 나가는 출구 |
접근성 정보
| 영어 | 한국어 |
|---|
| Gangnam station elevators | 강남역 엘리베이터 |
| Escalators at Seoul Station |
서울역 에스컬레이터 |
| Wheelchair lifts at Jamsil | 잠실역 휠체어리프트 |
| Accessibility info for Hongdae | 홍대입구 접근성 정보 |
빠른하차
| 영어 | 한국어 |
|---|
| Quick exit at Gangnam | 강남역 빠른하차 |
| Which car for elevator? |
엘리베이터 몇 번째 칸? |
| Best car for exit 3 | 3번 출구 가까운 칸 |
| Fastest exit at Samsung | 삼성역 빠른 하차 위치 |
화장실
| 영어 | 한국어 |
|---|
| Restrooms at Gangnam | 강남역 화장실 |
| Wheres the bathroom at Myeongdong? |
명동역 화장실 어디야? |
| Accessible restroom at Seoul Station | 서울역 장애인 화장실 |
| Baby changing station at Jamsil | 잠실역 기저귀 교환대 |
첫 사용 안내
처음 사용 시 프록시 도메인 접근 확인 창이 뜹니다.
권장: 이 세션에서 접근을 허용하려면 Yes를 선택하세요.
참고: 편의를 위해 Yes, and dont ask again을 선택할 수도 있지만,
프록시 서버를 신뢰하는 경우에만 권장합니다.
자세한 내용은 아래 데이터 프라이버시 섹션을 참조하세요.
데이터 프라이버시
이 스킬은 vercel-proxy-henna-eight.vercel.app 프록시 서버에 요청을 보냅니다.
전송되는 데이터
- - 역 이름 (한국어 또는 영어, 예: 강남, Gangnam)
- 검색 매개변수 (경로의 출발/도착역, 알림의 호선 필터, 페이지네이션 값)
- 표준 HTTP 헤더 (IP 주소, User-Agent)
역 이름, 검색 매개변수 및 표준 HTTP 헤더만 전송됩니다.
전송되지 않는 데이터
- - 대화 내용 또는 컨텍스트
- 개인 정보, 파일 또는 프로젝트 데이터
- 모든 종류의 인증 자격 증명
대화 내용, 개인 정보, 파일 또는 프로젝트 데이터는 전송되지 않습니다.
프록시 서버 보호 조치
- - 입력 검증: 역 이름 50자 제한, 한국어/영어/숫자만 허용
- 속도 제한: IP당 분당 100개 요청
- 민감 데이터 마스킹: 모든 서버 로그에서 API 키 및 토큰 마스킹
- 인증 불필요: 사용자 계정 또는 추적 없음
- 오픈 소스: 프록시 소스 코드는 github.com/dukbong/seoul-subway에서 확인 가능
입력 검증, 속도 제한, 로그에서의 민감 정보 마스킹, 인증 불필요, 오픈 소스.
프록시 API 참조
모든 API 호출은 프록시 서버를 통해 이루어집니다. 사용자에게 API 키가 필요하지 않습니다.
참고: 아래 curl 명령은 API 참조용입니다.
Claude는 WebFetch를 사용하여 이 엔드포인트를 호출합니다. 바이너리 도구가 필요하지 않습니다.
기본 URL
https://vercel-proxy-henna-eight.vercel.app
1. 실시간 도착 정보
엔드포인트
GET /api/realtime/{station}?start=0&end=10
매개변수
| 매개변수 | 필수 | 설명 |
|---|
| station | 예 | 역 이름 (한국어, URL 인코딩) |
| start |
아니오 | 시작 인덱스 (기본값: 0) |
| end | 아니오 | 종료 인덱스 (기본값: 10) |
| format | 아니오 | formatted (마크다운, 기본값) 또는 raw (JSON) |
| lang | 아니오 | ko (기본값) 또는 en |
응답 필드
| 필드 | 설명 |
|-------|-------------|
|