korea-weather-warninglisted

# korea-weather-warning 気象庁(기상청, KMA)の気象特報照会サービス(WthrWrnInfoService)で、発表中の気象注意報(주의보)・警報(경보)を取得するスキル。2026-09-10 に2オペレーションの**エンドポイント実在**を確��済み(キーなしで叩き、404ではなく認証エラーが返ることを確認。実キーでのデータ応答はまだ未検証)。予報そのものは [korea-weather](../korea-weather/SKILL.md) スキル参照。 ## キーの取得 公共データポータル(data.go.kr)で「기상청 기상특보 조회서비스」(WthrWrnInfoService)に活用申請し、serviceKey を取得する(無料)。ポータル: https://www.data.go.kr/ 、気象庁: https://www.kma.go.kr/ ## 基本の流れ 1. 発表中の特報リストを取る 2. 気になる特報の通報文(상세 내용)を取る ### 1. 特報リスト(getWthrWrnList) ```bash curl -s "http://apis.data.go.kr/1360000/WthrWrnInfoService/getWthrWrnList?serviceKey={KEY}&pageNo=1&numOfRows=20&dataType=JSON" ``` - 気象庁の活用ガイド上の絞り込みパラメータ: `stnId`(発表庁の地点コード), `fromTmFc` / `toTmFc`(発表時刻の範囲・YYYYMMDDHHMM)。 - レス���ンスの `body.items.item[]`: 各要素は `stnId`(発表庁コード), `title`(例: 「호우주의보 : 전라남도 ...」= 豪雨注意報: 全羅南道...), `tmFc`(発表時刻), `tmSeq`(通報番号)。 ### 2. 通報文(getWthrWrnMsg) ```bash curl -s "http://apis.data.go.kr/1360000/WthrWrnInfoService/getWthrWrnMsg?serviceKey={KEY}&dataType=JSON&stnId={STN_ID}&tmSeq={TM_SEQ}" ``` - `stnId` / `tmSeq` はリストの該当行から取る。特報の対象地域・期間・内容の全文が返る(韓国語)。 ## 特報の種類(読み方の基礎) - 注意報(주의보)より警報(경보)のほうが強い。 - 主な種類: 호우(豪雨), 강풍(強風), 대설(大雪), 태풍(台風), 폭염(猛暑), 한파(寒波), 황사(黄砂), 풍랑(風浪)。 ## 注意 - 特報は発表庁(ソウル・釜山などの地方気象庁)ごとに出る。タイトルに対象地域が入るので、そのまま旅行者に伝える。 - 台風・豪雨シーズンの移動前チェックに使う。最終判断は気象庁の公��発表(kma.go.kr)で確認するよう伝える。 - パラメータの詳細は気象庁の活用ガイドが正本。このスキルはエンドポイント実在の確認済みだが、実キーでの応答検証はまだ(2026-09-10時点)。 ## エラー・失敗時の対応 - `curl` には必ず `-m 30` を付ける。 - **HTTP 401 `SERVICE_KEY_IS_NULL` / 認証エラー**: serviceKey