korea-metropolitan-bus-alerts

🚌 韩国首都圈智能公交到站提醒

基于韩国国土交通部 TAGO 官方 API 的智能公交提醒服务,支持 Clawdbot 定时推送,精准掌握首都圈公交到站时间。

收藏
3.3k
安装
714
版本
v1.0.2
CLS 安全性认证2026-05-21
点击查看完整报告 >

使用说明

这是一套专为韩国首都圈通勤者设计的智能公交到站提醒解决方案,基于韩国国土交通部 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 级社区来源项目,建议在生产环境使用前进行代码审计;需严格保护 TAGO_SERVICE_KEY API 密钥,避免通过 docker compose config 等命令泄露环境变量;依赖外部 clawdbot CLI 二进制文件执行定时任务管理,虽无用户输入拼接风险,但仍需确保该工具来源可信;systemd 服务配置需用户级权限,在受限环境或企业级安全策略下可能需要额外权限申请。

安全解读

核心功能

korea-metropolitan-bus-alerts 是专为韩国首都圈通勤族设计的智能公交到站提醒系统。通过与韩国国土交通部 TAGO OpenAPI 深度集成,用户可用自然语言(如"평일 오전 7시, 인천 한빛초등학교, 535")快速注册到站提醒规则,系统将在指定时间自动查询实时公交到站信息,并通过私聊消息推送摘要。

显著优点

1. 官方数据源权威可靠:直接对接韩国政府 apis.data.go.kr 官方 API,数据实时准确,覆盖首都圈全域公交网络
2. 极简交互体验:支持韩语自然语言输入,内置交互式规则向导 (rule_wizard.py) 自动解析站点、路线、时间

3. 安全架构设计:API 密钥通过环境变量管理,setup.py 自动配置 systemd 服务并设置 600 权限保护;全程 HTTPS 加密传输

4. 零第三方依赖:纯 Python 标准库实现,无供应链攻击风险

5. DM 私密推送:默认仅向注册用户发送私聊消息,避免信息泄露

潜在局限

  • 地域限制:当前仅支持韩国首都圈(수도권),其他地区需等待 TAGO API 扩展
  • GPS nearvy 查询不稳定:MVP 版本依赖站点名称搜索,GPS 附近站点查询可能因密钥或区域返回空结果
  • 定时精度:基于 Clawdbot cron,实际触发时间可能存在分钟级偏移
  • 外部工具依赖:需预装 clawdbot CLI 和 systemd 用户服务支持

适合人群

  • 每日固定时间通勤的上班族、学生党
  • 需要精准掌握多班车到站时间的换乘用户
  • 已部署 Clawdbot Gateway + cron 的 self-host 用户

常规风险提示

  • 需妥善保管 TAGO_SERVICE_KEY,虽脚本已做防护,但仍建议定期轮换
  • 删除规则操作需二次确认,避免误删
  • 系统会修改 systemd 用户服务配置,建议在运行 setup.py 前备份现有配置

korea-metropolitan-bus-alerts 内容

references文件夹
scripts文件夹
手动下载zip · 19.8 kB
api_reference.mdtext/markdown
请选择文件