韩国气象数据查询

技能简介

kma-weather 连接韩国气象厅（기상청）开放数据，提供实时天气、短期预报（3天）、中期预报（3-10天）及全国天气预警（기상특보）。数据精度达5公里网格，适合需要精确韩国本地气象信息的场景。

业务背景

韩国气象数据查询服务直连韩国气象厅官方数据源，为在韩运营的企业提供精准到5公里网格的气象情报。业务团队可实时掌握目标区域温度、降水、风速等实况，提前获取3-10天预报及灾害预警，辅助物流调度、户外作业安排、门店运营决策及供应链风险管理，降低天气因素导致的运营中断与成本损失。

落地案例：某零售企业在首尔、釜山设有仓储中心，每日需根据天气调整配送路线与人员排班。通过该服务，运营人员输入仓库坐标即可获取实时降水概率与逐小时风力预报；台风季自动拉取全国生效中的气象特报，提前48小时启动应急预案，将天气敏感商品的调拨计划与配送窗口动态匹配，避免暴雨导致的延误罚款。

能做什么

• 查询指定坐标的实时天气（温度、湿度、降水、风速风向）
• 获取超短期（6小时）和短期（3天）逐小时预报
• 查看全国生效中的天气预警与预备预警
• 按地区或站点ID查询中期天气预报
• 坐标与KMA 5公里网格自动转换

使用说明

1. 申请API密钥

1. 访问 공공데이터포털
2. 申请以下三个API权限（共用同一密钥）：
   • 기상청 단기예보 조회서비스 (15084084)
   • 기상청 기상특보 조회서비스 (15000415)
   • 기상청 중기예보 조회서비스 (15059468)
3. 在「我的页面 → API密钥管理」复制 ServiceKey

2. 配置环境变量

Sandbox 模式（~/.openclaw/openclaw.json）：

{"agents":{"defaults":{"sandbox":{"docker":{"env":{"KMA_SERVICE_KEY":"your-key"}}}}}}

Host 模式：

{"env":{"vars":{"KMA_SERVICE_KEY":"your-key"}}}

3. 执行命令

# 当前天气+6小时预报
python3 skills/kma-weather/scripts/forecast.py brief --lat 37.5665 --lon 126.9780

# 完整JSON输出
python3 skills/kma-weather/scripts/forecast.py all --lat 37.5665 --lon 126.9780 --json

# 3天短期预报
python3 skills/kma-weather/scripts/forecast.py shortterm --lat 37.5665 --lon 126.9780 --days all

# 全国天气预警
python3 skills/kma-weather/scripts/weather_warnings.py

# 中期预报（3-10天）
python3 skills/kma-weather/scripts/midterm.py --region 서울

输入与输出

见下方输入与输出表格。

风险提示

• 仅覆盖韩国境内坐标，海外坐标返回空数据
• API密钥需提前申请并等待审批通过
• 数据更新有固定时段，非实时推送
• 服务超时需稍后重试

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/steamb23/kma-weather/SKILL.md
来源类型：GitHub仓库