Help us improve
Share bugs, ideas, or general feedback.
From k-skill
Queries Korea's household waste disposal guidance API (data.go.kr) to return pickup days, times, and locations by district (시군구). Summarizes results for user.
npx claudepluginhub nomadamas/k-skill --plugin k-skillHow this skill is triggered — by the user, by Claude, or both
Slash command
/k-skill:household-waste-infoThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
행정안전부 생활쓰레기배출정보 Open API를 조회해
Queries Christchurch City Council kerbside collection schedules (rubbish, recycling, organics) by address or RatingUnitID. Returns human-readable or JSON output.
Queries real-time crowd density and estimated population for 121 Seoul hotspots (Gangnam, Hongdae, Myeongdong, etc.) via Seoul Open Data API. Use when asked how crowded a specific area is.
Discovers and ranks local businesses in any neighborhood using Nimble WSAs and web data, returning structured lists with scores, reviews, and an interactive map.
Share bugs, ideas, or general feedback.
행정안전부 생활쓰레기배출정보 Open API를 조회해 지역별 생활쓰레기/음식물쓰레기/재활용품 배출 기준과 요일/시간 정보를 안내한다.
SGG_NM)이다.https://apis.data.go.kr/1741000/household_waste_info)를 기준으로 한다.serviceKey(DATA_GO_KR_API_KEY)만 proxy 서버에서 주입/관리한다.curl, python3 사용 가능 환경기본적으로 사용자 측 필수 인증키는 없다.
선택 환경변수:
KSKILL_PROXY_BASE_URL (self-hosted proxy를 쓸 때)인증키 사용 원칙:
serviceKey 값은 proxy 서버가 관리하고 주입한다.DATA_GO_KR_API_KEY를 둘 필요가 없다.https://apis.data.go.kr/1741000/household_waste_infoGET /infok-skill-proxy가 serviceKey를 서버 측에서 주입추가 client API 레이어는 불필요하다. Base URL은 원본 API를 기준으로 유지한다.
현재 proxy가 지원하는 쿼리 파라미터:
cond[SGG_NM::LIKE]: 시군구명 포함 검색 (필수)pageNo / numOfRows(또는 page_no / num_of_rows): 필수, 값은 반드시 1 / 100 — 그 외 값·비정수(숫자만 아닌) 문자열은 400. upstream에는 항상 1페이지·100건만 전달한다.returnType: proxy가 항상 json으로 강제 — 클라이언트가 값을 보내도 무시된다serviceKey: proxy가 서버 측에서 주입 — 클라이언트에서 전달 금지원본 API의
cond[DAT_CRTR_YMD::*],cond[DAT_UPDT_PNT::*]같은 부가 필터는 현재 proxy 라우트에서 패스스루되지 않는다. 사용자가 보내는 일반적인 질의("강남구 쓰레기 배출 요일")는 시군구 기준 검색만으로 충분하므로, 필요하다면 응답에서DAT_UPDT_PNT기준으로 클라이언트에서 정렬한다.
사용자 지역 정보 없이 바로 조회하지 않는다.
확인할 지역(시/군/구)을 알려주세요. 예: 강남구, 수원시 영통구proxy가 serviceKey를 서버 측에서 주입한 뒤 원본 API로 전달한다.
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/household-waste/info' \
--data-urlencode "cond[SGG_NM::LIKE]=강남구" \
--data-urlencode "pageNo=1" \
--data-urlencode "numOfRows=100"
returnType은 proxy가 항상 json으로 강제하므로 클라이언트에서 별도로 보낼 필요가 없다.
KSKILL_PROXY_BASE_URL이 있으면 그 값을 사용하고, 없으면 기본 hosted proxy(k-skill-proxy.nomadamas.org)를 사용한다.
응답에서 필요한 항목만 간단히 정리한다.
MNG_ZONE_NM, MNG_ZONE_TRGT_RGN_NM)EMSN_PLC, LF_WST_EMSN_MTHD, FOD_WST_EMSN_MTHD, RCYCL_EMSN_MTHD)LF_WST_EMSN_DOW, FOD_WST_EMSN_DOW, RCYCL_EMSN_DOW, 각 시작/종료시간)UNCLLT_DAY)MNG_DEPT_NM, MNG_DEPT_TELNO)/v1/household-waste/info 호출에 성공했다.DATA_GO_KR_API_KEY가 없거나 만료된 경우 (serviceKey 주입 실패)cond[SGG_NM::LIKE], 또는 pageNo / numOfRows 미전달)pageNo / numOfRows 값이 1 / 100이 아니거나, 숫자만으로 표현되지 않은 문자열인 경우(proxy 400, upstream 미호출)DATA_GO_KR_API_KEY를 저장하지 않고 proxy 서버에서만 관리한다.DAT_UPDT_PNT 기준으로 우선 정렬해 보여준다.https://www.data.go.kr)