airqualitylisted
Install: claude install-skill seokhoonj/pydatagokr
# data-go-kr — 에어코리아 대기오염정보
Fetch real-time air quality. Clean columns: `station`, `measured_at`, `khai`/`khai_grade`
(통합대기환경지수), and per pollutant a value + `_grade` + `_flag`: `pm10`/`pm25` (미세먼지·
초미세먼지, ㎍/㎥, integers), `so2`/`co`/`o3`/`no2` (ppm, decimals). Grades: 1 좋음 · 2 보통 ·
3 나쁨 · 4 매우나쁨.
| operation | 조회 |
|---|---|
| `by_sido` | 시도별 실시간 (a province's stations, latest) |
| `by_station` | 측정소별 실시간 (one station over a term) |
## 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 B552584)
applied for (활용신청). It is ���동승인 for a development account.
## Running
```
data-go-kr airquality by_sido <시도명> [--json]
data-go-kr airquality by_station <측정소명> [--data-term TERM] [--json]
```
- `<시도명>`: 서울 / 부산 / 인천 / 경기 / ... (a 광역시도).
- `<측정소명>`: a station, e.g. 종로구. `--data-term` is `DAILY` (default) / `MONTH` / `3MONTH`.
## Procedure
1. **Pick the query.** "서울 미세먼지" -> `by_sido 서울`; a named station over time ->
`by_station <name> --data-term MONTH`.
2. **Run.**
```bash
data-go-kr airquality by_sido 서울
```
Add `--json` for machine-readable data.
3. **Relay the result.** Report `pm10`/`pm25` with their grade (좋음/보통/나쁨/매우나쁨). A
`_flag` value means that pollutant's measurement was unavailable.
4. **Error handling.** A one-line `data-go-kr: <message>` on stde