Seoul Subway Arrival
Answer real-time Seoul subway arrival questions in chat by calling the Seoul Open Data API through the hosted k-skill-proxy—no personal API key required.
Overview
Seoul Subway Arrival is an agent skill for the Build phase that fetches Seoul real-time subway arrival times through the k-skill-proxy without users supplying their own Open API key.
Install
npx skills add https://github.com/nomadamas/k-skill --skill seoul-subway-arrivalWhat is this skill?
- Queries Seoul real-time subway arrival data via `/v1/seoul-subway/arrival` on k-skill-proxy
- Default hosted proxy `https://k-skill-proxy.nomadamas.org` when `KSKILL_PROXY_BASE_URL` is unset
- Upstream Seoul Open Data API key stays on the proxy server—not in the client environment
- Inputs: station name plus optional result count; optional `jq` for response shaping
- Documented Korean trigger phrases for when users ask minutes-until-arrival by station
- Proxy route `/v1/seoul-subway/arrival`
- Default hosted base `https://k-skill-proxy.nomadamas.org`
Adoption & trust: 2.6k installs on skills.sh; 5.4k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want live Seoul subway arrival info in the agent, but you do not want every user to manage Seoul Open Data credentials or raw API URLs.
Who is it for?
Korean-speaking solo builders or travelers who need quick station-level arrival ETAs inside an agent workflow.
Skip if: Non-Seoul transit systems, offline timetable-only questions, or deployments that cannot make outbound HTTPS calls to the proxy.
When should I use this skill?
The user asks when a Seoul subway train arrives, which trains are approaching a station, or wants current arrival timing for a named 역.
What do I get? / Deliverables
The agent resolves the proxy, queries by station name, and returns a concise summary of imminent trains using hosted or self-hosted k-skill-proxy configuration.
- Summarized per-station arrival list
- Proxy-resolved API response interpretation
Recommended Skills
Journey fit
The skill is a thin API integration pattern (proxy base URL, route, summarization) that builders copy or invoke while wiring agent capabilities. integrations is the shelf for external HTTP APIs and proxy-backed data feeds, even when the end-user scenario is everyday transit lookup.
How it compares
Use for proxy-backed Seoul arrival lookup—not as a general global transit MCP or a static schedule database skill.
Common Questions / FAQ
Who is seoul-subway-arrival for?
Agents and builders serving Seoul metro riders who want real-time arrival summaries without end-user API key setup.
When should I use seoul-subway-arrival?
When someone asks how many minutes until trains arrive at a Seoul station, which lines are approaching, or wants a quick arrival board for stations like Gangnam or Jamsil.
Is seoul-subway-arrival safe to install?
It calls a third-party proxy over the network; review the Security Audits panel on this page and audit/nomadamas proxy hosting before production use.
SKILL.md
READMESKILL.md - Seoul Subway Arrival
# Seoul Subway Arrival ## What this skill does 서울 열린데이터 광장의 실시간 지하철 도착정보 Open API를 `k-skill-proxy` 경유로 조회해 역 기준 도착 예정 열차 정보를 요약한다. ## When to use - "강남역 지금 몇 분 뒤 도착해?" - "서울역 1호선 도착 정보 보여줘" - "잠실역 곧 들어오는 열차 정리해줘" ## Prerequisites - optional: `jq` - optional: `KSKILL_PROXY_BASE_URL` (self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted `https://k-skill-proxy.nomadamas.org` 를 사용한다.) ## Required environment variables - 없음. `KSKILL_PROXY_BASE_URL` 은 선택 사항이며, 비우면 기본 hosted `https://k-skill-proxy.nomadamas.org` 를 사용한다. 사용자가 개인 서울 열린데이터 광장 OpenAPI key를 직접 발급할 필요는 없다. `/v1/seoul-subway/arrival` route는 기본 hosted proxy에서 호출하고, upstream key는 proxy 서버 쪽에만 보관한다. 별도 proxy를 쓰는 경우에만 `KSKILL_PROXY_BASE_URL` 을 설정한다. ### Proxy resolution order 1. **`KSKILL_PROXY_BASE_URL` 이 있으면** 그 값을 사용한다. 2. **없거나 빈 값이면** 기본 hosted proxy `https://k-skill-proxy.nomadamas.org` 를 사용한다. 3. **직접 proxy를 운영하는 경우에만** proxy 서버 upstream key를 서버 쪽에만 설정한다. 클라이언트/사용자 쪽에서 upstream key를 직접 다루지 않는다. ## Inputs - 역명 - 선택 사항: 가져올 건수 ## Workflow ### 1. Resolve the proxy base URL `KSKILL_PROXY_BASE_URL` 이 있으면 그 값을 사용하고, 없거나 비어 있으면 기본 hosted proxy `https://k-skill-proxy.nomadamas.org` 를 사용한다. ### 2. Query the official station arrival endpoint proxy는 서울 실시간 지하철 API key를 서버에서 주입하고, 역명 기준 실시간 도착정보만 공개 read-only endpoint로 노출한다. ```bash 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. Summarize the response 가능하면 아래 항목만 먼저 요약한다. - 호선 - 상/하행 또는 외/내선 - 첫 번째 도착 메시지 - 두 번째 도착 메시지 - 도착 예정 시간(있으면 초 단위) ### 4. Be conservative about live data 실시간 데이터는 몇 초 단위로 바뀔 수 있으므로, 답변에는 조회 시점을 같이 적는다. ## Done when - 요청 역의 도착 예정 열차가 정리되어 있다 - live data 기준 시점이 명시되어 있다 - upstream key가 클라이언트에 노출되지 않았다 ## Failure modes - proxy upstream key 미설정 - quota 초과 - 역명 표기 불일치 ## Notes - 서울 열린데이터 광장 가이드는 실시간 지하철 Open API에 일일 호출 제한이 있을 수 있다고 안내한다 - proxy 운영/환경변수 설정은 `docs/features/k-skill-proxy.md` 를 참고한다 - endpoint path는 API 버전 변경 가능성이 있으므로 실패 시 dataset console의 최신 샘플 URL을 다시 확인한다