القائمة
KOPIS 공연예술통합전산망 Open API를 k-skill-proxy 경유로 조회해 공연 목록·상세와 공연시설 정보를 찾는다. 조회 전용.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
공공데이터포털 WHOIS 도메인/IP 정보 API를 k-skill-proxy 경유로 호출해 .kr/.한국 도메인, IP 주소, AS 번호의 공개 등록정보를 조회한다. 조회 전용.
열린국회정보 Open API를 k-skill-proxy 경유로 호출해 의안 검색·상세와 국회의원 본회의 표결정보를 조회한다. 조회 전용.
Browse 대법원경매정보(courtauction.go.kr) 부동산 매각공고 by 매각기일·법원·기일/기간 입찰, expand each notice into 사건번호·용도·주소·감정평가액·최저매각가, search property items by free conditions(지역·용도·가격·면적·유찰횟수), and look up a case directly by 법원+사건번호. Read-only, slow-by-design (~2s/call) to avoid IP blocks.
법원 전자소송 지급명령 신청을 위해 채권자·채무자·청구금액·청구원인·증빙 정보를 인터뷰하고, 신청서 초안과 공식 전자소송 브라우저 입력 handoff를 준비한다.
국방전자조달시스템(D2B) 공개 입찰공고 검색 화면에서 공고건명·공고구분·공고/개찰일·G2B공고번호·발주기관 조건으로 공고를 조회한다.
당근부동산(realty.daangn.com) 공개 웹 데이터로 지역 기반 부동산 매물 검색과 상세 확인을 수행한다. 문의/예약/계약 자동화는 제외한다.
| name | kopis-performance-search |
| description | KOPIS 공연예술통합전산망 Open API를 k-skill-proxy 경유로 조회해 공연 목록·상세와 공연시설 정보를 찾는다. 조회 전용. |
| license | MIT |
| metadata | {"category":"culture","locale":"ko-KR","phase":"v1"} |
KOPIS 공연예술통합전산망 Open API https://kopis.or.kr/openApi/restful 을 k-skill-proxy 경유로 호출한다. www.kopis.or.kr redirect는 일부 요청을 차단할 수 있어 canonical host를 직접 사용한다.
지원 endpoint:
GET /v1/kopis/performances → pblprfr 공연 목록GET /v1/kopis/performances/{id} → pblprfr/{mt20id} 공연 상세GET /v1/kopis/facilities → prfplc 공연시설 목록GET /v1/kopis/facilities/{id} → prfplc/{mt10id} 공연시설 상세예매, 좌석 선점, 결제 자동화는 범위 밖이다.
k-skill-proxy의 /v1/kopis/* route 접근 가능KSKILL_PROXY_BASE_URL — self-host·별도 프록시를 쓸 때만 설정. 비우면 기본 hosted https://k-skill-proxy.nomadamas.org 를 사용한다.KOPIS_API_KEY 또는 KSKILL_KOPIS_API_KEY 는 프록시 운영 서버 환경에만 둔다.키 발급: KOPIS Open API 안내 https://www.kopis.or.kr/por/cs/openapi/openApiInfo.do?menuId=MNU_00074 에서 회원가입/로그인 후 OpenAPI 이용신청으로 발급한다.
공연 목록:
start/stdate: 시작일 YYYYMMDDend/eddate: 종료일 YYYYMMDDgenre/shcate: 장르 코드areaCode/signgucode: 지역 코드sigunguCode/signgucodesub: 시군구 코드prfstate, kidstate, openrun, afterdatepage/cpage, limit/rows시설 목록:
q/query/name/shprfnmfct: 시설명areaCode/signgucode, sigunguCode/signgucodesubfcltychartr, afterdatepage/cpage, limit/rowsBASE="${KSKILL_PROXY_BASE_URL:-https://k-skill-proxy.nomadamas.org}"
curl -fsS --get "$BASE/v1/kopis/performances" \
--data-urlencode "start=20260701" \
--data-urlencode "end=20260731" \
--data-urlencode "areaCode=11" \
--data-urlencode "limit=10"
curl -fsS "$BASE/v1/kopis/performances/PF132236"
시설명으로 먼저 찾은 뒤 시설 ID가 필요하면 상세를 조회한다.
curl -fsS --get "$BASE/v1/kopis/facilities" \
--data-urlencode "q=세종문화회관" \
--data-urlencode "limit=5"
400 bad_request: 날짜 형식, 페이지 크기, ID 형식이 잘못됨.503 upstream_not_configured: 프록시 서버에 KOPIS_API_KEY/KSKILL_KOPIS_API_KEY 없음.mt20id 또는 mt10id를 함께 명시했다.키 없이 가능한 검증:
./scripts/validate-skills.shnode --test packages/k-skill-proxy/test/server.test.jscurl -i --get "$KSKILL_PROXY_BASE_URL/v1/kopis/performances" --data-urlencode "start=20260701" --data-urlencode "end=20260731" (키 미설정이면 503 확인)Live smoke는 hosted/self-host proxy에 KOPIS_API_KEY가 설정된 뒤 수행한다.