Seoul Subway

Seoul Subway Skill

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

Features

Natural Language Triggers / 자연어 트리거

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

Real-time Arrival / 실시간 도착

Route Search / 경로 검색

Service Alerts / 운행 알림

Last Train / 막차 시간

Exit Info / 출구 정보

Accessibility / 접근성 정보

Quick Exit / 빠른하차

Restrooms / 화장실

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

Response Fields

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

Response Fields

Example

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

3. Route Search

Endpoint

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

Parameters

Response Fields

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

Response Fields (Default)

Response Fields (Enhanced)

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

Response Fields

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

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

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

Response Fields

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

Response Fields

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

Response Fields

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

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

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

Station Name Mapping (English → Korean)

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

Line 1 (1호선)

Line 2 (2호선)

Line 3 (3호선)

Line 4 (4호선)

Line 5 (5호선)

Line 6 (6호선)

Line 7 (7호선)

Line 8 (8호선)

Line 9 (9호선)

Sinbundang Line (신분당선)

Gyeongui-Jungang Line (경의중앙선)

Airport Railroad (공항철도)

Suin-Bundang Line (수인분당선)

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 / 노선 색상 매핑

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).

US Subway Information (Beta) / 미국 지하철 정보 (베타)

When the user asks for US subway/metro info, use this section.

사용자가 미국 지하철/메트로 정보를 요청하면 이 섹션을 사용합니다.

Scope / 범위

• This skill remains Seoul-first.
• For US requests, provide city-specific results using the APIs below.
• If API behavior changes or a city is unsupported, verify current endpoints with Tavily/web search first.

이 스킬은 기본적으로 서울 지하철용입니다.
미국 요청은 아래 도시별 API로 처리하고, 동작이 불확실하면 Tavily/웹 검색으로 최신 엔드포인트를 먼저 확인합니다.

Supported US Data Sources / 지원 미국 데이터 소스

1) MBTA (Boston) - No API key required

• Docs: https://api-v3.mbta.com/docs/swagger/index.html
• Realtime predictions:
  • GET https://api-v3.mbta.com/predictions?filter[stop]={stop_id}&include=trip,route
• Subway routes:
  • GET https://api-v3.mbta.com/routes?filter[type]=0,1
• Stops search (name):
  • GET https://api-v3.mbta.com/stops?filter[name]={name}

2) BART (San Francisco Bay Area) - Public demo key available

• API overview: https://api.bart.gov/
• Use public key when user key is not provided: MW9S-E7SL-26DU-VV8V
• Station departures (etd):
  • GET https://api.bart.gov/api/etd.aspx?cmd=etd&orig={station_abbr}&key=MW9S-E7SL-26DU-VV8V&json=y
• Service advisories:
  • GET https://api.bart.gov/api/bsa.aspx?cmd=bsa&key=MW9S-E7SL-26DU-VV8V&json=y

3) MTA (New York City) - API key commonly required

• Main portal: https://api.mta.info/
• If user did not provide a key, explain key requirement and offer setup guidance.
• If key is provided, use MTA GTFS-Realtime feeds for arrivals/service alerts.

US Query Handling Rules / 미국 질의 처리 규칙

1. Detect city/system first: NYC(MTA), Boston(MBTA), SF Bay(BART), etc.
2. Use system-specific API and return:
   • next arrivals (minutes),
   • direction/destination,
   • service alerts (if available),
   • source URL.
3. If city is ambiguous, ask one short clarification question.
4. If API fails or endpoint is stale, use Tavily/web search to find current official API docs and retry.
5. Do not fabricate station codes, delays, or ETA.

Quick API Examples / 빠른 API 예시

MBTA (Boston) - South Station stops search

curl "https://api-v3.mbta.com/stops?filter[name]=South%20Station"

MBTA (Boston) - route list (subway only)

curl "https://api-v3.mbta.com/routes?filter[type]=0,1"

BART (SF) - Montgomery station departures

curl "https://api.bart.gov/api/etd.aspx?cmd=etd&orig=MONT&key=MW9S-E7SL-26DU-VV8V&json=y"

Fallback Message Template / 실패 시 안내 템플릿

Korean:
현재 해당 도시의 지하철 실시간 API를 확인할 수 없습니다. 공식 API 문서(또는 인증키) 확인 후 다시 조회할게요.

English:
I can't reliably access that city's realtime subway API right now. I'll verify the official API docs (or required API key) and retry.