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

korean-heritage-search

Search official Korean national heritage records, details, and monthly events via the Korea Heritage Service Open API.

7.4k|904|Updated Mar 24, 2026
Search Tags:#Search#lookup#cultural events#open api#XML parsing#korean heritage#korea heritage service
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill korean-heritage-search
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: korean-heritage-search
Source: https://github.com/NomaDamas/k-skill/tree/main/korean-heritage-search
Command: npx skills add https://github.com/NomaDamas/k-skill --skill korean-heritage-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Finding authoritative information about Korean national heritage sites, artifacts, and cultural events requires navigating the Korea Heritage Service's official portals manually. This Skill queries the official Open API directly to return structured heritage records, detailed descriptions, locations, and monthly heritage events without any API key or login.

Core Features & Use Cases

  • Heritage Search: Look up national heritage items by name keyword and region (e.g., Seoul, Jeonbuk, Jeju) with paginated results including type, district, coordinates, and managing authority.
  • Detail Lookup: Retrieve full descriptions, addresses, designation dates, classification, images, and coordinates using the official identifiers (ccbaKdcd, ccbaAsno, ccbaCtcd) returned by search.
  • Monthly Events: Query heritage utilization events by year and month, with optional region filtering, returning dates, venues, fees, contacts, and official links.
  • Use Case: Ask "서울 국보 목록 보여줘" or "이번 달 국가유산 행사 알려줘" and receive structured official data with source URLs and fetch timestamps.

Quick Start

Ask the agent to search for Gyeongbokgung-related heritage records in Seoul using the korean-heritage-search skill.

Frequently Asked Questions about korean-heritage-search

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

FAQPage Schema
How do I search Korean national heritage records by name or region?▼

Use the search command with an optional heritage name keyword and a Korean province name such as Seoul or Jeonbuk. The script calls the official SearchKindOpenapiList.do endpoint and returns paginated JSON results with names, types, districts, coordinates, and heritage codes.

Do I need an API key for the Korea Heritage Service Open API?▼

No API key or login is required. The skill calls the official XML endpoints at khs.go.kr directly over HTTPS, so only an internet connection and Python 3.10 or later are needed.

How do I get detailed information about a specific heritage item?▼

Run the detail command with the three identifiers ccbaKdcd, ccbaAsno, and ccbaCtcd taken from a search result. It returns the description, address, designation date, classification, ownership, image URL, and coordinates from the official detail API.

Can this skill check current opening hours or admission fees?▼

No. The API provides historical descriptions and registered event data, not real-time operating status. The skill explicitly avoids estimating admission fees, hours, or crowd conditions and directs users to official pages for that information.

Why does a heritage search return no results?▼

Empty results usually mean the name spelling or region filter does not match official records. Try alternative name spellings, remove the region filter, or broaden the keyword, since the API matches against official registered names.

Related Skills

Explore More Education & Research Skills→
seolcodingseolcoding

k-parent-festival-finder

Find family-friendly Korean festivals by date and location via TourAPI.

Community
Intermediate
brentcurtis76brentcurtis76

Itinerary Generation Skill

Generate optimized multi-stop travel itineraries with routes and travel times.

Community
Intermediate
seolcodingseolcoding

kakao-bar-nearby

Finds nearby open bars using Kakao Map search and place APIs.

Community
Intermediate
Moshe-shipMoshe-ship
29

saudi-tourism

Identify and summarize official Saudi tourism data from Visit Saudi APIs.

Community
Intermediate