seoul-metro

What This Skill Does

The seoul-metro skill is a specialized OpenClaw agent designed to provide comprehensive, real-time intelligence on the Seoul Metropolitan Subway system. By integrating official data streams from both the Seoul Open Data Plaza (data.seoul.go.kr) and the national Public Data Portal (data.go.kr), this skill enables users to query live arrival times, look up station details, calculate optimal travel routes, and stay informed about service interruptions. Whether you are a local resident trying to minimize your commute time or a visitor navigating the complex rail network for the first time, this agent acts as a direct interface to the metro infrastructure.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Ensure your OpenClaw environment is configured and run the following command:

clawhub install openclaw/skills/skills/dukbong/seoul-metro

After installation, you must configure your environment variables to enable the data fetchers. Set your SEOUL_OPENAPI_KEY using credentials from the Seoul Open Data Plaza and your DATA_GO_KR_KEY from the Public Data Portal. Without these keys, the agent will be unable to authenticate with the remote API endpoints.

Use Cases

This skill is highly effective for daily commuters who require up-to-the-minute status updates before departing. It excels in scenario planning, such as determining the total fare and transfer complexity between two remote stations during peak hours. Additionally, it serves as an essential tool for troubleshooting during service delays, allowing users to quickly verify if an incident report has been issued for their specific line.

Example Prompts

1. "Check the current arrival times for the next trains at Gangnam station."
2. "What is the fastest way to get from Sindorim to Seoul Station, and how much will the fare cost?"
3. "Are there any current service delays or incident notices for Line 2?"

Tips & Limitations

The Seoul Metro skill relies on third-party APIs which may occasionally experience latency or maintenance outages. Always check the official station boards as a secondary source during critical transit moments. Note that the route search function requires specific timestamp formatting; if you receive an error, ensure your request includes valid date/time context. The skill supports both English and Korean inputs, providing flexibility for diverse users, but always prioritize using exact station names to ensure the highest query accuracy.