skills.rest
NomaDamas
NomaDamasOFFICIAL
Explore all skills by this author โ†’
WebsiteGitHub

kopis-performance-search

Queries KOPIS Open API for Korean performance lists, details, and venue information.

7.4k|904|Updated Mar 24, 2026
Search Tags:#Proxy#event lookup#open api#korean culture#kopis#venue search#performance search
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill kopis-performance-search
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: kopis-performance-search
Source: https://github.com/NomaDamas/k-skill/tree/main/kopis-performance-search
Command: npx skills add https://github.com/NomaDamas/k-skill --skill kopis-performance-search

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) components.

What problem does it solve?

Finding accurate Korean performing arts information requires manually browsing the KOPIS portal. This Skill lets an AI agent query the KOPIS Open API directly through a proxy to retrieve performance listings, show details, and venue data without leaving the conversation.

Core Features & Use Cases

  • Performance List Search: Filter performances by date range, genre code, region code, and status via the KOPIS pblprfr endpoint.
  • Performance & Facility Details: Fetch full details for a specific performance ID (mt20id) or facility ID (mt10id).
  • Facility Lookup by Name: Search venues like ์„ธ์ข…๋ฌธํ™”ํšŒ๊ด€ by name to obtain their KOPIS facility IDs.
  • Use Case: Ask "์ด๋ฒˆ ๋‹ฌ ์„œ์šธ ๊ณต์—ฐ KOPIS์—์„œ ์ฐพ์•„์ค˜" and get a summarized list of performances with dates, venues, and status, then drill into a specific show by ID.

Quick Start

Ask the agent to search KOPIS for performances in Seoul this month and summarize the results with names, dates, and venues.

Frequently Asked Questions about kopis-performance-search

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

FAQPage Schema
How do I search KOPIS performances by date and region?โ–ผ

Call the proxy endpoint GET /v1/kopis/performances with start and end dates in YYYYMMDD format plus an areaCode such as 11 for Seoul. The response maps to the KOPIS pblprfr list API and supports genre, status, and pagination filters.

How do I get details for a specific KOPIS performance or venue?โ–ผ

Use GET /v1/kopis/performances/{mt20id} for a performance detail or GET /v1/kopis/facilities/{mt10id} for a venue. If you only know a venue name, search /v1/kopis/facilities with the q parameter first to obtain its ID.

Do I need my own KOPIS API key to use this skill?โ–ผ

No user-side secret is required. The KOPIS_API_KEY lives only on the k-skill-proxy server; users just reach the hosted proxy at k-skill-proxy.nomadamas.org or set KSKILL_PROXY_BASE_URL for a self-hosted instance.

Can this skill book tickets or reserve seats on KOPIS?โ–ผ

No. This is a lookup-only skill covering performance lists, details, and facility information. Ticket booking, seat holds, payment, and login automation are explicitly out of scope.

Why does the KOPIS query return a 503 error?โ–ผ

A 503 upstream_not_configured response means the proxy server has no KOPIS_API_KEY or KSKILL_KOPIS_API_KEY configured. The proxy operator must issue a key from the KOPIS Open API portal and set it in the server environment.

Related Skills

Explore More Personal & Entrepreneur Skillsโ†’
NomaDamasNomaDamas
7.1k

real-estate-search

Query Korean apartment and housing transaction prices and rents by region and month.

Official
Intermediate
ali156666ali156666
1

travel-guide

Generate travel itineraries using train schedules, weather forecasts, attractions, and routes.

Community
Intermediate
BermudaLocalsBermudaLocals
1

maps

Geocode places, reverse geocode coordinates, and compute POI-based routing with open data sources.

Community
Advanced
nathanvalenathanvale
2

cinema-booking

Browse movies and book tickets at Classic Cinemas Elsternwick via CLI.

Community
Advanced