korea-metropolitan-bus-alerts

What This Skill Does

The Korea Metropolitan Bus Alerts skill is an automated notification system designed for daily commuters in the Seoul metropolitan area. By integrating with the Korea TAGO (국토교통부) OpenAPI, it allows users to set up recurring arrival alerts for specific bus routes and stops. The system leverages Clawdbot's cron infrastructure to poll real-time bus data and push arrival summaries directly to the user via their configured Gateway messaging platform. It essentially turns your chat interface into a personal transit assistant that proactively notifies you before you head out the door.

Installation

To begin, ensure you have a running Clawdbot Gateway and cron enabled. First, install the skill using the command: clawhub install openclaw/skills/skills/hsooooo/korea-metropolitan-bus-alerts.

Next, perform the one-time authentication setup. The recommended method is running python3 korea-metropolitan-bus-alerts/scripts/setup.py. This script will securely prompt you for your data.go.kr TAGO API key, save it in a protected environment file (~/.clawdbot/secrets/tago.env), configure your systemd service to inherit these credentials, and restart the gateway to finalize the integration.

Use Cases

• Commuting to work or school: Automatically receive the status of your bus at a specific time every weekday morning.
• Off-peak travel management: Track bus arrivals for weekend outings without manually checking transit apps.
• Multi-route monitoring: If you take a combination of routes, the system consolidates arrival data into a single summary message, saving you time and reducing the need for constant app refreshes.

Example Prompts

1. "평일 오전 7시, 인천 한빛초등학교에서 535번 버스 도착 알림 등록해줘."
2. "주말 오후 2시, 고양 향동초등학교 정류소에서 730번, 503번 버스 언제 오는지 알려줘."
3. "현재 등록된 버스 알림 목록 보여주고, 3번 규칙 삭제해줘."

Tips & Limitations

• Stop Identification: The system performs stop resolution via name search. If you receive an error about ambiguous results, ensure you provide the full, correct name of the stop as listed in the TAGO database.
• Security: Never share or hardcode your TAGO_SERVICE_KEY. Always use the provided setup script to ensure your sensitive credentials are kept within a restricted file (chmod 600).
• Cron Reliability: This skill relies on your machine being powered on and the Clawdbot cron service being active. If your system is suspended during a scheduled alert time, the notification may be missed.
• Scope: This is strictly an MVP release focusing on bus arrival times within the Metropolitan region. Currently, it supports only simplified schedule expressions (Daily/Weekday/Weekend).