Korea metropolitan bus alerts
v1.0.2Create 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).
⭐ 3· 1.7k·2 current·2 all-time
by@hsooooo
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
OpenClaw
Benign
high confidencePurpose & Capability
Name/description match what the repository does: it queries Korea TAGO OpenAPI and builds Clawdbot cron jobs. Declared requirements (python3, systemctl) and the single env var (TAGO_SERVICE_KEY) are appropriate for the described setup and runtime. One minor note: the manifest lists no required config paths, but the scripts intentionally write ~/.clawdbot/secrets/tago.env and a systemd user override to make the key available to the Gateway; this is documented in SKILL.md and is consistent with the feature even though 'required config paths' was left empty in registry metadata.
Instruction Scope
SKILL.md and the scripts focus on resolving stops, building cron job JSON, and querying TAGO. The interactive setup writes an env file and patches/restarts the user's systemd user service (Gateway) so cron runs have the TAGO key. The cron payloads contain an agentTurn message instructing the agent to run the local deterministic helper (python3 .../tago_bus_alert.py) to fetch arrivals. These actions are within the stated purpose, but they do grant this skill the ability to modify the user's Gateway service environment and to schedule agent-invoked tasks — the user should be aware of those effects before consenting.
Install Mechanism
No install spec; the skill is distributed as code/scripts and is instruction-driven. There are no downloads from external, untrusted URLs and no archive extraction. This is the lower-risk model for a script-based skill.
Credentials
Only TAGO_SERVICE_KEY (primary credential) is required and is directly needed for TAGO/data.go.kr API calls; tago_api also accepts DATA_GO_KR_SERVICE_KEY as an alternate env var which is documented. No unrelated secrets or multiple credentials are requested.
Persistence & Privilege
The skill does modify user state: it writes ~/.clawdbot/secrets/tago.env and a systemd user override (under ~/.config/systemd/user/...), and then runs systemctl --user restart on the detected Gateway unit. 'always' is false. These actions require the user account's systemd permissions (no elevated root is requested), but they are persistent changes to service configuration and will restart the Gateway — the user should expect that.
Assessment
This package appears to do what it says: it queries the official data.go.kr (TAGO) endpoints and helps you register Clawdbot cron jobs to send DM-only arrival summaries. Before installing or running setup.py: 1) Be prepared that setup.py will write an env file to ~/.clawdbot/secrets/tago.env and will patch and restart your user-level Gateway systemd service (it uses systemctl --user). If you run this on a system without systemd or where you don't want the Gateway restarted, do not run the automatic setup and instead set the TAGO_SERVICE_KEY manually. 2) Only provide a TAGO service key with the minimum necessary scope; the code does not transmit that key to any third-party servers (it only uses data.go.kr endpoints), but the key will be stored on-disk (chmod 600). 3) The cron jobs schedule agentTurn payloads which will cause the agent to run local helper scripts at scheduled times — ensure you trust the Clawdbot agent and its execution policies. 4) If you are cautious, inspect the included scripts locally (they are small and readable), run tools in a test environment, and backup any existing systemd override files before running setup.py. Overall: coherent and proportionate to the stated purpose, but be aware of the described persistent systemd/env changes before proceeding.Like a lobster shell, security has layers — review code before you run it.
latestvk97aczjzx82qqzkb2gq5m2b649813k76
License
MIT-0
Free to use, modify, and redistribute. No attribution required.
Runtime requirements
🚌 Clawdis
Binspython3, systemctl
EnvTAGO_SERVICE_KEY
Primary envTAGO_SERVICE_KEY