weatherlisted
Install: claude install-skill seokhoonj/pydatagokr
# datagokr — 기상청 동네예보
Fetch a grid cell's forecast or observation. The result is **long** -- one row per weather
item (`category`) per time. Clean columns: `base_date`, `base_time`, `category`,
`forecast_date`/`forecast_time` + `forecast_value` (forecasts) or `observed_value` (nowcast),
`nx`, `ny`. The value's meaning depends on `category`:
| category | 항목 | category | 항목 |
|---|---|---|---|
| TMP / T1H | 기온 (℃) | POP | 강수확률 (%) |
| SKY | 하늘상태 (1 맑음·3 구름많음·4 흐림) | PTY | 강수형태 (0 없음·1 비·2 비/눈·3 눈) |
| REH | 습도 (%) | WSD | 풍속 (m/s) |
| PCP / RN1 | 강수량 (mm) | SNO | 적설 (cm) |
| operation | 예보 |
|---|---|
| `forecast` | 단기예보 (~3일) |
| `ultra_forecast` | 초단기예보 (6시간) |
| `nowcast` | 초단기실황 (현재 관측) |
## Prerequisite
```
pipx install pydatagokr # or: pip install pydatagokr
```
**Never print the key value** (the `DATAGOKR_API_KEY` env var or `credentials.json`) to output, logs, or a summary -- if you need to check which form it is (encoding vs decoding), ask the user.
A data.go.kr **decoding** key must be configured (env `DATAGOKR_API_KEY` or
`~/.config/pydatagokr/credentials.json`), and the 단기예보 dataset (service 1360000,
VilageFcstInfoService_2.0) applied for (활용신청) on that account.
## Running
```
datagokr weather <operation> --nx NX --ny NY [--base-date YYYYMMDD --base-time HHMM] [--json]
```
- `--base-date`/`--base-time`: the announcement time. **Omit both to use the latest published
announcement** for the operation. 단기예보 is issued at 0200/0500/0800/1100/1400/1700/200