（14473期）korea-metropolitan-bus-alerts – 韩国首都圈智能公交到站提醒

韩国首都圈智能公交到站提醒 基于韩国国土交通部 TAGO 官方 API 的智能公交提醒服务，支持 Clawdbot 定时推送，精准掌握首都圈公交到站时间。 使用说明 这是一套专为韩国首都圈通勤者设计的智能公交到站提醒解决方案，基于韩国国土交通部 TAGO OpenAPI 官方数据源，通过与 Clawdbot Gateway 及 cron 系统集成，实现精准的定时公交信息推送服务。 核心用法：用户可通过自然语言指令（如"평일 오전 7시, 인천 한빛초등학교, 535"）快速注册工作日或周末的提醒规则。系统支持站点名称模糊搜索与方向歧义消解（当存在对向站点时会主动询问确认），并在设定时间自动查询指定线路的到达信息，通过私信(DM)方式推送至用户。提供规则列表查看、单条测试运行及带二次确认的删除功能，并配备交互式注册向导(rule_wizard)降低配置门槛。 显著优点：首先采用韩国官方 TAGO API，数据权威可靠；其次实现零第三方依赖，仅使用 Python 标准库（urllib、argparse 等），从根本上杜绝供应链攻击风险；安全设计完善，API 密钥严格通过环境变量注入，无硬编码风险，且关键操作（如删除、注册）均配备二次确认机制；隐私保护到位，采用 DM-only 投递策略，避免群组广播泄露通勤隐私；部署体验友好，提供自动化 setup.py 脚本，可一键检测并配置 systemd 用户服务。 潜在局限：目前处于 MVP 阶段，调度表达式仅支持"매일/평일/주말"三种固定模式，暂不支持自定义 cron 语法；站点解析主要依赖关键词搜索，虽有 GPS 附近查询功能但受限于区域和密钥权限可能返回空结果；系统强依赖 Clawdbot Gateway 和 cron 基础设施，部署环境要求具备 systemd 支持的 Linux 系统，对非技术用户存在一定门槛。 适合群体：主要面向已部署 Clawdbot 生态的韩国首都圈（首尔、仁川、京畿道）通勤者，特别是有固定通勤时间、需要提前掌握特定站点公交到站信息的上班族和学生群体。适合熟悉基础 Linux 命令行操作或愿意使用交互式向导完成初始配置的用户。 使用风险：作为 T3 级社区来源项目，建议在生产环境使用前进行代码审计；需严格保护 TAGOSERVICEKEY API 密钥，避免通过 docker compose config 等命令泄露环境变量；依赖外部 clawdbot CLI 二进制文件执行定时任务管理，虽无用户输入拼接风险，但仍需确保该工具来源可信；systemd 服务配置需用户级权限，在受限环境或企业级安全策略下可能需要额外权限申请。 原始说明 Create 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).