realty-supply 사용 가이드

KOSIS(국가통계포털) 주택 공급 지표(미분양·인허가·착공·준공)와 청약홈 청약 통계를 수집합니다. /realty-supply 올해 전국 아파트 미분양 추이 보여줘, /realty-supply 2024년 전국 인허가·착공·준공 통계 가져와줘처럼 말하면 됩니다.

처음 설정하기#

KOSIS 공급 지표 조회#

KOSIS Open API 키가 필요합니다.

1. kosis.kr에 회원가입합니다.
2. Open API 활용신청을 합니다: https://kosis.kr/openapi/index/index.jsp
3. 발급받은 키를 .env 파일에 넣습니다 (권장) — 작업 폴더(Cowork 연결 폴더 / Claude Code 프로젝트 루트)(연결한 폴더가 여러 개면 아무 폴더나) 루트에 .env 파일을 만들고 아래 한 줄을 넣어 두면 스킬이 자동으로 찾아 읽습니다. 점(.)으로 시작하는 파일을 만들기 어렵다면 환경변수.txt 라는 이름으로 만들어도 똑같이 읽힙니다(메모장이 .txt 를 붙여 .env.txt 가 되어도 됩니다).

KOSIS_API_KEY=발급받은_키

KOSIS 가입·키 발급 절차는 KOSIS 발급 가이드를 참고하세요.

Claude Desktop의 “Claude 지침”(설정 → 일반)에 같은 내용을 적는 방식도 동작하지만, 대화 컨텍스트에 값이 노출되므로 .env 파일을 권장합니다.

개발자라면 셸 환경변수로 넣어도 됩니다.

청약홈 청약 통계 추가 조회#

청약 경쟁률·분양 데이터를 함께 보려면 공공데이터포털 키도 필요합니다. realty-deals 스킬을 이미 쓰고 있다면 같은 키를 그대로 씁니다. 이 키도 같은 .env 파일에 한 줄 추가하면 됩니다.

KO_DATA_API_KEY=발급받은_키

자세한 가입·키 발급 절차(Decoding 키 주의사항 포함)는 공공데이터포털 발급 가이드를 참고하세요.

청약 경쟁률 데이터는 2020년 2월부터 제공됩니다. 그 이전 구간은 조회되지 않습니다.

지원하는 지표#

자주 쓰는 요청#

알아두면 좋은 점#

• 청약 데이터 시작 시점: 청약 경쟁률 데이터는 2020년 2월부터 제공됩니다. 그 이전 기간을 요청해도 데이터가 없으며, 없는 구간에 데이터를 만들어 채우지 않습니다.
• 선행지표로 활용: 인허가 → 착공 → 준공 순서로 공급 파이프라인을 파악할 수 있습니다. /realty-supply 인허가부터 준공까지 전 단계 보여줘처럼 한 번에 요청해도 됩니다.

안 될 때#