korea-metropolitan-bus-alertsCreate and manage scheduled bus arrival alerts using Korea TAGO (국토교통부) OpenAPI and Clawdbot cron. Use when a user wants to register weekday/weekend schedules like "평일 오전 7시, <정류소명>, <노선들>" and receive automatic arrival summaries via their configured Gateway messaging (DM only).
Install via ClawdBot CLI:
clawdbot install Hsooooo/korea-metropolitan-bus-alertsScheduled bus arrival alerts powered by 국토교통부 TAGO OpenAPI.
This skill is designed for users running Clawdbot Gateway + Clawdbot cron. Users register rules like:
Then the system sends arrival summaries to the registering user (DM) on schedule.
Note (MVP): stop resolution is done via stop name search (cityCode + keyword). GPS-based nearby lookup exists but may return 0 results depending on key/region.
systemctl --user 가 동작하는 환경 (systemd user service)clawdbot CLIYou must set a TAGO service key in your environment (never commit or paste it into markdown).
Recommended env var:
TAGO_SERVICE_KEYGood for quick manual tests; cron jobs will NOT inherit this unless the Gateway service has it.
export TAGO_SERVICE_KEY='...'This is the most “set it once and forget it” flow.
Run:
python3 korea-metropolitan-bus-alerts/scripts/setup.pyIf your network blocks the endpoint or TAGO returns 403 during the smoke test, you can still complete setup:
python3 korea-metropolitan-bus-alerts/scripts/setup.py --skip-smokeIt will:
TAGO_SERVICE_KEY (hidden input)~/.clawdbot/secrets/tago.env (chmod 600)(Advanced/manual) If you prefer shell scripts, korea-metropolitan-bus-alerts/scripts/set_tago_key.sh is still available, but setup.py is the recommended UX.
.env / tago.env.docker compose config or similar commands that may print env values.export TAGO_SERVICE_KEY='...'
python3 korea-metropolitan-bus-alerts/scripts/tago_bus_alert.py nearby-stops --lat 37.5665 --long 126.9780Tell the agent something like:
If the stop name is ambiguous (e.g., opposite side of road), the agent MUST ask a follow-up question to pick the correct direction/stop candidate before creating the rule.
(Phase 2: arbitrary cron expressions)
sessionTarget: isolated) + deliver: true.references/cron_recipe.md and scripts/cron_builder.py.For integration testing (and for power users), use:
scripts/rule_wizard.py registerIt will:
1) Ask for schedule/time/routes
2) Resolve stop candidates via GPS nearby lookup (direction disambiguation)
3) Generate the job JSON
4) Optionally call clawdbot cron add to register it
Single provider only (MVP):
scripts/ for deterministic behavior.references/api_reference.md.Use scripts/tago_bus_alert.py for deterministic TAGO lookups:
nearby-stops (GPS → stop candidates)arrivals (cityCode+nodeId → arrivals; optional route filtering)Generated Mar 1, 2026
Users can register weekday alerts for specific bus stops and routes to receive arrival summaries before their morning or evening commute, ensuring timely departure planning. This reduces wait times and helps avoid missing buses in metropolitan areas like Seoul or Incheon.
Organizers or attendees of events in Korean cities can set weekend alerts for bus arrivals near venues, facilitating group travel and reducing congestion. This is useful for concerts, festivals, or sports events where public transport is preferred.
Tourists visiting Korea can schedule bus alerts for key attractions or hotels, receiving real-time updates on bus arrivals to optimize sightseeing schedules. It enhances travel convenience without requiring deep local knowledge.
Caregivers or individuals with limited mobility can set alerts for specific bus stops and routes, receiving notifications to prepare for boarding without prolonged outdoor waiting. This improves safety and comfort in daily transit.
Companies with shuttle services in metropolitan areas can use this skill to alert employees about bus arrivals at designated stops, streamlining commute logistics and reducing tardiness. It integrates with existing messaging platforms for easy adoption.
Offer basic alert features for free with limited schedules or stops, and charge a monthly fee for advanced options like unlimited rules, priority API access, or custom cron expressions. Revenue comes from individual users or small businesses seeking enhanced reliability.
License the skill to transportation companies, event organizers, or tourism agencies for integration into their apps or services, providing tailored bus alert solutions. Revenue is generated through one-time setup fees or annual licensing contracts based on usage scale.
Partner with urban planners or advertisers to aggregate anonymized alert data, offering insights into bus usage patterns and peak times for targeted services or ads. Revenue is derived from data sharing agreements or analytics reports sold to third parties.
💬 Integration Tip
Ensure the TAGO_SERVICE_KEY is securely stored in environment variables and use the provided setup.py script for automated configuration to avoid manual errors in cron job setup.
iMessage/SMS CLI for listing chats, history, watch, and sending.
Use when you need to control Discord from Clawdbot via the discord tool: send messages, react, post or upload stickers, upload emojis, run polls, manage threads/pins/search, fetch permissions or member/role/channel info, or handle moderation actions in Discord DMs or channels.
Use when you need to control Slack from Clawdbot via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
Build or update the BlueBubbles external channel plugin for Clawdbot (extension package, REST send/probe, webhook inbound).
OpenClaw skill for designing Telegram Bot API workflows and command-driven conversations using direct HTTPS requests (no SDKs).