공공데이터 API × Claude 청약 대시보드 제작·배포

주관한국부동산마케팅협회

강의명	공공데이터 API × Claude 청약 대시보드 제작·배포 — data.go.kr 공공데이터포털 가입 및 한국부동산원 청약 3종 API 인증키 발급부터, Claude Code로 실시간 청약 대시보드를 제작하고, GitHub·Vercel·Google OAuth로 팀 내부 웹앱까지 배포하는 전 과정
일시	2026년 5월 29일 (금)
장소	서울 강남구 언주로 711 5층 (논현동, 건설회관)

【 강의 목차 】

공공데이터포털(data.go.kr) 개념
API 인증키 발급 + 청약 3종 API 구조
REST API 호출 구조 + 인증키 보안(.env)
Claude Code 청약 대시보드 제작 — Code·Design 병행
GitHub 개념 + GitHub Pages·CLI 배포
GitHub → Vercel 자동 배포 파이프라인
팀원만 접근 가능한 내부앱 — Google OAuth

PART 1 공공데이터 API × Claude 청약 대시보드 — 국가 데이터로 실시간 대시보드 만들기 data.go.kr 가입과 한국부동산원 청약 3종 API 인증키 발급부터, REST API 호출 구조 이해와 Claude Code·Claude Design을 병행한 실시간 청약 대시보드 제작까지

01공공데이터포털(data.go.kr) 개념

▶ 공공 API의 정의와 활용신청 흐름

공공데이터포털이란정부·공공기관 보유 데이터를 무료 개방하는 국가 플랫폼 · 교통·날씨·부동산 등 API 제공
공공 API의 강점무료(1,000건/분) · 공신력 · 지속 제공 · 별도 서버 없이 키만으로 호출
가입 → 발급 흐름회원가입 → 데이터셋 검색 → 활용신청(목적 입력) → 즉시 또는 1~2일 내 인증키 발급

02API 인증키 발급 + 청약 3종 API 구조

▶ 인증키 발급 4단계 실습

인증키 발급회원가입 → "청약홈" 검색 → 활용신청 → 마이페이지에서 일반 인증키 복사
인증키 형태URL 인코딩 형태 · 인코딩/디코딩 두 종류 중 실습은 디코딩 버전 활용 · 1개 키로 3개 데이터셋 호출

▶ 청약 3단계 × 3개 API 개념

① 분양정보(15098547)공고 단계 · 주택명·공급지역·모집공고일 · "어디서 시작됐나"
② 경쟁률(15098905)진행 단계 · 단지별 경쟁률·특별공급 현황 · "지금 얼마나 몰렸나"
③ 당첨자(15110812)사후 분석 · 지역·연령별 당첨자·가점 통계 · "어떤 사람이 됐나"
공통 연결 키공고번호(HOUSE_MANAGE_NO)로 3개 API를 하나의 단지로 조인

03REST API 호출 구조 + 인증키 보안(.env)

▶ REST API 호출 구조와 보안 원칙 개념

REST API란데이터 요청 시 지켜야 할 규칙·양식 · serviceKey·pageNo·numOfRows·type 파라미터로 호출
가이드 문서 제공API 가이드 문서를 작업 폴더에 배치 → Claude가 임의 추정 없이 정확한 규격으로 코드 작성
인증키 보안(.env)키·토큰은 .env에 저장 후 .gitignore 등록 · 공백 포함 시 호출 오류 · CORS 제한은 서버사이드로 처리

04Claude Code 청약 대시보드 제작 with Code·Design

▶ 대시보드 제작 실습 실습

Code·Design 병행Claude Code로 코어 기능 구현 · Claude Design으로 화면 디자인 생성 후 조합
프롬프트 원칙인증키 전달 · 요구사항 번호 나열(탭·필터·차트) · 스택·배포 환경(Next.js·Vercel) 명시
모드·요소 개선Shift+Tab으로 Plan 모드 · 로컬 실행 확인 · F12 요소 복사(Copy Element)로 부분 개선

PART 2 GitHub → Vercel → 팀 내부앱 — 만든 대시보드를 팀과 공유하기 Git·GitHub 개념과 GitHub Pages·CLI 무료 배포부터, GitHub·Vercel 자동 배포 파이프라인, Google OAuth로 팀원만 접근 가능한 내부 웹앱 구성까지

05GitHub 개념 + GitHub Pages·CLI 배포

▶ Git·GitHub와 무료 배포 실습

Git·GitHub 개념Git은 변경 이력 기록 도구 · GitHub는 코드를 인터넷에 저장·배포하는 서비스(레포지토리)
GitHub Pages 배포Public 레포에 index.html 업로드 → Settings → Pages → Branch main 변경 → 무료 배포(단일 HTML 한정)
GitHub CLI(gh)gh auth login으로 한 번 인증 → 저장소 생성·커밋·푸시를 Claude가 터미널에서 대신 처리

06GitHub → Vercel 자동 배포 파이프라인

▶ Vercel 자동 배포 실습

배포 흐름Claude Code → GitHub → Vercel → Google OAuth → 팀원 · git push 한 번이면 자동 재배포
Vercel 연동GitHub로 가입 → 저장소 Import → 환경 변수 입력 → Deploy → vercel.app 주소 생성
비용GitHub Private·Vercel 내부용·Google OAuth 모두 무료 플랜으로 충분

07팀원만 접근 가능한 내부앱 — Google OAuth

▶ 접근 제한 3가지 방법 개념

방법 A — 워크스페이스 조직@회사명.com 보유 시 OAuth "내부(Internal)" 설정 · 외부 계정 자동 차단
방법 B — Gmail 개인 계정OAuth "테스트 사용자"에 팀원 이메일 등록(최대 100명, 검수 불필요)
방법 C — 코드 레벨 제한특정 도메인 외 접근을 막는 미들웨어 추가 요청으로 이중 보호