名称: seoul-subway
描述: 首尔地铁助手,提供实时到站、路线规划和服务提醒(韩语/英语)
model: sonnet
元数据: {"moltbot":{"emoji":"🚇"}}
主页: https://github.com/dukbong/seoul-subway
user-invocable: true
查询首尔地铁实时信息。无需 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" |
支持多种自然语言表达:
| 英语 | 韩语 |
|---|---|
| "When's 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" | "강남역 화장실" |
| "Where's the bathroom at Myeongdong?" | "명동역 화장실 어디야?" |
| "Accessible restroom at Seoul Station" | "서울역 장애인 화장실" |
| "Baby changing station at Jamsil" | "잠실역 기저귀 교환대" |
首次使用时,会看到代理域名访问权限提示。
推荐操作: 选择 Yes 允许本次会话访问。
注意: 为方便起见,也可选择
Yes, and don't ask again,但仅在你信任代理服务器时推荐。代理仅接收车站名称和搜索参数——绝不接收你的对话上下文或个人数据。详情见下文数据隐私部分。
本技能向 vercel-proxy-henna-eight.vercel.app 的代理服务器发送请求。
所有 API 调用均通过代理服务器。用户无需 API 密钥。
注意: 以下
curl命令仅用于 API 参考。Claude 使用WebFetch调用这些端点——无需二进制工具。
https://vercel-proxy-henna-eight.vercel.app
端点
GET /api/realtime/{station}?start=0&end=10
参数
| 参数 | 必需 | 描述 |
|---|---|---|
| station | 是 | 车站名称(韩语,URL 编码) |
| start | 否 | 起始索引(默认:0) |
| end | 否 | 结束索引(默认:10) |
| format | 否 | formatted(Markdown,默认)或 raw(JSON) |
| lang | 否 | ko(默认)或 en |
响应字段
| 字段 | 描述 |
|---|---|
subwayId |
线路 ID(1002=2号线,1077=新盆唐线) |
trainLineNm |
方向(如 "성수행 - 역삼방면") |
arvlMsg2 |
到达时间(如 "4분 20초 후") |
arvlMsg3 |
当前位置 |
isFastTrain |
快车标志(1=急行) |
示例
curl "https://vercel-proxy-henna-eight.vercel.app/api/realtime/강남"
端点
GET /api/stations?station={name}&start=1&end=10
参数
| 参数 | 必需 | 描述 |
|---|---|---|
| station | 是 | 要搜索的车站名称 |
| start | 否 | 起始索引(默认:1) |
| end | 否 | 结束索引(默认:10) |
响应字段
| 字段 | 描述 |
|---|---|
STATION_CD |
车站代码 |
STATION_NM |
车站名称 |
LINE_NUM |
线路名称(如 "02호선") |
FR_CODE |
外部车站代码 |
示例
curl "https://vercel-proxy-henna-eight.vercel.app/api/stations?station=강남"
端点
GET /api/route?dptreStnNm={departure}&arvlStnNm={arrival}
参数
| 参数 | 必需 | 描述 |
|---|---|---|
| dptreStnNm | 是 | 出发站 |
| arvlStnNm | 是 | 到达站 |
| searchDt | 否 | 日期时间(yyyy-MM-dd HH:mm:ss) |
| searchType | 否 | duration / distance / transfer |
| format | 否 | formatted(Markdown,默认)或 raw(JSON) |
| lang | 否 | ko(默认)或 en |
响应字段
| 字段 | 描述 |
|---|---|
totalDstc |
总距离(米) |
totalreqHr |
总时间(秒) |
totalCardCrg |
票价(韩元) |
paths[].trainno |
列车号 |
paths[].trainDptreTm |
出发时间 |
paths[].trainArvlTm |
到达时间 |
paths[].trsitYn |
换乘标志 |
示例
curl "https://vercel-proxy-henna-eight.vercel.app/api/route?dptreStnNm=신도림&arvlStnNm=서울역"
端点
GET /api/alerts?pageNo=1&numOfRows=10&format=enhanced
参数
| 参数 | 必需 | 描述 |
|---|---|---|
| pageNo | 否 | 页码(默认:1) |
| numOfRows | 否 | 每页结果数(默认:10) |
| lineNm | 否 | 按线路筛选 |
| format | 否 | default 或 enhanced(结构化响应) |
响应字段(默认格式)
| 字段 | 描述 |
|---|---|
ntceNo |
通知编号 |
ntceSj |
通知标题 |
ntceCn |
通知内容 |
lineNm |
线路名称 |
regDt |
注册日期 |
响应字段(增强格式)
| 字段 | 描述 |
|---|---|
summary.delayedLines |
延误线路 |
summary.suspendedLines |
停运线路 |
summary.normalLines |
正常运营线路 |
alerts[].lineName |
线路名称(韩语) |
alerts[].lineNameEn |
线路名称(英语) |
alerts[].status |
normal、delayed 或 suspended |
alerts[].severity |
low、medium 或 high |
alerts[].title |
提醒标题 |
示例
# 默认格式
curl "https://vercel-proxy-henna-eight.vercel.app/api/alerts"
# 增强格式(含状态摘要)
curl "https://vercel-proxy-henna-eight.vercel.app/api/alerts?format=enhanced"
注意: 此 API 提供 77 个主要车站的末班车时间静态数据。数据基于首尔交通公社 2025 年 1 月标准。
支持的车站(77个):
加山数码园区、江南、江南区厅、江边、建大入口、景福宫、高速巴士客运站、孔德、广渡口、光化门、教大、九老、君子、金浦机场、鹭梁津、堂山、大林、东大门、东大门历史文化公园、数码媒体城、纛岛、麻浦区厅、明洞、牡丹、梦村土城、福井、佛光、舍堂、三角地、三星、上凤、首尔大入口、首尔站、宣陵、圣水、水逾、市厅、新论岘、新堂、新道林、新沙、新村、安国、狎鸥亭、药水、良才、汝矣岛、驿三、延新内、永登浦、玉水、奥林匹克公园、往十里、龙山、乙支路3街、乙支路4街、乙支路入口、鹰岩、梨大、二村、梨泰院、仁川机场1航站楼、仁川机场2航站楼、蚕室、亭子、钟阁、钟路3街、综合运动场、千户、清潭、忠武路、板桥、合井、惠化、弘大入口、孝昌公园前
端点
GET /api/last-train/{station}?direction=up&weekType=1
参数
| 参数 | 必需 | 描述 |
|---|---|---|
| station | 是 | 车站名称(韩语或英语) |
| direction | 否 | up、down 或 all(默认:all) |
| weekType | 否 | 1=工作日、2=周六、3=周日/节假日(默认:自动) |
响应字段
| 字段 | 描述 |
|---|---|
station |
车站名称(韩语) |
stationEn |
车站名称(英语) |
lastTrains[].direction |
方向(韩语) |
lastTrains[].directionEn |
方向(英语) |
lastTrains[].time |
末班车时间(HH:MM) |
lastTrains[].weekType |
日期类型(韩语) |
lastTrains[].weekTypeEn |
日期类型(英语) |
lastTrains[].line |
线路名称 |
lastTrains[].lineEn |
线路名称(英语) |
lastTrains[].destination |
终点站 |
lastTrains[].destinationEn |
终点站(英语) |
示例
# 自动检测日期类型
curl "https://vercel-proxy-henna-eight.vercel.app/api/last-train/홍대입구"
# 英语车站名
curl "https://vercel-proxy-henna-eight.vercel.app/api/last-train/Hongdae"
# 指定方向和日期
curl "https://vercel-proxy-henna-eight.vercel.app/api/last-train/강남?direction=up&weekType=1"
注意: 此 API 提供 77 个主要车站的出口信息静态数据。
支持的车站(77个):
同上末班车支持的车站列表。
端点
GET /api/exits/{station}
参数
| 参数 | 必需 | 描述 |
|---|---|---|
| station | 是 | 车站名称(韩语或英语) |
错误响应(不支持的车站)
{
"code": "INVALID_STATION",
"message": "Exit information not available for this station",
"hint": "Exit information is available for major tourist stations only"
}
响应字段
| 字段 | 描述 |
|---|---|
station |
车站名称(韩语) |
stationEn |
车站名称(英语) |
line |
线路名称 |
exits[].number |
出口编号 |
exits[].landmark |
附近地标(韩语) |
exits[].landmarkEn |
附近地标(英语) |
exits[].distance |
步行距离 |
exits[].facilities |
设施类型 |
示例
# 获取 COEX 出口信息
curl "https://vercel-proxy-henna-eight.vercel.app/api/exits/삼성"
# 英语车站名
curl "https://vercel-proxy-henna-eight.vercel.app/api/exits/Samsung"
端点
GET /api/accessibility/{station}
参数
| 参数 | 必需 | 描述 |
|---|---|---|
| station | 是 | 车站名称 |