holidayslisted

# data-go-kr — 한국천문연구원 특일 정보 Fetch a solar year's special days -- the clean columns are `date`, `name`, `is_holiday` (`Y`/`N`), `kind_code`, `seq`. Five operations, one shape: | operation | 특일 | |---|---| | `holidays` (default) | 관공서 공휴일 (대체공휴일 포함) | | `national_holidays` | 국경일 | | `anniversaries` | 기념일 | | `solar_terms` | 24절기 | | `sundry_days` | 잡절 | ## 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 B090041) applied for (활용신청) on that account. ## Running ``` data-go-kr holidays [operation] --year YYYY [--month M] [--json] ``` `operation` defaults to `holidays`. `--month` (1-12) narrows to one month; omit it for the whole year. ## Procedure 1. **Identify what the user wants.** "올해 공휴일" -> `holidays --year <this year>`; "24절기" -> `solar_terms`; a specific month -> add `--month`. 2. **Run.** ```bash data-go-kr holidays --year 2026 data-go-kr holidays solar_terms --year 2026 ``` Add `--json` when the user wants machine-readable data. 3. **Relay the result.** Show the CLI's stdout (clean columns). The `is_holiday` column is the one that answers "is this a day off" -- a 기념일/절기 is usually `N`. 4. **Error handling.** A one-line `data-go-kr: <message>` on stderr: - a `[30]`/`[20]` auth error -> the key is wrong, is the *encoding* form by mistake, or service B090041