9차시 입찰 업무에 필요한 나라장터 공고 조회 앱 만들기
강사용 · 앱을 만들기 위한 준비 — 두 가지 연결(조회·알림)이 되는지 확인하고 의도코드까지
0인트로
- 오늘부터 나라장터 공고 조회 앱
- 오늘은 만들기 전 준비 — "정말 되는지"부터
- 확인할 것 두 가지: 조회(공고 가져오기) · 알림(메일 보내기)
- 둘 다 되면 → 의도코드까지 완성
오늘의 흐름
① 조회 점검 → ② 알림 점검 → ③ 의도코드.md 완성 ⇒ 다음 시간: 개발플랜 → 앱
1예제 소개
- 입찰 담당자 — 매일 나라장터 들어가 키워드 검색 반복
- 이 일을 프로그램에게 — 새 공고는 메일로
- 우리 회사 = 소프트웨어 유지보수 업체 (여러분은 내 업종 낱말로)
예제 조건
| 데이터 | 공공데이터포털 조달청_나라장터 입찰공고정보서비스 |
|---|---|
| 공고 종류 | 용역 |
| 검색 조건 | 공고명에 유지보수 · 최근 7일 (API 최대 조회 기간) |
| 보일 항목 | 공고명 · 기관 · 마감일 · 원문 연결 |
| 알림 | 조건에 맞는 공고를 이메일로 |
2조회 키 — 공공데이터포털 인증키
- API = 프로그램이 데이터를 가져가도록 열어 둔 창구
- 인증키 = 내 이름으로 받은 출입증 — 남에게 보이지 않기
- 승인까지 1~2시간 걸릴 수 있음 → 미리 신청
순서
- https://www.data.go.kr 접속 → 로그인
- 검색창에 입력
나라장터 입찰공고정보서비스
- 오픈 API 탭 → 조달청_나라장터 입찰공고정보서비스 → 활용신청
- 활용 목적
입찰 공고 조회 프로그램 개발 실습
- 마이페이지 → 데이터활용 → Open API → 활용신청 현황 → 일반 인증키(Encoding) 복사
확인할 것
- 활용신청 현황이 승인
- 인증키를 메모장에 복사해 둠 (화면 공유 시 가리기)
3조회 점검 — 주소 하나로 공고 가져오기
- 프로그램 없이 주소창만으로 먼저 확인
- 연습 페이지 — 인증키 · 날짜 · 키워드 → URL 조립 → 복사
- 사람은 화면을, 프로그램은 이 글자(JSON)를 받는다
연습 페이지
조달청_나라장터 입찰공고정보서비스 이용 (연습 페이지)
- 인증키 붙여 넣기 · 키워드
유지보수(날짜는 자동 7일) - 복사 → 새 탭 주소창에 붙여 넣기 → Enter
- 결과의
bidNtceDtlUrl주소 → 새 탭 → 나라장터 원문과 대조
확인할 것
"resultCode":"00"·"resultMsg":"정상"- 공고명(
bidNtceNm)에 "유지보수" - 원문 주소 → 나라장터의 그 공고, 공고명·기관·마감일이 같다
안 될 때
| 화면 | 뜻 · 할 일 |
|---|---|
SERVICE_KEY_IS_NOT_REGISTERED_ERROR (30) | 키 등록 전 — 1~2시간 뒤 다시 / Decoding 키로 바꿔 보기 |
NO_OPENAPI_SERVICE_ERROR (12) | 주소 오타 — 연습 페이지에서 다시 복사 |
| resultCode 00, totalCount 0 | 조건에 맞는 공고 없음 — 키워드 넓히기 |
4조회 키 보관 — .env
- 확인한 인증키를 안전한 자리에
- 키는 대화창·코드 안이 아니라 .env 파일에 — 내가 직접 붙여 넣기
준비
Antigravity → 새 폴더 나라장터앱 → 파일 › 폴더 열기
요청 문장
이 폴더에서 나라장터 공고 조회·알림 프로그램을 만들 것이다.
공공데이터포털 인증키를 보관할 .env 파일을 만들고 DATA_GO_KR_KEY 자리를 만들어 줘.
값은 내가 직접 넣겠다.
→ .env 열기 → DATA_GO_KR_KEY= 뒤에 인증키 붙여 넣기 → 저장
확인할 것
.env가나라장터앱폴더 안에 있다 (점으로 시작 — 숨김 파일)DATA_GO_KR_KEY=뒤에 인증키가 들어 있다
5알림 키 — Gmail 앱 비밀번호
- 프로그램이 내 Gmail로 메일을 보내려면 열쇠가 필요
- 앱 비밀번호 = 프로그램 전용 비밀번호 (내 Gmail 비밀번호와 다름)
- 조건: 구글 계정 2단계 인증이 켜져 있어야 함
순서
- https://myaccount.google.com/security → 2단계 인증 켜져 있는지 확인 (꺼져 있으면 켜기)
- 앱 비밀번호 화면 열기
https://myaccount.google.com/apppasswords
- 앱 이름 입력 → 만들기
나라장터앱
- 나온 16자리를 메모장에 복사 (창을 닫으면 다시 볼 수 없음)
확인할 것
- 16자리 앱 비밀번호 복사해 둠 (화면 공유 시 가리기)
6알림 점검 — 테스트 메일 1통
- 알림 기능 만들기 전에 "메일이 정말 오나" 먼저
- 앱 비밀번호도 같은 .env 파일에 — 내가 직접 붙여 넣기
- 오늘은 한 통만. 진짜 알림은 다음에
요청 문장
먼저 이메일이 정말 보내지는지만 확인하고 싶다.
1) .env 파일에 GMAIL_ADDRESS, GMAIL_APP_PASSWORD 자리를 추가해 줘. 값은 내가 직접 넣겠다.
2) .env 를 읽어서 내 메일 주소로 테스트 메일 한 통만 보내는 python 파일을 만들어 줘.
제목: [나라장터앱] 테스트 메일
3) 실행 방법을 알려 줘.
→ .env 열기 → 내 Gmail 주소 · 앱 비밀번호 16자리 붙여 넣기 → 실행
확인할 것
- 내 메일함에 [나라장터앱] 테스트 메일 도착
- 코드 안에 비밀번호가 직접 적혀 있지 않다 (.env 에서 읽는다)
안 될 때
| 화면 | 뜻 · 할 일 |
|---|---|
535 Username and Password not accepted | 앱 비밀번호 다시 확인 — 띄어쓰기 빼기 / 2단계 인증 켜졌는지 |
| 실행은 됐는데 메일이 없음 | 스팸함 확인 |
| 그 밖의 오류 | 오류 화면을 AI에게 그대로 보여 주고 원인부터 묻기 (5차시) |
7키 점검 — 두 개의 키가 .env 에
- 키 두 개 — 조회 키(공공데이터포털) · 알림 키(Gmail)
- 둘 다 .env 한 곳에 들어 있는지 점검
- 8차시 .gitignore — GitHub에 올려도 키는 안 올라간다
요청 문장
.env 에 어떤 키가 있는지 이름만 보여 주고, 값이 비어 있는 것이 있는지 알려 줘. 값은 보여 주지 마.
그리고 .env 가 GitHub에 올라가지 않도록 .gitignore 를 만들어 줘.
확인할 것
.env에 키 세 개가 값과 함께 있다 (DATA_GO_KR_KEY · GMAIL_ADDRESS · GMAIL_APP_PASSWORD).gitignore안에.env
8의도코드 만들기
- 조회 ✔ 알림 ✔ — 이제 설계
- 첫 요청은 "만들어 줘"가 아니다 — 내 생각을 문서로
- 방금 확인한 것을 그대로 적어 준다
요청 문장
나는 회사에서 입찰 업무를 하고 있다.
매일 나라장터에서 우리 회사와 관련된 입찰 공고를 찾아본다.
이 일을 대신해 주고, 새 공고가 있으면 메일로 알려 주는 프로그램을 만들고 싶다.
- 데이터: 공공데이터포털 나라장터 입찰공고정보서비스 (조회 확인 완료, 인증키는 .env)
- 검색 조건: 용역 공고 중 공고명에 '유지보수'가 들어간 것, 최근 7일
- 보일 항목: 공고명, 기관, 마감일, 원문 연결 주소
- 알림: 조건에 맞는 새 공고를 Gmail로 보낸다 (테스트 메일 확인 완료, 앱 비밀번호는 .env)
바로 개발하지 말고, 내 생각을 네가 이해한 대로 의도코드.md 로 정리해 줘.
애매한 것은 '확인할 것'으로 남겨 줘.
9의도코드 확인 → 완성
- 위에서부터 읽으며 내 생각과 같은지
- 내가 말하지 않은 것 → 빼 달라고
- '확인할 것' → 답하기 → 다시 읽기 → 같아질 때까지
확인할 것
- 검색 조건 — 용역 · 유지보수 · 최근 7일
- 보일 항목 네 가지 — 공고명 · 기관 · 마감일 · 원문 연결
- 알림 — Gmail, 키는 .env
- 내가 말하지 않은 기능이 없다
- '확인할 것'에 모두 답했다
답하기 예시
마감일이 가까운 것부터 보여 주고, 마감이 지난 공고는 빼 줘.
메일은 하루에 한 번, 새 공고가 있을 때만 보내 줘.
10아웃트로
- 오늘: 조회 확인 · 알림 확인 · 의도코드 완성
- 만들기 전에 되는지 먼저 — 그래야 헤매지 않는다
- 키는 .env, 남에게 보이지 않기
- 다음 시간: 의도코드로 개발플랜 → 앱
10차시 관심 입찰 공고 실시간 알림 기능 추가하기
강사용 · 의도코드 → 개발플랜 → 기본형(CLI)으로 가능성 확인 → 다음 버전(검색어 · 앱 · 10분 조회 · 메일 추가)
0인트로
- 지난 시간: 조회 ✔ · 알림 ✔ · 의도코드 완성
- 오늘: 의도코드로 개발플랜 → 만들기
- 처음부터 크게 X — 기본형으로 되는지 먼저, 그다음 다음 버전
오늘의 흐름
의도코드.md → 개발플랜.md → 기본형(CLI) 확인 → 다음 버전 플랜 → 앱 (검색어 · 10분 조회 · 메일 추가)
1개발플랜 만들기 — 기본형(CLI)
- 의도코드 = 무엇을 / 개발플랜 = 어떻게
- 첫 버전은 기본형 — 터미널(CLI)에서 실행
- 목적은 가능성 검토 — 예쁜 화면은 나중에
요청 문장
의도코드.md 를 확인했다. 이것을 바탕으로 개발플랜.md 를 만들어 줘.
먼저 기본형으로, 터미널(CLI)에서 실행하는 python 프로그램으로 만든다.
목적은 가능성 검토다 — 공고를 조회해서 터미널에 보여 주고, 메일로 보낸다.
키는 .env 의 DATA_GO_KR_KEY, GMAIL_ADDRESS, GMAIL_APP_PASSWORD 를 쓴다.
어떤 순서로 만드는지, 어떻게 시험하는지 적어 줘.
아직 코드는 만들지 마.
2개발플랜 확인
- 위에서부터 읽으며 의도코드와 같은지
- 키를 .env 에서 읽는지 — 코드 안에 직접 적으면 X
- 내 생각과 다르면 고쳐 달라고 → 같아질 때까지
확인할 것
- 데이터 — 나라장터 입찰공고정보서비스, 키는
.env - 만드는 순서 — 조회 → 터미널 표 → 메일
- 시험 방법 — 원문과 대조 · 메일 도착 확인
- CLI 기본형 — 화면(앱)은 아직 없음
3기본형 개발 — CLI로 가능성 확인
- 단계마다 멈추고 확인
- 오류 나면 화면을 그대로 보여 주고 원인부터 (5차시)
- 터미널에 공고 + 메일 도착 = 가능하다
요청 문장
개발플랜.md 를 확인했다. 개발을 시작해 줘.
단계가 끝날 때마다 멈추고 알려 줘.
마지막에 실행 방법을 알려 줘.
확인할 것
- 터미널에 공고 목록 — 공고명 · 기관 · 마감일 · 원문 주소
- 원문 주소 → 나라장터의 그 공고, 마감일이 같다
- 내 메일함에 공고 메일 도착
4다음 버전 — 개발플랜 고치기
- 기본형으로 된다는 것 확인 → 이제 쓸 만하게
- 네 가지: 검색어 입력 · 앱(화면) · 10분마다 조회 · 메일 추가
- 바로 만들지 않고 플랜부터 고친다
요청 문장
기본형이 잘 동작하는 것을 확인했다. 다음 버전을 만들고 싶다.
1) 검색어를 내가 입력할 수 있게 해 줘.
2) 터미널이 아니라 화면이 있는 애플리케이션으로 만들어 줘.
3) 10분에 한 번씩 자동으로 조회해 줘.
4) 알림 받을 이메일 주소를 추가할 수 있게 해 줘.
이 내용으로 개발플랜.md 를 다음 버전으로 고쳐 줘.
아직 코드는 만들지 마.
확인할 것
- 네 가지가 모두 플랜에 있다
- 기본형에서 확인한 조회 · 메일 방식은 그대로
- 내가 말하지 않은 기능이 없다
5다음 버전 개발 → 실행
- 직접 조회 → 주기적 자동 조회 (10분)
- 사람이 들여다보지 않아도 프로그램이 찾아서 알려 준다
요청 문장
개발플랜.md 다음 버전을 확인했다. 개발을 시작해 줘.
단계가 끝날 때마다 멈추고 알려 줘.
마지막에 실행 방법을 알려 줘.
확인할 것
- 창(화면)이 열린다
- 검색어를 바꾸면 그 낱말로 조회된다
- 10분 뒤 다시 조회된다
- 이메일을 추가하면 그 주소로도 메일이 온다
6아웃트로
- 오늘: 개발플랜 → 기본형(CLI) → 다음 버전(앱)
- 작게 만들어 되는지 확인하고, 한 단계씩 키운다
- 그런데 — 프로그램을 끄면 조회도 멈춘다
- 다음 시간: 내가 만든 프로그램이 24시간 작동하도록