skills.rest
NomaDamas
NomaDamasOFFICIAL
Explore all skills by this author →
WebsiteGitHub

korean-holiday-calendar

Queries Korean public holidays, national days, anniversaries, and solar terms via the KASI SpcdeInfoService API.

7.4k|904|Updated Mar 24, 2026
Search Tags:#api lookup#korea#public holiday#data.go.kr#Calendar#solar terms#korean holidays
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill korean-holiday-calendar
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: korean-holiday-calendar
Source: https://github.com/NomaDamas/k-skill/tree/main/korean-holiday-calendar
Command: npx skills add https://github.com/NomaDamas/k-skill --skill korean-holiday-calendar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Checking Korean public holidays, substitute holidays, national days, anniversaries, 24 solar terms, and sundry days normally requires manually searching government portals or calendars. This Skill queries the official Korea Astronomy and Space Science Institute special-day API through a hosted proxy and returns structured results.

Core Features & Use Cases

  • Holiday Lookup: Query public holidays (rest), national days (national), anniversaries (anniversary), 24 solar terms (solarTerm), and sundry days (sundry) by year and month.
  • Holiday Status Check: Determine whether a specific date is a holiday using the isHoliday field, based on KST dates.
  • No User Credentials Needed: The API key lives only on the k-skill-proxy server, so end users query without signing up for data.go.kr.
  • Use Case: Ask "Is August 15, 2026 a public holiday in Korea?" and receive the date, name, and holiday flag from the official government data source.

Quick Start

Ask the AI to check whether a specific date is a Korean public holiday or to list all public holidays for a given year and month.

Frequently Asked Questions about korean-holiday-calendar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check Korean public holidays for a specific month?▼

Query the k-skill-proxy calendar route with operation=rest, a 4-digit year, and an optional month. The response returns each holiday's locdate, dateName, and isHoliday flag from the official data.go.kr special-day service.

What API provides Korean holiday and solar term data?▼

The Korea Astronomy and Space Science Institute special-day API (data.go.kr service 15012690) provides public holidays, national days, anniversaries, 24 solar terms, and sundry days through the SpcdeInfoService operations.

Do I need a data.go.kr API key to look up Korean holidays?▼

No user-side key is required. The DATA_GO_KR_API_KEY is held only on the k-skill-proxy server, so you call the proxy endpoint directly without registering on the public data portal.

Can I check if a specific date is a holiday in Korea?▼

Yes. Query the target year and month, then match the date in KST against the locdate field and inspect isHoliday. A value of Y means it is a public holiday; N means it is a special day but not a day off.

Why does the Korean holiday API return a 503 error?▼

A 503 upstream_not_configured error means the proxy server lacks a DATA_GO_KR_API_KEY or the data.go.kr service 15012690 usage application has not been approved. The proxy operator must configure the key.

Related Skills

Explore More Personal & Entrepreneur Skills→
skills-ilskills-il
9

idf-date-converter

Convert dates between Hebrew and Gregorian calendars and identify Israeli holidays.

Official
Intermediate
kangnam7654kangnam7654

travel-planner

Generate day-by-day travel itineraries with cost breakdowns and pre-travel checklists.

Community
Advanced
skills-ilskills-il
21

shabbat-aware-scheduler

Schedule meetings, deployments, and events using HebCal zmanim and Israeli business hours.

Official
Advanced
semicolon-devteamsemicolon-devteam

supabase-fallback

Query Supabase tables via PostgREST when the Spring Boot backend is offline.

Official
Advanced