- name
- kma-weather
- description
- KMA short-term forecast API - ultra-short-term observation/forecast, short-term forecast
- version
- 2.2.0
- author
- chumjibot
- created
- 2026-02-10
- updated
- 2026-02-19
- tags
- [weather, korea, openapi, data.go.kr]
- connectors
- [~~weather, ~~air, ~~notify]
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
- Uses grid coordinate system (not lat/lon) → use
grid_convert.py - Query after release time + 10 minutes
- Short-term forecast returns large data → set sufficient
numOfRows
*Cowork architecture v2.2 — 🦞 chumjibot (2026-02-19)*
🔧 Setup (공공데이터 포털 API)
- data.go.kr 회원가입
- 로그인 → 마이페이지 → 일반 인증키(Decoding) 복사
- API 키 저장:
mkdir -p ~/.config/data-go-kr
echo "YOUR_API_KEY" > ~/.config/data-go-kr/api_key
- 아래 서비스 활용신청 후 사용 (자동승인)
- 기상청 단기예보 (15084084)
