Weather

# Current weather (KMA 초단기실황)
python3 scripts/weather.py now [--city CITY]

# Daily forecast (KMA 단기예보 + 중기예보, up to 10 days)
python3 scripts/weather.py daily [--city CITY]

# Hourly forecast (KMA 단기예보, up to 3 days)
python3 scripts/weather.py hourly [--city CITY] [--day DAY]

# Past observation (KMA ASOS, any past date)
python3 scripts/weather.py past [--city CITY] [--date YYYYMMDD]

# Air quality (AccuWeather AQI)
python3 scripts/weather.py air [--city CITY]

# Hourly air quality (AccuWeather 24h)
python3 scripts/weather.py air-hourly [--city CITY]

Supported Cities

About 100 locations are registered including sub-districts. Major cities:

seoul, busan, daegu, incheon, gwangju, daejeon, ulsan, sejong, gangneung, chuncheon, jeonju, cheongju, jeju, seogwipo, gumi, suwon, changwon, pohang, gimhae, yeosu, wonju, gyeongju, andong, gimcheon, sangju, yeongju, mungyeong

Sub-districts use {city}-{district} format (e.g., seoul-gangnam, busan-haeundae, suwon-yeongtong). See references/cities.json for the full list.

Examples

# Current weather for Seoul
python3 scripts/weather.py now

# Tomorrow's hourly forecast for Seoul
python3 scripts/weather.py hourly --day 2

# Daily forecast for Busan
python3 scripts/weather.py daily --city busan

# Past observation for Seoul on specific date
python3 scripts/weather.py past --date 20260315

# Air quality for Daegu
python3 scripts/weather.py air --city daegu

Query Strategy

1. First: Try scripts/weather.py (most reliable)
2. Fallback: Use WebFetch with AccuWeather URLs (Section 8)

3. Data Sources by Command

4. KMA Forecast Details

Short-term Forecast (단기예보) - hourly, daily

• Published every 3 hours: 0200, 0500, 0800, 1100, 1400, 1700, 2000, 2300
• Covers up to 3 days with hourly resolution
• Data: temperature (TMP), sky condition (SKY), precipitation probability (POP), precipitation type (PTY), humidity (REH), wind speed (WSD), wind direction (VEC)

Mid-term Forecast (중기예보) - daily

• Published at 0600, 1800
• Covers day 4 ~ day 10
• Temperature: getMidTa (최고/최저기온)
• Weather/precipitation: getMidLandFcst (날씨상태, 강수확률)

Ultra-short-term Observation (초단기실황) - now

• Published every hour
• Data: temperature (T1H), humidity (REH), wind (WSD/VEC), precipitation (PTY/RN1)

ASOS Observation (종관기상관측) - past

• Historical hourly data via kma_sfctm3 API
• Data: temperature, dew point, humidity, wind, pressure, precipitation

5. Sky Condition Codes

6. Precipitation Type Codes

7. Air Quality

AirKorea (미세먼지)

Integrated into hourly output:

• Today: real-time PM2.5/PM10 from AirKorea stations
• Tomorrow/day after: daily forecast grade from AirKorea

AccuWeather AQI (air, air-hourly)

8. AccuWeather Fallback (WebFetch)

If the script fails, use WebFetch with these URL patterns:

# Air quality