household-waste-infolisted

# Household Waste Info ## What this skill does 행정안전부 생활쓰레기배출정보 Open API를 조회해 지역별 생활쓰레기/음식물쓰레기/재활용품 배출 기준과 요일/시간 정보를 안내한다. - 기본 조회 단위는 시군구명(`SGG_NM`)이다. - 응답은 사용자에게 이해하기 쉬운 요약 형태로 정리한다. - Base URL은 원본 API(`https://apis.data.go.kr/1741000/household_waste_info`)를 기준으로 한다. - `serviceKey`(`DATA_GO_KR_API_KEY`)만 proxy 서버에서 주입/관리한다. ## When to use - "강남구 쓰레기 배출 요일 알려줘" - "우리 동네 음식물쓰레기 언제 버려?" - "재활용품 배출 시간 확인해줘" - "생활쓰레기 배출 장소/방법 찾아줘" ## Prerequisites - 인터넷 연결 - `curl`, `python3` 사용 가능 환경 - 원본 API 접근 가능 환경 - API 키 주입용 proxy 접근 가능 환경 ## Credential requirements 기본적으로 사용자 측 필수 인증키는 없다. 선택 환경변수: - `KSKILL_PROXY_BASE_URL` (self-hosted proxy를 쓸 때) 인증키 사용 원칙: 1. endpoint/파라미터 체계는 원본 API를 따른다. 2. `serviceKey` 값은 proxy 서버가 관리하고 주입한다. 3. 사용자 측 로컬 환경에 `DATA_GO_KR_API_KEY`를 둘 필요가 없다. ## Official API surface - Base URL: `https://apis.data.go.kr/1741000/household_waste_info` - Endpoint: `GET /info` - (key injection only) proxy: `k-skill-proxy`가 `serviceKey`를 서버 측에서 주입 ## Default path 추가 client API 레이어는 불필요하다. Base URL은 원본 API를 기준으로 유지한다. 현재 proxy가 지원하는 쿼리 파라미터(이외 값은 무시된다): - `serviceKey`: proxy가 서버 측에서 주입하는 인증키 (`DATA_GO_KR_API_KEY`) — 클라이언트에서 전달 금지 - `pageNo`: 페이지 번호 (기본값 `1`) - `numOfRows`: 페이지 크기 (기본값 `20`, 최대 100) - `returnType`: proxy가 항상 `json`으로 강제 — 클라이언트가 값을 보내도 무시된다 - `cond[SGG_NM::LIKE]`: 시군구명 포함 검색 (필수) > 원본 API의 `cond[DAT_CRTR_YMD::*]`, `cond[DAT_UPDT_PNT::*]` 같은 부가 필터는 현재 proxy 라우트에서 패스스루되지 않는다. 사용자가 보내는 일반적인 질의("강남구 쓰레기 배출 요일")는 시군구 기준 검색만으로 충분하므로, 필요하다면 응답에서 `D