sotaneum/k-weather-alert

韩国气象特报Slack通知机器人

该镜像基于韩国气象厅API开发，用于获取气象特报信息并通过Slack工作流推送至指定频道，帮助用户实时掌握韩国地区的天气预警情况。

核心功能

• 对接韩国气象厅API获取实时气象特报（如强风、暴雨、台风等）
• 支持自定义气象特报过滤（仅显示指定类型预警）
• 可自定义通知标题、图标及描述文本
• 通过Slack工作流将预警信息推送到指定频道

使用场景

• 居住在韩国的个人用户，需及时接收天气预警
• 在韩国有业务的企业团队，用于提醒员工关注天气变化
• 关注韩国地区气象情况的机构或组织

配置说明

API密钥申请

1. 访问韩国气象厅API Hub（[***]）并登录/注册账号
2. 左侧菜单选择「예특보」→「기상특보」
3. 分别为「특.정보 자료 조회」下的「특보구역」和「특보자료」申请API权限
4. 点击页面顶部「URL 발생」按钮获取authKey（即API_KEY）

Slack工作流创建

1. Slack中创建新工作流，选择「Webhook事件」触发
2. 添加数据变量：message（文本）、id（Slack频道ID）
3. 选择「向频道发送消息」动作，频道设为{id}，消息内容为{message}和{工作流开始时间}
4. 发布后复制Web请求URL（即SLACK_HOOK_URL）

环境变量设置

• 必填变量
  API_KEY：韩国气象厅API的authKey
  SLACK_CHANNEL_ID：接收通知的Slack频道ID
  SLACK_HOOK_URL：Slack工作流的Web请求URL
• 可选变量
  PERIOD_DAYS：数据参考周期（默认14天）
  ICONS：特报图标（按预备特报/注意报/警报顺序输入）
  DESCS：特报描述（按预备特报/注意报/警报顺序输入）
  FILTERED_WRN：过滤显示的特报类型（如「强风,暴雨」）
  TITLE：通知标题（默认「📢 气象特报通知」）

Docker部署示例

拉取镜像

bash
docker pull docker.xuanyuan.run/sotaneum/k-weather-alert:latest

运行容器

bash
docker run -d --name k-weather-alert -p 8080:8080 \
-e API_KEY="你的API_KEY" \
-e SLACK_CHANNEL_ID="你的频道ID" \
-e SLACK_HOOK_URL="你的Web请求URL" \
-e PERIOD_DAYS=14 \
-e ICONS="🟡,⚠️,🚨" \
-e DESCS="→ 预备特报,→ 注意报,→ 警报" \
-e FILTERED_WRN="强风,暴雨,台风" \
-e TITLE="📢 韩国气象特报通知" \
docker.xuanyuan.run/sotaneum/k-weather-alert:latest

触发通知

发送POST请求到http://localhost:8080/api/slack/weather即可触发气象特报查询并推送至Slack。