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

...