KMA Weather Forecast Skill

Korea Meteorological Administration short-term forecast API + AirKorea air quality integration.

Overview

| Key | Value | |-----|-------| | Provider | KMA (Korea Meteorological Administration) | | Service ID | 15084084 | | Auth | ~/.config/data-go-kr/api_key | | Endpoint | https://apis.data.go.kr/1360000/VilageFcstInfoService_2.0 | | Playbook | playbook.md |

Scripts

scripts/
├── weather.sh             → Weather query (ncst/fcst/short)
├── morning_briefing.sh    → Morning briefing (weather + air quality)
└── grid_convert.py        → Lat/lon → grid coordinate conversion

Workflow

Step 1: Identify location & time

• "서울 날씨" → Seoul Jongno-gu (nx=60, ny=127)
• "내일 날씨" → short-term forecast (short)
• "지금 비 와?" → ultra-short-term observation (ncst)
• Refer to playbook.md for default location

Step 2: Fetch weather data

• Current: weather.sh ncst [nx] [ny]
• 6-hour: weather.sh fcst [nx] [ny]
• 3-day: weather.sh short [nx] [ny]

Step 3: Air quality integration (~~air)

• Fetch PM data via AirKorea skill
• skills/airkorea-air-quality/scripts/air_quality.sh [station]

Step 4: Structured response using output template

Output Template

## 🌤️ [Location] Weather

### Current
🌡️ Temp: X°C (Feels like X°C)
💧 Humidity: X% | 🌬️ Wind: Xm/s
🌧️ Precip: [None/Rain/Snow]

### Today's Forecast
☀️ High X°C / Low X°C
🌧️ Precip probability: X%
🌫️ PM2.5: [Good/Moderate/Bad/Very Bad] (X㎍/㎥)

### 💡 One-liner
[Bring umbrella / Wear mask / Great day to go out]

API Types

| API | Command | Description | Update Cycle | |-----|---------|-------------|-------------| | Ultra-short obs | ncst | Current observation | Hourly | | Ultra-short fcst | fcst | 6hr forecast | Every 30min | | Short-term fcst | short | 3-day hourly | 8x/day |

Key Grid Coordinates

| Location | nx | ny | |----------|----|----| | Seoul Jongno | 60 | 127 | | Seoul Gangnam | 61 | 126 | | Busan | 98 | 76 | | Daegu | 89 | 90 | | Incheon | 55 | 124 | | Daejeon | 67 | 100 | | Jeju | 52 | 38 |

Codes

Sky (SKY)

1: Clear ☀️ | 3: Mostly cloudy ⛅ | 4: Overcast ☁️

Precipitation (PTY)

0: None | 1: Rain 🌧️ | 2: Rain/Snow 🌧️❄️ | 3: Snow ❄️ | 4: Shower 🌦️

base_time Rules

| API | Release time | Queryable | |-----|-------------|-----------| | Ultra-short obs | Every hour | +10min | | Ultra-short fcst | Every 30min | +10min | | Short-term fcst | 02,05,08,11,14,17,20,23h | +10min |

Connectors

| Placeholder | Purpose | Current Tool | |-------------|---------|-------------| | ~~weather | Weather API | KMA Short-term Forecast | | ~~air | Air quality | AirKorea | | ~~notify | Notification | Telegram |

Intent Router

| Intent | Trigger Examples | Strategy | |--------|-----------------|----------| | Quick Check | "오늘 날씨 어때?", "지금 비 와?", "기온 몇 도?" | ncst (현재 관측) + fcst (3시간 예보) → 간단 요약 | | Daily Forecast | "내일 비 와?", "주말 날씨", "모레 눈 올까?" | short (단기예보 3일) → 시간대별 상세 | | Morning Briefing | "아침 날씨 브리핑" | morning_briefing.sh → 날씨+대기질 통합 |

Routing logic: 현재/지금 → Quick Check, 내일/모레/주말 → Daily Forecast, 브리핑 → Morning Briefing

Cross-Skill Integration

| Trigger | Target Skill | Integration | |---------|-------------|-------------| | 날씨 응답 시 항상 | airkorea-air-quality | PM2.5 수치를 날씨 응답에 포함 (Output Template 참조) | | 미세먼지 나쁨 이상 | airkorea-air-quality | "마스크 챙기세요" 팁 추가 | | 비/눈 예보 시 | — | "우산 챙기세요" 자동 팁 |

Notes

1. Uses grid coordinate system (not lat/lon) → use grid_convert.py
2. Query after release time + 10 minutes
3. Short-term forecast returns large data → set sufficient numOfRows

---

Cowork architecture v2.2 — 🦞 chumjibot (2026-02-19)

🔧 Setup (공공데이터 포털 API)

1. data.go.kr 회원가입
2. 로그인 → 마이페이지 → 일반 인증키(Decoding) 복사
3. API 키 저장:

   mkdir -p ~/.config/data-go-kr
   echo "YOUR_API_KEY" > ~/.config/data-go-kr/api_key
   

4. 아래 서비스 활용신청 후 사용 (자동승인)
   • 기상청 단기예보 (15084084)