kma-weather

kma-weather 是一款专门面向韩国地区的专业气象数据获取工具，通过调用韩国气象厅(KMA)官方API，为用户提供高精度、权威可靠的天气信息服务。该技能支持当前天气实况、超短期(6小时)、短期(3天)及中期(3-10天)预报查询，同时具备官方天气预警监测功能，是韩国地区用户获取气象信息的理想选择。

核心用法方面，用户可通过命令行脚本灵活获取各类气象数据。使用forecast.py脚本可查询当前天气、超短期和短期预报，支持经纬度坐标输入和JSON格式输出；weather_warnings.py提供全国天气预警状态；midterm.py则专注中期预报。所有脚本均内置5km×5km网格坐标自动转换功能，用户直接使用经纬度即可，无需手动处理复杂的兰伯特投影坐标转换。技能同时支持Python代码级集成，方便开发者直接调用函数构建自动化工作流。

显著优点包括：首先，数据来源权威，直接对接韩国气象厅官方API，而非第三方聚合数据，确保信息准确性和时效性；其次，空间分辨率达5km×5km网格，远高于普通城市级天气服务，可提供精准的局地预报；第三，支持官方天气预警查询，包括台风、暴雨、大雪等灾害性天气警报，这在通用天气服务中较为罕见；第四，技术实现纯净，仅依赖Python标准库（urllib、json等），无外部包依赖，部署简单且供应链安全风险极低；最后，提供完整的错误处理机制和详细的故障排除指南，用户体验友好。

潜在缺点主要包括地理限制：服务仅覆盖韩国地区，对全球用户适用性有限；使用门槛方面，需用户自行在공공데이터포털注册并申请API密钥，流程相对繁琐；维护层面，该技能由个人开发者维护（T3来源），长期更新和支持稳定性较官方或组织级项目存在不确定性；此外，API调用受限于공공데이터포털的速率限制，高频调用场景下可能触发429错误，且API数据更新有固定时间表（如短期预报每3小时更新），实时性略低于商业气象服务。

适合的目标群体主要为：居住在韩国或关注韩国天气的用户、需要精确局地预报的农业/户外工作者、对官方灾害预警有刚性需求的应急管理机构、以及希望将权威气象数据集成到自动化工作流的开发者。对于仅需偶尔查询全球天气的 casual 用户，通用weather技能可能更为便捷；但对于需要韩国高精度预报和官方预警的专业场景，kma-weather不可替代。

使用风险方面，性能上依赖KMA API服务器稳定性，偶发超时错误（Error 22）需重试；配置上若未正确设置KMA_SERVICE_KEY环境变量将无法使用，且密钥申请需等待审批；数据范围上，超出韩国境内的坐标请求将返回空数据；此外需注意API调用频率限制，避免短时间内大量请求触发服务限制。建议用户实施适当的错误处理、重试机制和本地缓存策略。