seoul-subway-arrival
Look up Seoul real-time subway arrival information with the official Seoul Open Data API. Use when the user asks when a train arrives, which trains are approaching a station, or how crowded Seoul subway timing looks right now.
Security Assessment
About seoul-subway-arrival
The seoul-subway-arrival skill provides real-time Seoul subway arrival information by querying the official Seoul Open Data Plaza subway arrival API through a hosted proxy service. It is designed to help users quickly check when trains are arriving at a specific station, which trains are currently approaching, and how soon the next subway is expected to arrive. The skill simplifies access to live transit data by handling API communication through a proxy layer, allowing users to retrieve subway arrival updates without managing personal API credentials or exposing upstream keys on the client side.
The skill supports station-based arrival lookups and can optionally limit the number of returned results. It resolves the proxy endpoint automatically using the optional KSKILL_PROXY_BASE_URL environment variable, defaulting to the hosted proxy service when no custom configuration is provided. The workflow includes querying a read-only arrival endpoint, summarizing important arrival details such as subway line, travel direction, arrival messages, and estimated arrival times when available, and presenting the information with a retrieval timestamp because the underlying data changes frequently in real time. The skill also supports optional response range controls through startIndex and endIndex parameters.
This skill is useful for commuters, travelers, transit assistants, and applications that need quick access to live Seoul subway timing information. It is especially helpful for Korean-language transit queries such as checking arrival times at stations like Gangnam, Seoul Station, or Jamsil. Developers integrating Seoul transit information into AI assistants, chatbots, or transportation dashboards can also use this skill to provide concise, real-time subway updates while keeping upstream API credentials securely managed on the proxy server.
FAQ
Do users need their own Seoul Open Data API key?
No. The skill uses a hosted proxy service that injects and manages the upstream API key on the server side, so users do not need to obtain or manage their own API credentials.
Can I use a custom proxy server instead of the default hosted proxy?
Yes. You can configure a custom proxy by setting the KSKILL_PROXY_BASE_URL environment variable. If the variable is empty or not set, the skill automatically uses the default hosted proxy service.
What information does the skill summarize from the subway arrival API?
The skill summarizes subway line information, travel direction, first and second arrival messages, and estimated arrival times in seconds when available.
Does the skill support real-time subway updates?
Yes. The skill retrieves live subway arrival information from the official Seoul Open Data API, but the data may change every few seconds, so responses should include the retrieval timestamp.
What are some common failure cases when using this skill?
Possible failure cases include missing proxy upstream key configuration, API quota limits being exceeded, or mismatched station name formatting in requests.
Install seoul-subway-arrival
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
nomadamas/k-skill