본문으로 이동
DLDevelopment Lab책을 읽고, 직접 만드는 실험실
6아파트 실거래가와 위치 정보를 가져옵니다7내 조건에 맞는 아파트를 찾습니다8누구나 사용할 수 있는 아파트 찾기 서비스를 만듭니다
PART 2 · AI로 부동산을 분석합니다6장

아파트 실거래가와 위치 정보를 가져옵니다

국토교통부 실거래와 Kakao 위치 자료를 프로젝트에서 가져옵니다.

이어갈 프로젝트 · apartment-explorer

새 apartment-explorer 프로젝트를 만들 단계이며 앞 PART 작업은 별도 보존합니다.

커맨드준비막혔을 때완료 확인소스·검증
이번 장의 준비와 서비스

필요한 도구 · Node.js · TypeScript · Next.js · 프로젝트 Test

이미 준비한 계정과 기능은 그대로 이어갑니다.

github 준비 안내 →data-go-kr 준비 안내 →kakao 준비 안내 →

키를 대화·Git에 노출하거나 아직 검색 기능·웹 화면을 먼저 만들지 않습니다.

순서대로 입력하는 커맨드

현재 단계와 입력 위치를 확인한 뒤 하나씩 복사하세요.

01시작 전 확인

Claude Code·Codex에 입력튜터 요청

6장을 처음 시작하거나 현재 장의 시작 조건을 확인해 달라고 요청할 때

먼저 확인 · 새 apartment-explorer 프로젝트를 만들 단계이며 앞 PART 작업은 별도 보존합니다. 이미 확인된 장·프로젝트는 다시 묻지 않고 현재 기록과 실제 상태를 대조합니다.

6장 시작해.

02새 프로젝트에서도 앞에서 정한 작업 방식은 이어집니다

Claude Code·Codex에 입력실습

새 프로젝트 시작 시 적용할 공통 Git 준비 원칙을 추가할 때

먼저 확인 · 독자가 movie-report 옆에 apartment-explorer를 만들고 Code 탭에서 로컬 작업 폴더로 선택했는지 확인합니다. 기존 공통 지침을 읽습니다.

앞으로 새로운 프로젝트 폴더에서 작업을 시작하면
먼저 Git으로 관리되고 있는지와
연결된 GitHub 저장소가 있는지 확인해줘.

새 프로젝트이고 앞으로 계속 작업할 프로젝트라면
별도의 Git 기록을 시작하고
프로젝트 폴더와 같은 이름의 비공개 GitHub 저장소를
준비해서 연결해줘.

프로젝트의 첫 정상 상태가 확인되면
그 기록은 연결한 GitHub 저장소에도 한 번 보내고
실제로 올라갔는지 확인해줘.

그 이후의 모든 Git 기록을
자동으로 GitHub에 보내지는 마.

기존 프로젝트라면 새 저장소를 만들지 말고
기존 Git 기록과 GitHub 저장소를 계속 사용해줘.

새 프로젝트인지 기존 프로젝트인지 확실하지 않으면
임의로 만들지 말고 먼저 나에게 확인해줘.

로그인이나 승인처럼 내가 직접 해야 하는 일이 있으면
그 지점에서 기다리고 무엇을 해야 하는지 안내해줘.

이 원칙도 모든 프로젝트에서 사용할
공통 ~/.claude/CLAUDE.md에 추가해줘.
기존 공통 원칙은 지우거나 중복해서 만들지 마.

03새 프로젝트에서도 앞에서 정한 작업 방식은 이어집니다

Claude Code·Codex에 입력실습

apartment-explorer를 새 프로젝트로 준비할 때

먼저 확인 · 현재 선택 폴더가 apartment-explorer인지와 앞에서 추가한 공통 원칙을 확인합니다. GitHub 로그인·승인이 필요한 경우 독자가 직접 처리합니다.

지금 연 apartment-explorer는
앞으로 계속 작업할 새 프로젝트야.

앞에서 정한 공통 작업 원칙을 확인하고
새 프로젝트를 시작할 때 필요한 준비를 진행해줘.

로그인이나 승인처럼 내가 직접 해야 하는 일이 나오면
그 지점에서 기다리고 무엇을 해야 하는지 안내해줘.

아직 아파트 기능이나 API 연결은 만들지 마.

04이번 프로젝트에서 사용할 기술을 알아봅니다

Claude Code·Codex에 입력실습

새 프로젝트의 Node.js와 TypeScript·Next.js 기본 구조를 준비할 때

먼저 확인 · 새 프로젝트 Git·GitHub 연결과 기존 파일을 확인합니다. 프로그램 설치 승인 화면이 나오면 독자가 대상을 확인합니다.

이번 부동산 프로젝트는 TypeScript와 Next.js를 사용해서 진행할 거야.
아파트 찾기 기능을 만든 다음 실제 웹서비스로 공개할 예정이야.
지금 사용하는 컴퓨터에 이 프로젝트를 시작하는 데 필요한 Node.js 환경이 준비되어 있는지 확인해줘.
없다면 왜 필요한지 설명하고 현재 Next.js에서 사용할 수 있는 버전을 확인한 뒤 설치를 진행해줘.
apartment-explorer 폴더에 TypeScript를 사용하는 Next.js 프로젝트의 기본 구조까지 준비해줘.
아직 아파트 찾기 기능이나 API 연결은 만들지 마.

05필요한 데이터부터 찾아봅니다

Claude Code·Codex에 입력실습

실거래와 위치·주변 장소를 제공할 공식 데이터 출처를 조사할 때

먼저 확인 · 기본 프로젝트 준비를 확인합니다. 아직 최종 검색 기능을 만드는 단계가 아닙니다.

아파트의 실제 매매 거래 가격과 위치, 주변 지하철역·초등학교 정보를 가져오고 싶어.
프로그램에서 사용할 수 있는 데이터나 서비스를 찾아줘.
가능하면 신뢰할 수 있는 공식 자료를 우선해서 조사해줘.

06API로 실제 데이터를 가져옵니다

Claude Code·Codex에 입력실습

선택한 두 API를 사용하기 위한 사람의 준비를 확인할 때

먼저 확인 · 국토교통부 아파트 매매 실거래가와 Kakao Local API를 사용할 대상인지 확인합니다.

국토교통부 아파트 매매 실거래가 API와 Kakao Local API를 사용하려고 해.
아직 구현하지 마.
두 API를 사용하려면 내가 직접 가입하거나 신청하거나 준비해야 하는 것이 있는지 알려줘.
있다면 어디에서 무엇을 해야 하는지 처음 해보는 사람도 따라 할 수 있게 설명해줘.

07국토교통부 서비스키를 준비합니다

Claude Code·Codex에 입력실습

지정한 국토교통부 API의 활용신청과 서비스키 확인을 안내받을 때

먼저 확인 · 공공데이터포털의 data/15126469/openapi.do가 맞는지 확인합니다. 이미 신청·승인·키 준비를 마쳤다면 반복하지 않습니다.

공공데이터포털의 국토교통부_아파트 매매 실거래가 자료를 사용할 거야.
주소는 https://www.data.go.kr/data/15126469/openapi.do 야.
이름이 비슷한 다른 데이터가 있으니 이 주소의 데이터로만 진행해줘.
공공데이터포털에서 내가 직접 해야 하는 과정만 알려줘.
활용신청부터 서비스키를 확인할 때까지 처음 하는 사람도 따라 할 수 있게 설명해줘.
API를 연결하는 코드는 아직 작성하지 마.
8. 2. 활용신청을 합니다 선택·문제 발생 시
Claude Code·Codex에 입력선택·문제 발생 시

독자가 실제 국토교통부 활용신청 화면에서 조작 도움을 요청할 때만

먼저 확인 · 현재 화면이 지정한 아파트 매매 API인지 확인하고 실제 키나 개인정보는 공유하지 않습니다.

지금 공공데이터포털의 아파트 매매 실거래가 API 활용신청 화면에 있어.
이 API를 사용하려면 이 화면에서 내가 해야 하는 것만 알려줘.

09Kakao REST API 키를 준비합니다

Claude Code·Codex에 입력실습

Kakao Local API를 사용할 앱과 REST API 키를 준비할 때

먼저 확인 · 국토교통부 신청 상태를 구분하고 Kakao Developers의 본인 계정·기존 실습 앱이 있는지 확인합니다.

Kakao Local API를 사용할 거야.
내가 직접 해야 하는 과정만 알려줘.
Kakao Developers에서 필요한 준비를 시작해서 이번 실습에 사용할 키를 확인할 때까지 처음 하는 사람도 따라 할 수 있게 설명해줘.
아직 코드는 작성하지 마.

10키는 코드에 넣지 않습니다

Claude Code·Codex에 입력실습

두 인증정보가 준비되어 안전한 로컬 입력 위치를 만들 때

먼저 확인 · 국토교통부 승인·서비스키와 Kakao 앱·REST API 키 준비를 확인합니다. 실제 값은 대화에 넣지 않습니다.

국토교통부 서비스키와 Kakao REST API 키를 사용할 준비가 됐어.
실제 키가 프로그램 코드나 Git에 들어가지 않게 이 프로젝트에서 안전하게 사용할 수 있도록 준비해줘.
실제 값은 내가 직접 입력할게.
어디에 입력하면 되는지만 알려줘.

11키는 코드에 넣지 않습니다

Claude Code·Codex에 입력실습

독자가 두 키를 직접 입력한 뒤 노출 여부를 확인할 때

먼저 확인 · 앞에서 안내한 로컬 위치에 독자가 두 값을 직접 입력했는지 확인합니다. 값 자체는 읽어 출력하지 않습니다.

방금 입력한 실제 키가 프로그램 코드나 Git에 포함되지 않는지 확인해줘.
실제 키 값 자체는 화면에 출력하지 말고 안전하게 사용할 준비가 되었는지만 알려줘.

12이제 실제 데이터를 가져옵니다

Claude Code·Codex에 입력실습

안전한 키 준비 후 국토교통부 API를 실제 연결할 때

먼저 확인 · 정확한 API 승인과 로컬 키 입력·노출 검사를 확인합니다. 앞선 호출이 진행 중이거나 결과 미확인이면 새 호출부터 하지 않습니다.

이 프로젝트에서 준비한 국토교통부 서비스키를 사용해서 아파트 매매 실거래가 API가 실제로 동작하는지 확인해줘.
TypeScript와 Next.js로 만든 현재 프로젝트에서 앞으로 다시 사용할 수 있게 연결해줘.
테스트할 수 있는 실제 아파트 매매 데이터를 가져와서 사람이 알아볼 수 있게 몇 건만 보여줘.
거래 해제 여부도 확인할 수 있게 해줘.
서비스키 값은 화면과 오류 메시지에 절대 나오지 않게 해줘.
서비스키에 %가 들어 있으면 그대로 써줘. 프로그램이 한 번 더 바꾸면 인증이 실패해.
지금은 아파트 검색 기능을 만들지 말고 실제 데이터를 가져오는 데 성공했는지만 확인해줘.

13위치 정보도 실제로 가져옵니다

Claude Code·Codex에 입력실습

국토교통부의 실제 아파트에 Kakao 위치·주변 장소를 연결할 때

먼저 확인 · 앞 호출에서 확인한 아파트 주소와 로컬 REST API 키를 확인합니다.

같은 프로젝트에서 준비한 Kakao REST API 키를 사용해서 Kakao Local API가 실제로 동작하는지 확인해줘.
방금 국토교통부 데이터에서 확인한 아파트 중 하나를 사용해서 주소와 위치를 확인하고, 주변 지하철역이나 초등학교 같은 장소 정보를 실제로 가져와서 몇 건만 보여줘.
앞으로 다시 사용할 수 있게 현재 프로젝트에 연결해줘.
REST API 키 값은 화면과 오류 메시지에 절대 나오지 않게 해줘.
지금은 최종 아파트 검색 기능을 만들지 말고 위치와 주변 장소 데이터를 가져오는 데 성공했는지만 확인해줘.

14다음에도 제대로 동작하는지 확인할 Test를 만듭니다

Claude Code·Codex에 입력실습

두 API의 실제 응답 확인 뒤 저장한 예시로 처리 Test를 만들 때

먼저 확인 · 실제 두 API 응답을 확보했는지 확인합니다. 예시에 비밀값·개인정보를 남기지 않습니다.

두 API에서 받은 응답을 읽어서 필요한 정보를 뽑아내는 부분에 Test를 만들어줘.
Test는 실제 API를 호출하지 말고 프로젝트에 저장해둔 응답 예시로 확인하도록 해줘.
응답 예시에는 실제 키 값이나 개인정보가 들어가지 않게 해줘.
거래 해제된 거래를 구분하는 것과 주변 장소를 찾는 것도 함께 확인해줘.
Test를 실행해서 결과를 보여줘.

15다음에도 제대로 동작하는지 확인할 Test를 만듭니다

Claude Code·Codex에 입력실습

두 API 연결과 응답 처리 검사를 확인한 뒤 작업을 마무리할 때

먼저 확인 · 실제 호출 결과와 저장 예시 Test 결과를 나누고 대상 apartment-explorer 저장소를 확인합니다.

이번 작업을 마무리하고
GitHub 저장소에도 보내줘.

16이 장을 마쳤는지 확인합니다

Claude Code·Codex에 입력튜터 요청

6장의 실습 결과를 장별 완료 조건과 대조할 때

먼저 확인 · 앞 단계 실행 결과와 사람이 직접 확인할 항목을 확인합니다. 요청문을 보여주거나 실행했다고 완료로 세지 않습니다.

장 완료 확인해줘.
이 장에서 막혔을 때
디버깅 → 내 정상 기록으로 복구 → 장별 Source로 재시작

Git 명령을 외우거나 직접 입력할 필요는 없습니다. 아래 요청문을 그대로 붙여넣으면 Claude Code가 확인하고 처리합니다.

1. 디버깅 — 먼저 무엇이 어긋났는지 그대로 말하고 고쳐봅니다. 대부분 여기서 해결됩니다.

지금 작업이 책과 다르게 진행됐어.
현재 상태와 화면에 나온 문제를 확인하고 원인을 찾아서 고쳐줘.

이 장에서 특히 자주 막히는 자리는 키가 아직 동작하지 않는 경우입니다. 발급 직후에는 바로 사용할 수 없는 키도 있습니다.

국토교통부 API에서 등록되지 않은 서비스키라는 응답이 왔어.
지금 입력한 키가 이 API에서 사용할 수 있는 상태인지 확인하고
무엇을 더 해야 하는지 알려줘.

2. 내 정상 기록으로 복구 — 해결되지 않으면 실습하면서 내 프로젝트에 남겨둔 정상 기록으로 돌아갑니다. 지금까지 한 작업은 먼저 따로 보존합니다.

현재 작업은 잃지 않도록 먼저 별도로 보존해줘.
이 프로젝트에서 마지막으로 정상 동작했던 상태를 찾아 안전하게 복구해줘.

3. 장별 Source로 재시작 — 그래도 이어갈 수 없을 때 사용합니다. 6장의 남은 실습은 건너뛰게 되므로 마지막 수단입니다.

내 현재 작업을 먼저 안전하게 보존해줘.
아래 6장 완성 Source에서 다시 시작해줘.
https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch06/source/apartment-explorer
내 두 개의 키를 입력할 자리를 알려주고
준비가 끝나면 6장을 마친 상태인지 확인해줘.

방향부터 확인하고, 더 필요할 때 다음 힌트를 펼치세요.

서비스키를 넣었는데 인증 오류
1단계 — 방향

신청한 API와 현재 호출 API가 같은지 봅니다.

2단계 — 범위

활용 승인·키 종류·실제 응답 코드부터 나눕니다.

3단계 — 위치·원인 후보

원본 키와 요청 조립 단계의 인코딩 횟수를 값 노출 없이 확인합니다.

정답을 요청했을 때

승인 상태와 코드의 키 처리 방식을 맞추고 최소 호출로 다시 확인합니다. 오류 메시지에 키가 있으면 가린 뒤 전달합니다.

검증 주의

이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.

Test PASS인데 실제 연결이 안 됨
1단계 — 방향

어떤 입력으로 검사했는지 확인합니다.

2단계 — 범위

저장한 응답 예시와 실제 네트워크 요청을 구분합니다.

3단계 — 위치·원인 후보

현재 실행 환경의 변수 이름·값 존재·응답 코드를 확인합니다.

정답을 요청했을 때

응답 처리 Test와 별도로 실제 API 연결을 확인합니다. 시험 응답 통과를 인증 성공으로 기록하지 않습니다.

검증 주의

이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.

디버깅 → 정상 기록 복구 → 장별 소스로 재시작 →
이번 장의 완료 체크리스트
  • 작업 환경폴더·Node.js·기본 프로젝트·Git 연결 확인
  • 실거래 키정확한 API 신청과 본인 서비스키 준비
  • Kakao 키Local API용 앱과 REST API 키 준비
  • 비밀값 대응코드가 읽는 이름과 로컬 보관 위치 확인
  • 실제 연결두 API를 실제 호출하고 응답 확인
  • 응답 검사저장한 응답 예시로 파싱과 예외를 검사
장 완료 확인해줘.

실제 프로젝트에서 튜터와 확인합니다. 사이트를 열어본 기록은 학습 완료가 아닙니다.

장별 소스와 저자 검증 기록

저자는 5장 도착점에서 시작해 6장 요청문만으로 두 API 연결과 Test까지 갔습니다. 저장해둔 응답 예시로 실행하는 Test 11개가 모두 통과했고, 두 API가 실제로 돌려주는 데이터도 실제 키로 확인했습니다. 근거는 verification/chapter-06/에 있습니다.

6장 완성 소스 ↗저자 검증 상세 기록 ↗

장별 소스는 해당 장까지의 기준 상태입니다. 정상 실습은 내 프로젝트를 이어가고, 완성 소스는 비교·복구할 때 사용합니다.

자료 판본 1c784213
이 장의 개발 용어
API
프로그램이 다른 서비스와 정해진 방식으로 요청·응답을 주고받는 연결 방법.
Test
정한 완료 조건을 반복 확인하는 검사. 검사하지 않은 전체 정확성을 보증하지 않습니다.
튜터 사용 안내실습 자료 업데이트
← 이전 장5장. 잘되던 때로 돌아갈 곳을 만들어둡니다다음 장 →7장. 내 조건에 맞는 아파트를 찾습니다
Development Lab아이디어를 AI와 함께 나만의 결과물로 만듭니다.

책에서 배운 개발 원칙을 AI와 직접 만들며 확인하는 실험실입니다. 아이디어를 서비스로, 서비스를 나만의 결과물로. AI와 함께 만들고, 직접 확인하며, 내 손으로 완성합니다.

자료실튜터 안내업데이트
SAStudy AI LabILInvestment LabDLDevelopment Lab

© 2026 Study AI Lab. All rights reserved.