korea-metropolitan-bus-alerts

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

🥥9总安装量 2评分人数 1
100% 的用户推荐

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

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 通过所有 C/D 级安全检查,未发现 eval/exec/system 等危险函数执行或 SQL 注入漏洞
  • ✅ API 密钥严格从环境变量读取,代码中无硬编码敏感信息,符合安全最佳实践
  • ✅ 仅依赖 Python 标准库(urllib 等),无第三方包引入,杜绝了供应链攻击风险
  • ⚠️ 使用 subprocess 调用外部 `clawdbot` CLI 工具,虽命令参数硬编码且关键操作有二次确认,但需确保该二进制来源可信
  • ⚠️ 来源为 T3 级社区/个人项目,虽代码结构规范,建议在生产环境部署前进行额外审查

使用说明

这是一套专为韩国首都圈通勤者设计的智能公交到站提醒解决方案,基于韩国国土交通部 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 内容

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