종합부동산웹앱 API 키 실보유 확인

질의 원문

'학교알리미 Open API와 서울 열린데이터광장 키를 이미 받았다면 그 둘은 추가 신청 대상이 아니라 수집기/파서 구현 대상입니다.'

열린데이터광장키는 이 프로젝트에서 확인해보고 학교알리미는 research 프로젝트에서 확인해봐

수집 시점

2026-08-12 12:58:46 +09:00
확인 경로:
부동산 프로젝트: D:\03.Dev\Projects\11.real_assets\.worktrees\real-assets-investment-app
Research 프로젝트: D:\03.Dev\Projects\research
전역 secrets: C:\Users\progd\.claude\.secrets.env

데이터 등급

항목	등급	설명
전역 secrets 키 존재 여부	로컬 1차 설정	값은 노출하지 않고 변수명·존재·길이만 확인했다.
프로젝트 코드 `load_env()` 결과	로컬 실행 검증	앱이 실제로 키를 읽을 수 있는지 확인했다.
research `config/.env`, registry, CLAUDE.md	로컬 프로젝트 원천	학교알리미 접근 방식과 키 저장 여부를 확인했다.

확인 결과

서울 열린데이터광장 키

확인 대상	결과
현재 셸 환경변수 `SEOUL_OPENDATA_KEY`	없음
전역 secrets `C:\Users\progd\.claude\.secrets.env`	있음. `SEOUL_OPENDATA_KEY=PRESENT length=32`
이 프로젝트 `realestate.collectors.base.load_env("SEOUL_OPENDATA_KEY")`	있음. `PRESENT length=32`
프로젝트 로컬 `.env`	없음

판단: 서울 열린데이터광장 키는 이 프로젝트에서 사용 가능하다. 현재 셸 환경변수에는 직접 로드되어 있지 않지만, 프로젝트의 load_env()가 전역 ~/.claude/.secrets.env를 읽으므로 앱/CLI 기준으로는 키 보유 상태다.

학교알리미 Open API 키

확인 대상	결과
research `config/.env`	`SCHOOL_ID`, `SCHOOL_PW`, `TELEGRAM_*`, `ANTHROPIC_API_KEY`만 있음. `SCHOOLINFO_API_KEY` 계열 없음
research `config/.env.example`	`SCHOOLINFO_API_KEY` 계열 없음
전역 secrets `C:\Users\progd\.claude\.secrets.env`	`DATA_GO_KR_`, `SEOUL_OPENDATA_KEY`는 있으나 `SCHOOLINFO_API_KEY`/`SCHOOL_ALIMI_`/`NEIS_API_KEY` 없음
이 프로젝트 `load_env("SCHOOLINFO_API_KEY")`	없음
research registry	`학교알리미 (학교정보공시)`에 `endpoint=http://www.schoolinfo.go.kr/openApi.do`, `params=apiKey,...`, `auth=schoolinfo SNS로그인 후 키발급`, `verified=true` 기록 있음
research 수집기	`src/scripts/fetch_schoolinfo_uuids.py`로 학교알리미 `SHL_IDF_CD` UUID 51/51 수집 완료 기록 있음

판단: research 프로젝트에는 학교알리미 접근 메타데이터와 웹/UUID 수집 노하우는 있음. 그러나 로컬 설정과 전역 secrets에서 학교알리미 Open API 키 자체는 발견되지 않았다. 사용자가 실제로 학교알리미 Open API를 신청했다면 아직 이 로컬 프로젝트/전역 secrets에는 저장되지 않은 상태로 보는 것이 맞다.

정리

서울 열린데이터광장: 추가 신청 대상 아님. 이 프로젝트에서 SEOUL_OPENDATA_KEY가 전역 secrets를 통해 실제 인식된다. 다음은 OA-22404~22437, CleanupPartnersInfo 등 서비스별 수집기/파서 구현이다.
학교알리미: 신청 자체는 사용자가 했을 수 있지만, research 프로젝트와 전역 secrets에서는 키 저장 흔적이 없다. 다음은 학교알리미 Open API 키를 SCHOOLINFO_API_KEY 같은 명시 변수명으로 저장하고 샘플 호출을 붙이는 단계다.
NEIS: 이번 확인 범위에서는 NEIS_API_KEY도 전역/로컬에서 발견되지 않았다. 다만 research의 기존 NEIS 학사일정 수집은 무키 제한 호출·분할 우회 노하우를 사용한 것으로 보인다.

가정과 한계

키 값은 보안상 출력하거나 문서화하지 않았다.
학교알리미 계정 화면에 직접 로그인해 발급 상태를 확인한 것은 아니다. 로컬 파일과 전역 secrets에 저장되어 있는지만 확인했다.
SCHOOLINFO_API_KEY는 이 프로젝트에서 쓰기 위한 권장 변수명이다. 실제 학교알리미 호출 파라미터명은 apiKey로 기록돼 있다.

다음 실행 제안

학교알리미 키를 C:\Users\progd\.claude\.secrets.env 또는 research config/.env에 SCHOOLINFO_API_KEY=...로 저장한다.
real-assets 프로젝트에서도 학교알리미를 쓰려면 collectors/base.py::load_env("SCHOOLINFO_API_KEY")를 기준으로 수집기를 만든다.
키 저장 후 http://www.schoolinfo.go.kr/openApi.do에 최소 샘플 호출을 붙이고, 응답 필드를 학군/학교 공시 모델로 정규화한다.

원문 Markdown: docs/analysis/2026-08-12-종합부동산웹앱-api키-실보유확인.md