weatherlisted
Install: claude install-skill seokhoonj/data-go-kr
# data-go-kr — 기상청 동네예보
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 | 강수량 | POP | 강수확률 |
| operation | 예보 |
|---|---|
| `forecast` | 단기예보 (~3일) |
| `ultra_forecast` | 초단기예보 (6시간) |
| `nowcast` | 초단기실황 (현재 관측) |
## Prerequisite
```
pipx install data-go-kr # or: pip install data-go-kr
```
A data.go.kr **decoding** key must be configured (env `DATA_GO_KR_API_KEY` or
`~/.config/data-go-kr/credentials.json`), and the 단기예보 dataset (service 1360000,
VilageFcstInfoService_2.0) applied for (활용신청) on that account.
## Running
```
data-go-kr weather <operation> --base-date YYYYMMDD --base-time HHMM --nx NX --ny NY [--json]
```
- `--base-date`/`--base-time`: the announcement time. 단기예보 is issued at 0200/0500/0800/
1100/1400/1700/2000/2300; 초단기 is issued hourly (available ~40 min after the hour).
- `--nx`/`--ny`: the 기상청 5km grid coordinates (서울 시청 ≈ 60/127).
## Procedure
1. **Map the place to a grid.** Convert the user's location to `nx`/`ny` (ask if unsure;
do not guess). Pick a valid `base_da