What it does

Fetches Korean festival and performance data from the KOPIS (Korean Performing Arts Integrated Computing Network) API and exposes search functionality through pluggable server adapters. The architecture cleanly separates platform-agnostic core logic from connectors for KakaoTalk, REST web APIs, and other platforms, making it reusable across different interfaces.

Who it's for

Developers building Korean chatbots, web applications, or agent systems that need real-time access to festival and performance schedules. Particularly suited for those integrating with KakaoTalk or building custom web APIs for cultural event discovery.

Common use cases

• Add festival search capabilities to KakaoTalk bots using the PlayMCP adapter
• Query Korean performances and festivals by location, date, and genre via REST API
• Surface upcoming cultural events in multi-channel chatbot applications
• Build a festival discovery interface for event aggregation platforms

Setup pitfalls

• KOPIS_API_KEY must be manually obtained from KOPIS and configured directly in core_logic.py
• Two separate server processes serve different use cases—kakao_server.py for KakaoTalk (port 5000), web_server.py for web API (port 5001)
• KakaoTalk integration requires ngrok tunneling—set up ngrok on localhost:5000 and register the public URL in PlayMCP
• Last updated 229 days ago—KOPIS API may have changed; verify endpoint compatibility before production deployment