kaic-kinder-info

교육부 유치원알리미(e-childschoolinfo.moe.go.kr) Open API로 전국 유치원을 검색·비교·심층조회하는 명령줄 도구입니다.

유치원을 고를 때 알리미 사이트를 한 곳씩 눌러 가며 비교하는 게 번거로워서 만들었습니다. 공시 항목 14종을 한 번에 끌어와 표로 정리하고, 충원율·교사 근속·학급당 원아 수 같은 직접 계산해야 알 수 있는 지표를 자동으로 뽑아 줍니다.

설치할 패키지가 없습니다 — 파이썬 표준 라이브러리만 씁니다
Claude Code와 Codex에서 스킬·MCP로 바로 쓸 수 있습니다
AI 에이전트가 초보자의 설치를 처음부터 끝까지 안내하도록 AGENTS.md를 넣어 두었습니다

교육부·유치원알리미와 무관한 비공식 개인 프로젝트입니다. 데이터는 유치원알리미 공시 자료를 그대로 보여줄 뿐이며, 정확성은 원 공시를 따릅니다.

필요한 키와 설정 — 한눈에

필수는 인증키 하나뿐입니다. 나머지는 원하는 기능이 생겼을 때 추가하면 됩니다. 모든 값은 .env에 들어가며 저장소에 올라가지 않습니다.

설정	필수	어디서 얻나	무엇이 되나
`KINDER_API_KEY`	필수	유치원알리미 → 자료실 → OPEN API (자동승인)	검색·비교·종합 리포트 (공시 14개 항목)
`NEIS_API_KEY`	선택	NEIS 교육정보 개방 포털 (무료)	병설유치원 방학·급식 (`schedule`)
`SCHOOLINFO_API_KEY`	선택	학교알리미 Open API	병설유치원 모초등학교 급식·보건·시설안전 (`mother-school`)
`HOME_LATLNG`	선택	네이버지도 [공유] 링크를 `kinderinfo.py home "링크"` 에 넘기면 자동 저장	거리 필터(`--near`), 자차 경로(`--road`)
`CHILD_BIRTH_YM`	선택	직접 입력 (YYYY-MM)	입학 연령반 자동 계산 (`--target`)

키가 아예 필요 없는 기능: 혼합반 세부 연령 구성, 원비·시정명령·운영시간· 보건환경·재정 조회, 도로교통공단 사고다발지와 자차 경로 분석, 통학버스 공개 등록현황 (profile --web, health, finance, traffic, bus), 로드뷰·지도 링크. 유치원알리미 웹 공시 화면을 직접 읽기 때문입니다.

빠른 시작

git clone https://github.com/kaicot/kaic-kinder-info.git
cd kaic-kinder-info

cp .env.example .env     # Windows: copy .env.example .env
# .env 를 열어 KINDER_API_KEY 에 발급받은 인증키를 붙여 넣으세요

python kinderinfo.py search 11680 --limit 3 --fresh   # 서울 강남구로 동작 확인

인증키 발급: 유치원알리미 → 자료실 → OPEN API 에서 신청합니다. 서비스 목록에서 "유치원 기본현황 정보 조회" 를 선택하세요. 심의가 자동승인이면 바로 발급됩니다.

AI 에이전트에게 맡겨도 됩니다. Claude Code나 Codex에 이 저장소 주소를 주고 "이거 설치해줘"라고 하면 AGENTS.md를 읽고 단계별로 안내해 줍니다.

사용법

# 지역별 검색 — 시도 전체, 시군구, 또는 5자리 코드
python kinderinfo.py search "서울 강남구"
python kinderinfo.py search 11680

# 연령반으로 좁히기 (전용반 + 해당 연령이 포함된 혼합반, 만 3~5세)
python kinderinfo.py search "서울 강남구" --age 3

# 아이 생년월(.env의 CHILD_BIRTH_YM)로 입학 연령반 자동 계산
python kinderinfo.py search "서울 강남구" --target

# 공립만, 정원 많은 순
python kinderinfo.py search "대구 수성구" --age 3 --estab 공립 --sort size

# 한 곳의 공시 항목 14종 종합 리포트
python kinderinfo.py profile "서울 강남구" 강남유정

# 전용·혼합 학급 구성, 원비·시정명령 이력까지 (웹 공시, 키 불필요)
python kinderinfo.py profile "서울 강남구" 강남유정 --web

# 보건·재정·자차 경로 안전·통학버스까지 확장
python kinderinfo.py profile "서울 강남구" 강남유정 --extended
python kinderinfo.py health "서울 강남구" 강남유정
python kinderinfo.py finance "서울 강남구" 강남유정
python kinderinfo.py traffic "서울 강남구" 강남유정
python kinderinfo.py bus "서울 강남구" 강남유정

# 여러 곳 비교표
python kinderinfo.py compare "서울 강남구" "강남유정,개현초등학교병설"

# 후보들의 실제 운영시간 — 정규·방과후·조기·저녁·방학을 구분
python kinderinfo.py hours "서울 강남구" "강남유정,개현초등학교병설" --year 2027

# 최종 후보 브리핑 — 비교표 + 상세를 한 문서로 (파일 저장 가능)
python kinderinfo.py report "서울 강남구" "강남유정,개현초등학교병설" --target --out 브리핑.md

# 방문·전화 질문 목록이 필요한 경우에만 명시적으로 추가
python kinderinfo.py report "서울 강남구" "강남유정,개현초등학교병설" --target --questions

# 후보 저장 → 이후 report/trend/diff 는 인자 없이
python kinderinfo.py pick "서울 강남구" "강남유정,개현초등학교병설"
python kinderinfo.py trend      # 충원율·원아·근속의 3년 추이
python kinderinfo.py diff       # 최신 두 공시 차수 사이 변화

# 캐시 비우기 (새 공시가 게시됐을 때)
python kinderinfo.py refresh

# 병설유치원의 방학이 언제 며칠인지 (NEIS 키 필요)
python kinderinfo.py schedule "서울 강남구" ○○초등학교병설
python kinderinfo.py schedule "서울 강남구" ○○초등학교병설 --meals

# 병설유치원의 모초등학교 학교알리미 보조정보
python kinderinfo.py mother-school "서울 강남구" ○○초등학교병설 --year 2026

# 출처 상태와 선택적 갱신
python kinderinfo.py sources
python kinderinfo.py refresh --source traffic
python kinderinfo.py refresh --source bus
python kinderinfo.py refresh --all

# 통학버스 사이트 자동 조회 장애 때만: 내려받은 엑셀을 비상 자료로 가져오기
python kinderinfo.py bus-import "통학버스_운행정보.xlsx"
python kinderinfo.py bus-status

# 원본 JSON / 저장된 지역 / 새 지역 코드 탐색
python kinderinfo.py raw basicInfo2 11680
python kinderinfo.py regions
python kinderinfo.py discover 경남        # 경기도는: discover 경기 --full

공통 옵션: --fresh(7일 캐시 무시), --json(기계용 원자료), --limit N

혼합연령 학급을 빠뜨리지 않는 연령 검색

Open API는 만3세 전용반 0학급과 혼합반 3학급까지만 주며, 혼합반이 3~~4세인지 4~~5세인지 구분하지 않습니다. 예전 필터는 이 한계 때문에 혼합반으로 만3세를 받는 유치원을 검색 결과에서 누락했습니다.

이제 search --age 3은 전용반이 없는 혼합반 유치원만 웹 공시 학급표에서 확인해 만3~4세·만3~5세가 있으면 후보에 포함합니다. 웹 확인이 실패해도 후보를 버리지 않고 혼합반 구성 미확인 ⚠으로 남깁니다. 빠른 임시 검색이 필요하면 --no-web으로 확인을 생략할 수 있지만, 이때 혼합반 후보는 모두 미확인 상태입니다.

| 유치원명 | 만3세 학급/원아/정원 |
| A유치원 | 혼합 3학급/66명/68명* |

*가 붙은 혼합반 정원·현원은 만3세 몫이 아니라 포함 연령 전체의 합계입니다. 실제 만3세 모집 인원은 유치원에 확인해야 합니다. profile --web과 report에는 전용반·3~~4세·4~~5세·3~5세를 나눈 현재 학급표가 들어갑니다.

지역 지정 방법

이 API는 시군구 코드가 필수인데 코드표를 공개하지 않습니다. 그래서 discover가 코드 범위를 훑어 유효한 코드를 찾아 sgg_codes.json에 저장합니다. 시도 이름만 입력해도 자동으로 탐색이 돌기 때문에 보통은 신경 쓰지 않아도 됩니다.

입력	의미
`11680`	시군구 코드 직접 지정 (탐색 불필요, 가장 빠름)
`"서울 강남구"`	시도 + 시군구
`강남구`	시군구만 (저장된 지역에서 유일할 때)
`서울`	시도 전체

최종 후보 브리핑 (`report`)

후보를 2~3곳으로 좁힌 뒤 쓰는 명령입니다. 비교표 + 유치원별 상세를 한 문서로 만들어 배우자와 상의하거나 저장할 수 있습니다. 방문·전화 질문 목록은 기본 출력하지 않으며, 사용자가 원할 때만 --questions를 붙여 추가합니다.

원비·시정명령·유치원 평가(웹 공시)와 병설 방학 실측(NEIS 키 있을 때)이 기본 포함되며, --no-web으로 웹 조회를 끄면 빨라집니다. --out 파일.md로 저장할 수 있습니다. --extended를 붙이면 보건·환경, 예산·결산, 실제 자차 경로 사고다발지, 통학버스 교차확인과 병설 모초등학교 보조정보까지 포함합니다. 질문 목록은 여전히 --questions를 명시한 경우에만 생성합니다.

확장 출처 — 무엇을 어디서 가져오나

출처	키	갱신	역할과 한계
유치원알리미 Open API	필수	공시 캐시 7일	기본현황·학급·시설·수업일수·통학차량 등 핵심 14종
유치원알리미 웹 공시	없음	7일	혼합반·원비·시정명령·운영시간·보건환경·재정. 화면 개편 시 파서가 명시적으로 중단
NEIS	선택	호출 시	병설 모초등학교 학사일정·급식. 유치원 확정 일정은 아님
학교알리미	선택	30일	병설 모초등학교 급식·보건·시설안전. 유치원 자체 정보가 아님
도로교통공단 공식 CSV	없음	30일 자동	어린이 보행·스쿨존 사고다발지 공식 폴리곤
OSRM/OpenStreetMap	없음	경로 영구 캐시	실제 자차 도로 경로·시간. 실시간 교통 미반영
학교안전지원시스템	없음	7일	통학버스 차량 수·규모·직영/계약·교육 이수. 노선은 제공하지 않음

학교알리미는 2026년 이후 신규 발급 키에서 sidoCode·sggCode가 필수이고, 공시항목은 pbanYr도 필요합니다. 도구가 유치원의 지역·공시연도를 자동으로 전달합니다.

자차 경로의 어린이 교통사고 다발지 (`traffic`)

접근성과 교통안전 판단에는 직선 반경을 사용하지 않습니다. 집에서 유치원까지 OSRM이 반환한 전체 자차 경로 GeoJSON과 도로교통공단 공식 CSV의 사고다발지 폴리곤을 교차시켜 다음을 확인합니다.

유치원 출입구 좌표가 공식 사고다발지 폴리곤 안에 있는가
실제 자차 경로가 공식 사고다발지 폴리곤을 통과하는가
도로거리·예상시간·해당 자료연도·경로상 다발지 수

직선 좌표는 경로 요청 대상을 줄이는 내부 최적화에만 쓰며 결과 정렬·안전 판단에는 사용하지 않습니다. 0곳은 안전하다는 뜻이 아니라, 도로교통공단이 정한 사고다발지 선정 기준에 해당하는 구간이 확인되지 않았다는 뜻입니다. 실시간 교통은 반영하지 않습니다.

통학버스 자동 확인과 엑셀 비상 자료 (`bus`)

bus는 학교안전지원시스템 공개 화면에서 유치원명과 주소를 대조한 뒤 등록차량 수, 차량 규모, 직영·계약 여부, 운전자·동승자 교육과 고용형태를 읽고 유치원알리미와 교차확인합니다. 차량번호와 운영자 이름은 기본 출력에서 제거합니다.

자동 조회가 막힌 경우에만 학교안전지원시스템에서 내려받은 엑셀을 업로드해 bus-import로 가져옵니다. 가져온 시각·파일 해시·행 수를 기록하고, 파일 내부 수정일을 자료 기준일로 오인하지 않습니다. 초보자는 파일을 대화에 첨부하고 “통학버스 자료를 업데이트해줘”라고 하면 에이전트가 가져오기와 검증을 대신 수행하도록 AGENTS.md에 절차를 적었습니다. 한쪽 출처에 없다는 사실만으로 “통학버스 없음”이라고 단정하지 않습니다.

실제 운영시간 비교 (`hours`)

유치원알리미의 07:00~18:00 같은 시간은 정규수업 시간이 아니라 조기돌봄부터 저녁돌봄까지 합친 전체 운영 외곽 범위일 수 있습니다. hours는 이를 다음처럼 나눕니다.

정규 교육과정
일반 방과후
조기돌봄·저녁돌봄
방학 중 운영시간과 미운영 기간
이용 조건·정원 제한

python kinderinfo.py hours "서울 강남구" "A유치원,B유치원" --year 2027
# CHILD_BIRTH_YM의 첫 입학 학년도로 자동 계산하려면
python kinderinfo.py hours --target       # pick으로 저장한 후보 사용

웹 공시 운영시간은 키 없이 읽습니다. 더 세분된 시간은 공식 교육과정 운영계획서를 사람이 확인한 로컬 verified_hours.json이 있을 때 함께 표시합니다. 이 파일은 후보·지역이 드러날 수 있어 .gitignore 대상이며 공개 저장소에는 포함되지 않습니다. 요청한 학년도의 계획서가 아직 없으면 이전 학년도를 참고용으로 명시하고, 현재 학년도 사실처럼 섞지 않습니다. -는 운영하지 않는다는 뜻이 아니라 세부 분리 자료를 확보하지 못했다는 뜻입니다.

추이와 변화 — 스냅샷의 함정을 벗어나기 (`pick`·`trend`·`diff`)

같은 "충원율 98%"라도 3년째 오르는 중인지 떨어지는 중인지에 따라 의미가 정반대입니다. 유치원알리미 사이트의 시계열 화면은 서비스 중단 상태지만, 공시자료 일괄 다운로드에는 2013년부터의 과거 차수가 남아 있습니다. 이 도구는 그걸 읽어 추이를 복원합니다.

## ○○유치원
| 차수 | 충원율 | 만3세 전용반 원아 | 혼합반 원아 | 전체 원아/정원 | 근속 1년 미만 |
| 2024-1차 | 88% | 0명 | 48명 | 140/160 | 75% |
| ...
| 2026-1차 | 98% | 52명 | 156/160 | 38% |
추세: 충원율 ↗ (88→98, +10%p) · 근속 1년 미만 ↘ (75→38, -37%p)

pick — 후보를 저장하면 report/trend/diff를 인자 없이 쓸 수 있습니다 (후보 목록은 shortlist.json에 저장되며 git에 올라가지 않습니다).
trend — 최근 5개 차수(≈3년)의 충원율·전용반 원아·혼합반 원아·근속 추이. 과거 차수 자료는 다시 바뀌지 않으므로 최초 1회만 내려받아 영구 보관합니다.
diff — 최신 두 차수 사이의 변화만 추립니다. 새 공시가 게시된 직후 "우리 후보 뭐 바뀌었어?"에 답하는 용도로, 새 공시 감지 알림과 이어집니다.
report에도 충원율 추이 행과 유치원별 추이 표가 기본 포함됩니다(--no-trend로 생략).
화살표는 첫 차수↔끝 차수 단순 비교이고 ±2 이상일 때만 방향을 표시합니다. 해석은 붙이지 않습니다 — 판단은 사람 몫입니다.

새 공시 감지와 `refresh`

공시는 연 2회(4월 말·10월 말경) 갱신됩니다. 이 도구는 하루 한 번, 가장 작은 지역 하나만 가볍게 확인해서 새 공시 차수가 게시되면 조회 결과 끝에 알려줍니다. 알림이 뜨면 python kinderinfo.py refresh로 캐시를 비우고 다시 조회하면 됩니다.

연령별 학급 구성·원비·시정명령 (`profile --web`)

혼합반 세부 연령, 원비와 행정처분 이력은 Open API에 없습니다. 하지만 같은 내용이 유치원알리미 웹 상세 페이지에는 공시되므로(공공누리 제1유형), --web을 붙이면 그 화면을 읽어 함께 보여줍니다.

시정명령·행정처분 이력 — 대부분 "이력 없음"이지만, 있다면 후보에서 빼야 할 결정적 정보
연령별 학급 구성 — 만3·4·5세 전용반과 3~~4·4~~5·3~5세 혼합반의 학급·현원·정원
원비 — 교육과정비·방과후비 합계(월, 연령별), 부담금이 있는 항목만 추려서, 특성화 활동 개수와 부담금
0원은 "과정은 운영하되 학부모 부담 없음", -는 "해당 연령 과정 없음"을 뜻합니다

공식 API가 아니라 화면이 개편되면 깨질 수 있습니다. 그래서 이 도구는: 표를 위치가 아니라 이름(법정 공시 항목명)으로 찾고, 읽은 값을 검산해서 어긋나면 틀린 값을 보여주는 대신 명시적으로 실패하며, 항상 원본 페이지 링크를 함께 남깁니다. python kinderweb.py selftest로 화면 구조가 그대로인지 언제든 확인할 수 있습니다.

집에서 가까운 곳 추리기 (`home`·`--near`·`--road`)

먼저 집 위치를 알려줍니다. 네이버지도에서 집을 찾아 [공유] 링크를 복사해 넘기면 끝입니다.

python kinderinfo.py home "https://naver.me/XXXXXX"
python kinderinfo.py search "서울 강남구" --target --near 1.5 --road --sort dist

카카오맵 링크는 위경도가 아니라 자체 좌표계를 담고 있어 쓸 수 없습니다. 도로명주소 자동 변환도 한국에서는 건물번호를 무시하고 도로만 잡아 신뢰할 수 없습니다.

--road를 붙이면 직선거리 대신 실제 자차 도로 거리·시간을 봅니다(키 불필요). 직선거리는 지형이 험한 곳에서 크게 어긋납니다 — 실측하면 우회율이 이렇게 벌어집니다.

유치원	직선	자차(도로)	우회율
A	0.54km	0.72km / 2분	1.3배
B	0.54km	1.20km / 3분	2.2배 ⚠
C	1.20km	3.66km / 5분	3.0배 ⚠

직선거리가 똑같아 보이던 A와 B가 실제로는 두 배 가까이 차이납니다. 우회율이 2배를 넘으면 ⚠가 붙습니다. 사용자가 확인 질문을 원해 report --questions를 쓴 경우에만 동선 질문이 추가됩니다.

도로거리 필터·정렬·교통안전 결과는 모두 OSRM의 실제 자차 경로를 기준으로 합니다. 좌표 간 하한값은 서버 호출량을 줄이는 내부 최적화에만 쓰고 사용자 판단값으로 쓰지 않습니다. 한 번 조회한 경로는 영구 캐시합니다(집·유치원 위치는 바뀌지 않으므로). 실시간 교통은 반영되지 않습니다 — 아침 등원 시간대에는 더 걸리고, 한국 도로망은 OpenStreetMap 기반이라 일방통행·골목의 최신성이 상용 지도보다 떨어질 수 있습니다.

정차 여건은 로드뷰로 (자차 등하원)

자차로 등하원한다면 실제 병목은 운전 시간이 아니라 유치원 앞에 잠시 세울 수 있는가입니다. 그런데 이 정보는 어떤 공시에도, 어떤 지도 API에도 없습니다. 주소로 추정하는 것도 믿을 수 없습니다 — 대로변 주소여도 아파트 단지 안이면 정차가 쉽고, 좁은 번길이어도 골목이 막히면 오히려 어렵습니다.

그래서 이 도구는 판단을 대신하지 않고 로드뷰 링크를 만들어 줍니다. profile과 compare 출력에 들어 있어, 클릭 한 번으로 유치원 앞 도로 폭과 갓길을 직접 볼 수 있습니다.

통학차량을 운행하는 유치원이면 거리보다 노선이 우리 동네를 지나는지가 중요한데, 노선은 공개 데이터에 없어 노선 정보 미공시로만 표시합니다.

병설유치원의 방학 찾기 (`schedule`)

초등학교 병설유치원은 초등학교 학사일정을 따라 방학이 깁니다. 실제로 공시 데이터를 보면 정규 수업일수가 병설은 180일 안팎(법정 최소), 사립은 220~240일로 50일가량 차이가 납니다. 다만 방학 중에도 방과후과정이 운영되어 총 등원 가능일수는 비슷합니다. 즉 병설은 "다닐 날이 적다"기보다 **"방학 기간을 방과후과정에 의존한다"**가 정확합니다.

그런데 방학이 정확히 언제 며칠인지는 유치원알리미에 없습니다. 그래서 이 도구는 NEIS(교육정보 개방 포털)에서 모(母)초등학교의 학사일정을 가져옵니다.

# ○○초등학교병설유치원 — 방학·학사일정
모초등학교: ○○초등학교 · 2026학년도 기준

## 방학
- **여름방학**: 2026-07-21 ~ 2026-08-31 (42일)
- **겨울방학**: 2027-01-01 ~ 2027-01-24 (24일)
- **학년말방학**: 2027-02-13 ~ 2027-02-28 (16일)
→ 방학 합계 **82일**

한계: 조회 결과는 초등학교 일정입니다. 병설유치원은 대체로 이를 따르지만 정확히 같지는 않습니다(유치원 법정 수업일수 180일, 초등학교 190일). 최종 확인은 유치원에 문의하세요. 사립·단설 유치원은 NEIS에 없어 이 명령이 동작하지 않습니다.

NEIS 인증키는 open.neis.go.kr에서 무료로 발급받아 .env의 NEIS_API_KEY에 넣으면 됩니다. 없어도 나머지 기능은 모두 정상 동작합니다.

계산해 주는 지표

원본 공시에는 없고 이 도구가 계산하는 값들입니다.

정원 충원율 — 전체 원아 수 ÷ 인가 정원
연령별 학급당 원아 수 — 아이 한 명이 받는 관심의 대략적 척도
교사 근속 추정 평균과 분포 — 공시 구간(1년 미만 ~ 6년 이상)의 중간값 가중 추정치입니다. "1년 미만 비율"이 높으면 이직이 잦다는 신호로 볼 수 있습니다
원아 1인당 교실면적, CCTV 실내외 대수, 통학차량 운행 대수, 방과후과정 참여율

조회하는 공시 항목

기본현황, 건물현황, 교실면적, 교직원현황, 수업일수, 급식운영, 통학차량, 근속연수, 환경위생 관리, 안전점검·교육, 공제회 가입, 보험별 가입, 방과후 과정 편성·운영.

교육부가 특정 항목을 점검 중이면 그 항목만 점검 중으로 표시되고 나머지는 정상 조회됩니다.

AI 에이전트에서 쓰기

MCP 서버

등록해 두면 "강남구에 만3세반 있는 유치원 알려줘"처럼 말로 물어보는 것만으로 조회됩니다. mcp 패키지가 필요합니다(pip install mcp).

# Claude Code
claude mcp add --scope user kaic-kinder-info -- "<파이썬 절대경로>" "<저장소 경로>/mcp_server.py"

# Codex
codex mcp add kaic-kinder-info -- "<파이썬 절대경로>" "<저장소 경로>/mcp_server.py"

python이라고만 쓰지 마세요. Windows에서는 Microsoft Store 스텁으로 잡혀 CONNECTION_CLOSED로 실패합니다. where python / which python3로 절대 경로를 확인해 쓰세요.

노출되는 도구(18종): search_kindergartens, kindergarten_profile, compare_kindergartens, kindergarten_schedule, kindergarten_report, kindergarten_hours, kindergarten_trend, kindergarten_diff, kindergarten_bus, kindergarten_traffic_safety, annex_school_context, kindergarten_extended_disclosure, kindergarten_source_status, save_shortlist, set_home_location, raw_data, list_regions, discover_region — CLI의 모든 기능을 대화로 쓸 수 있습니다. 후보를 저장해 두면 "내 후보 추이 보여줘", "브리핑 다시 만들어줘"가 인자 없이 동작합니다.

스킬

python sync_skill.py

~/.claude/skills/와 ~/.codex/skills/ 양쪽에 배포됩니다. 스킬에는 명령어 사용법뿐 아니라 결과 해석 기준(충원율을 어떻게 읽을지, 근속 평균이 추정치라는 점 등)이 들어 있어, 에이전트가 숫자를 단정적으로 해석하지 않도록 잡아 줍니다.

알아두면 좋은 것

공시 자료는 1년에 두 번(4월 말, 10월 말경) 갱신됩니다. 출력 상단에 2026년 1차 공시처럼 기준이 표시됩니다. 원서 접수 직전에는 --fresh로 최신 자료를 다시 받으세요.
원비는 Open API에는 없지만 웹 공시에서 조회합니다. 모집요강·경쟁률·통학구역은 어떤 제공 데이터에도 없으므로 처음학교로나 유치원에 직접 확인해야 합니다.
유치원 원서 접수(처음학교로)는 보통 입학 전해 11월입니다.
혼합반 정원은 포함 연령의 합계입니다. 검색 결과의 숫자를 해당 연령 모집 인원으로 단정하지 말고 profile --web과 유치원 문의로 확인하세요.

요구 사항

파이썬 3.9 이상 (표준 라이브러리만 사용)
유치원알리미 Open API 인증키
병설 모초등학교 학교알리미 기능을 쓸 경우에만 학교알리미 키
MCP 서버를 쓸 경우에만 mcp 패키지

문서

문서	내용
AGENTS.md	AI 에이전트용 — 초보자 설치 안내 절차, 문제 해결, 개발 규약
CHANGELOG.md	버전별 변경 이력
skill/kaic-kinder-info/SKILL.md	에이전트가 이 도구를 사용할 때의 지침

라이선스

MIT

Name		Name	Last commit message	Last commit date
skill/kaic-kinder-info		skill/kaic-kinder-info
.env.example		.env.example
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
check_docs.py		check_docs.py
kinderbulk.py		kinderbulk.py
kinderinfo.py		kinderinfo.py
kinderweb.py		kinderweb.py
mcp_server.py		mcp_server.py
neis.py		neis.py
route.py		route.py
schoolbus.py		schoolbus.py
schoolinfo.py		schoolinfo.py
sync_skill.py		sync_skill.py
traffic_safety.py		traffic_safety.py
verified_hours.py		verified_hours.py

Navigation Menu

Repository files navigation

kaic-kinder-info

필요한 키와 설정 — 한눈에

빠른 시작

사용법

혼합연령 학급을 빠뜨리지 않는 연령 검색

지역 지정 방법

최종 후보 브리핑 (`report`)

확장 출처 — 무엇을 어디서 가져오나

자차 경로의 어린이 교통사고 다발지 (`traffic`)

통학버스 자동 확인과 엑셀 비상 자료 (`bus`)

실제 운영시간 비교 (`hours`)

추이와 변화 — 스냅샷의 함정을 벗어나기 (`pick`·`trend`·`diff`)

새 공시 감지와 `refresh`

연령별 학급 구성·원비·시정명령 (`profile --web`)

집에서 가까운 곳 추리기 (`home`·`--near`·`--road`)

정차 여건은 로드뷰로 (자차 등하원)

병설유치원의 방학 찾기 (`schedule`)

계산해 주는 지표

조회하는 공시 항목

AI 에이전트에서 쓰기

MCP 서버

스킬

알아두면 좋은 것

요구 사항

문서

라이선스

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

kaic-kinder-info

필요한 키와 설정 — 한눈에

빠른 시작

사용법

혼합연령 학급을 빠뜨리지 않는 연령 검색

지역 지정 방법

최종 후보 브리핑 (report)

확장 출처 — 무엇을 어디서 가져오나

자차 경로의 어린이 교통사고 다발지 (traffic)

통학버스 자동 확인과 엑셀 비상 자료 (bus)

실제 운영시간 비교 (hours)

추이와 변화 — 스냅샷의 함정을 벗어나기 (pick·trend·diff)

새 공시 감지와 refresh

연령별 학급 구성·원비·시정명령 (profile --web)

집에서 가까운 곳 추리기 (home·--near·--road)

정차 여건은 로드뷰로 (자차 등하원)

병설유치원의 방학 찾기 (schedule)

계산해 주는 지표

조회하는 공시 항목

AI 에이전트에서 쓰기

MCP 서버

스킬

알아두면 좋은 것

요구 사항

문서

라이선스

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

최종 후보 브리핑 (`report`)

자차 경로의 어린이 교통사고 다발지 (`traffic`)

통학버스 자동 확인과 엑셀 비상 자료 (`bus`)

실제 운영시간 비교 (`hours`)

추이와 변화 — 스냅샷의 함정을 벗어나기 (`pick`·`trend`·`diff`)

새 공시 감지와 `refresh`

연령별 학급 구성·원비·시정명령 (`profile --web`)

집에서 가까운 곳 추리기 (`home`·`--near`·`--road`)

병설유치원의 방학 찾기 (`schedule`)