seoul-subway-arrival

首尔地铁到站信息

技能功能

通过 k-skill-proxy 代理查询首尔开放数据广场的实时地铁到站信息 Open API，汇总指定车站的预计到站列车信息。

使用场景

• "강남역 지금 몇 분 뒤 도착해?"（江南站现在几分钟后到达？）
• "서울역 1호선 도착 정보 보여줘"（首尔站1号线到站信息给我看看）
• "잠실역 곧 들어오는 열차 정리해줘"（蚕室站即将进站的列车整理一下）

前提条件

• 可选：jq
• 可选：KSKILL_PROXY_BASE_URL（仅在使用自托管代理时设置。留空则使用默认托管代理 https://k-skill-proxy.nomadamas.org）

所需环境变量

• 无。KSKILL_PROXY_BASE_URL 为可选，留空则使用默认托管代理 https://k-skill-proxy.nomadamas.org。

用户无需自行申请首尔开放数据广场的 OpenAPI key。/v1/seoul-subway/arrival 路由由默认托管代理调用，上游 key 仅保存在代理服务器端。仅在使用独立代理时才设置 KSKILL_PROXY_BASE_URL。

代理解析顺序

1. 如果设置了 KSKILL_PROXY_BASE_URL，则使用该值。
2. 如果未设置或为空，则使用默认托管代理 https://k-skill-proxy.nomadamas.org。
3. 仅当自行运行代理时，才在代理服务器端设置上游 key。

客户端/用户端不直接处理上游 key。

输入

• 车站名称
• 可选：获取条数

工作流程

1. 解析代理基础 URL

如果设置了 KSKILL_PROXY_BASE_URL 则使用该值，否则使用默认托管代理 https://k-skill-proxy.nomadamas.org。

2. 查询官方车站到站端点

代理在服务器端注入首尔实时地铁 API key，并仅公开基于车站名称的实时到站信息的只读端点。

BASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
curl -fsS --get "${BASE}/v1/seoul-subway/arrival" \
  --data-urlencode 'stationName=강남'

如有需要，可通过 startIndex、endIndex 调整响应范围。

3. 汇总响应

尽可能优先汇总以下项目：

• 线路
• 上行/下行或外线/内线
• 第一条到站信息
• 第二条到站信息
• 预计到站时间（如有，以秒为单位）

4. 谨慎处理实时数据

实时数据可能每隔几秒变化，因此在回答中应注明查询时间。

完成条件

• 已整理请求车站的预计到站列车信息
• 已注明实时数据的基准时间
• 上游 key 未暴露给客户端

失败模式

• 代理上游 key 未设置
• 配额超限
• 车站名称不一致

备注

• 首尔开放数据广场指南指出，实时地铁 Open API 可能有每日调用限制
• 代理运行/环境变量设置请参考 docs/features/k-skill-proxy.md
• 端点路径可能因 API 版本变更，失败时请重新检查数据集控制台的最新示例 URL