9차시 입찰 업무에 필요한 나라장터 공고 조회 앱 만들기

강사용 · 앱을 만들기 위한 준비 — 두 가지 연결(조회·알림)이 되는지 확인하고 의도코드까지

0인트로

  • 오늘부터 나라장터 공고 조회 앱
  • 오늘은 만들기 전 준비 — "정말 되는지"부터
  • 확인할 것 두 가지: 조회(공고 가져오기) · 알림(메일 보내기)
  • 둘 다 되면 → 의도코드까지 완성
오늘의 흐름
① 조회 점검 → ② 알림 점검 → ③ 의도코드.md 완성 ⇒ 다음 시간: 개발플랜 → 앱

1예제 소개

  • 입찰 담당자 — 매일 나라장터 들어가 키워드 검색 반복
  • 이 일을 프로그램에게 — 새 공고는 메일로
  • 우리 회사 = 소프트웨어 유지보수 업체 (여러분은 내 업종 낱말로)
예제 조건
데이터공공데이터포털 조달청_나라장터 입찰공고정보서비스
공고 종류용역
검색 조건공고명에 유지보수 · 최근 7일 (API 최대 조회 기간)
보일 항목공고명 · 기관 · 마감일 · 원문 연결
알림조건에 맞는 공고를 이메일로

2조회 키 — 공공데이터포털 인증키

  • API = 프로그램이 데이터를 가져가도록 열어 둔 창구
  • 인증키 = 내 이름으로 받은 출입증 — 남에게 보이지 않기
  • 승인까지 1~2시간 걸릴 수 있음 → 미리 신청
순서
  1. https://www.data.go.kr 접속 → 로그인
  2. 검색창에 입력
나라장터 입찰공고정보서비스
  1. 오픈 API 탭 → 조달청_나라장터 입찰공고정보서비스 → 활용신청
  2. 활용 목적
입찰 공고 조회 프로그램 개발 실습
  1. 마이페이지 → 데이터활용 → Open API → 활용신청 현황 → 일반 인증키(Encoding) 복사
확인할 것
  • 활용신청 현황이 승인
  • 인증키를 메모장에 복사해 둠 (화면 공유 시 가리기)

3조회 점검 — 주소 하나로 공고 가져오기

  • 프로그램 없이 주소창만으로 먼저 확인
  • 연습 페이지 — 인증키 · 날짜 · 키워드 → URL 조립 → 복사
  • 사람은 화면을, 프로그램은 이 글자(JSON)를 받는다
연습 페이지

조달청_나라장터 입찰공고정보서비스 이용 (연습 페이지)

  1. 인증키 붙여 넣기 · 키워드 유지보수 (날짜는 자동 7일)
  2. 복사 → 새 탭 주소창에 붙여 넣기 → Enter
  3. 결과의 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단계 인증이 켜져 있어야 함
순서
  1. https://myaccount.google.com/security → 2단계 인증 켜져 있는지 확인 (꺼져 있으면 켜기)
  2. 앱 비밀번호 화면 열기
https://myaccount.google.com/apppasswords
  1. 앱 이름 입력 → 만들기
나라장터앱
  1. 나온 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, 남에게 보이지 않기
  • 다음 시간: 의도코드로 개발플랜 → 앱