Marketing & SalesDocumentedScanned

seoul-metro

Seoul Metro assistant for real-time arrivals, route planning, and service alerts (Korean/English)

Share:

Installation

npx clawhub@latest install seoul-metro

View the full skill documentation and source below.

Documentation

Seoul Metro Skill

Query real-time Seoul Metro information.

Features

FeatureDescriptionTrigger Example (KO)Trigger Example (EN)
Real-time ArrivalTrain arrival times by station"강남역 도착정보""Gangnam station arrivals"
Station SearchLine and station code lookup"강남역 몇호선?""What line is Gangnam?"
Route SearchShortest path with time/fare"신도림에서 서울역""Sindorim to Seoul Station"
Service AlertsDelays, incidents, non-stops"지하철 지연 있어?""Any subway delays?"

Environment Variables

VariableUsageProvider
SEOUL_OPENAPI_KEYArrival info, station searchdata.seoul.go.kr
DATA_GO_KR_KEYRoute search, alertsdata.go.kr
How to get API keys:
  • SEOUL_OPENAPI_KEY: Sign up at [data.seoul.go.kr](), go to "My Page" > "API Key Management"
  • DATA_GO_KR_KEY: Sign up at [data.go.kr](), search for the API service, and request access

    • API Reference

    1. Real-time Arrival Info

    Endpoint

    Response Fields

    FieldDescription
    subwayIdLine ID (1002=Line 2, 1077=Sinbundang)
    trainLineNmDirection (e.g., "성수행 - 역삼방면")
    arvlMsg2Arrival time (e.g., "4분 20초 후")
    arvlMsg3Current location
    btrainSttusTrain type (일반/급행)
    lstcarAtLast train (0=No, 1=Yes)

    2. Station Search

    Endpoint

    Response Fields

    FieldDescription
    STATION_CDStation code
    STATION_NMStation name
    LINE_NUMLine name (e.g., "02호선")
    FR_CODEExternal station code

    3. Route Search

    Endpoint

    Parameters

    ParameterRequiredDescription
    serviceKeyYesDATA_GO_KR_KEY
    dptreStnNmYesDeparture station
    arvlStnNmYesArrival station
    searchDtYesDatetime (yyyy-MM-dd HH:mm:ss)
    dataTypeYesJSON
    searchTypeNoduration / distance / transfer
    Response Fields
    FieldDescription
    totalDstcTotal distance (m)
    totalreqHrTotal time (seconds)
    totalCardCrgFare (KRW)
    paths[].trainnoTrain number
    paths[].trainDptreTmDeparture time
    paths[].trainArvlTmArrival time
    paths[].trsitYnTransfer flag

    4. Service Alerts

    Endpoint

    Parameters

    ParameterRequiredDescription
    serviceKeyYesDATA_GO_KR_KEY
    dataTypeYesJSON
    pageNoNoPage number
    numOfRowsNoResults per page
    lineNmNoFilter by line
    Response Fields
    FieldDescription
    noftTtlAlert title
    noftCnAlert content
    noftOcrnDtTimestamp
    lineNmLstAffected line(s)
    nonstopYnNon-stop flag
    xcseSitnBgngDtIncident start
    xcseSitnEndDtIncident end

    Line ID Mapping

    LineIDLineID
    Line 11001Line 61006
    Line 21002Line 71007
    Line 31003Line 81008
    Line 41004Line 91009
    Line 51005Sinbundang1077
    Gyeongui-Jungang1063Gyeongchun1067
    Airport Railroad1065Suin-Bundang1075

    Station Name Mapping (English → Korean)

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

    Line 1 (1호선)

    EnglishKoreanEnglishKorean
    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호선)

    EnglishKoreanEnglishKorean
    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호선)

    EnglishKoreanEnglishKorean
    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호선)

    EnglishKoreanEnglishKorean
    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호선)

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

    Line 6 (6호선)

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

    Line 7 (7호선)

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

    Line 8 (8호선)

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

    Line 9 (9호선)

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

    Sinbundang Line (신분당선)

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

    Gyeongui-Jungang Line (경의중앙선)

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

    Airport Railroad (공항철도)

    EnglishKoreanEnglishKorean
    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 (수인분당선)

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

    Usage Examples

    Real-time Arrival

    curl ""

    Station Search

    curl ""

    Route Search

    curl -G "" \
  --data-urlencode "dptreStnNm=신도림" \
  --data-urlencode "arvlStnNm=서울역" \
  --data-urlencode "searchDt=$(date '+%Y-%m-%d %H:%M:%S')"

    Service Alerts

    curl ""

    Output Format Guide

    Real-time Arrival

    Korean:

    [강남역 도착 정보]

| 호선 | 방향 | 도착 | 위치 | 유형 |
|------|------|------|------|------|
| 2호선 | 성수행 | 3분 | 역삼 | 일반 |

    English:

    [Gangnam Station Arrivals]

| Line | Direction | Arrival | Location | Type |
|------|-----------|---------|----------|------|
| Line 2 | Seongsu-bound | 3 min | Yeoksam | Regular |

    Station Search

    Korean:

    [강남역]

| 호선 | 역코드 | 외부코드 |
|------|--------|----------|
| 2호선 | 222 | 0222 |

    English:

    [Gangnam Station]

| Line | Station Code | External Code |
|------|--------------|---------------|
| Line 2 | 222 | 0222 |

    Route Search

    Korean:

    [강남 -> 홍대입구]

소요시간: 38분 | 거리: 22.1 km | 요금: 1,650원 | 환승: 1회

1. 09:03 강남 출발 (2호선 성수방면)
2. 09:18 신도림 환승 (2호선 -> 1호선)
3. 09:42 홍대입구 도착

    English:

    [Gangnam -> Hongdae]

Time: 38 min | Distance: 22.1 km | Fare: 1,650 KRW | Transfers: 1

1. 09:03 Depart Gangnam (Line 2 towards Seongsu)
2. 09:18 Transfer at Sindorim (Line 2 -> Line 1)
3. 09:42 Arrive Hongdae

    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

    Error

    Korean:

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

    English:

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

    API Key Errors

    Korean:

    오류: API 인증키가 설정되지 않았습니다.
환경 변수를 설정해주세요: SEOUL_OPENAPI_KEY

발급 안내:
- 서울열린데이터광장: 
- 공공데이터포털:

    English:

    Error: API key is not configured.
Please set environment variable: SEOUL_OPENAPI_KEY

Get your API key:
- Seoul Open Data Plaza: 
- Korea Public Data Portal:

    Korean:

    오류: API 인증키가 유효하지 않습니다.
인증키를 확인해주세요.

    English:

    Error: Invalid API key.
Please verify your API key.

    Back to Skills Directory

    Related Skills in Marketing & Sales

    4chan-reader

    Browse 4chan boards and extract thread discussions into structured text files.

    Docs

    ab-test-setup

    When the user wants to plan, design, or implement an A/B test or experiment.

    Docs

    affiliatematic

    affiliatematic skill for OpenClaw agents

    Docs

    apollo

    Interact with Apollo.io REST API (people/org enrichment, search, lists).

    Docs

    attio

    Attio CRM integration for managing companies, people, deals, notes, tasks.

    Docs