소개
코덱스, 클로드 코드는 완전 초보인데 스터디장께서 나눠준 메뉴얼을 바탕으로 챗과 대화하며 진행하였다. 즉, 공공데이터포털 API를 활용한 데이터 분석 환경을 Codex로 구축해 보았다. Python 개발환경을 직접 설정하는 대신 AI 코딩 도구를 활용하여 프로젝트를 자동으로 생성하고, API 키를 안전하게 관리하며 실제 공공데이터를 불러오는 과정을 경험해 보고자 했다.
진행 방법
사용 도구
OpenAI Codex
VS Code
Python(uv)
DuckDB, Polars, Pandas
공공데이터포털 API
진행 과정
Codex에게 데이터 분석 프로젝트를 생성하도록 요청하였다.
uv 기반 Python 환경과 필요한 라이브러리(DuckDB, Polars, Pandas)를 자동으로 설치하였다.
공공데이터포털 API 키를
.env파일에 저장하여 코드와 분리하는 방식으로 환경변수를 구성하였다..env파일을 읽어 API 호출을 테스트하고 연결 상태를 확인하였다.
사용한 프롬프트
이 폴더를 데이터 분석 프로젝트로 초기화해줘.
필요한 폴더 구조를 만들고 Python 환경을 설정한 뒤
duckdb, polars, pandas를 설치해줘..env 파일을 읽어서 공공데이터포털 연결을 테스트해줘.
인증키는 절대 출력하지 마.(실습 화면 캡처 첨부)
컴퓨터 화면의 스크린샷
결과와 배운 점
배운 점
AI가 Python 개발환경과 프로젝트 구성을 대부분 자동으로 수행해 주어 초기 환경 구축 시간이 크게 단축되었다.
API 키는
.env파일에 저장하여 코드와 분리하는 것이 보안과 관리 측면에서 유용하다는 점을 이해하였다.Codex가 오류 원인을 설명해 주면서 문제를 하나씩 해결하는 과정이 인상적이었다.
시행착오
처음에는 API 키를 PowerShell에 직접 입력하거나 채팅창에 붙여 넣어 오류가 발생하였다.
.env파일에 환경변수를 저장하는 방식이 익숙하지 않아 시행착오가 있었다.공공데이터포털 API 연결 테스트 과정에서 HTTP 500 오류가 발생했는데, 이는 인증키 문제가 아니라 API 엔드포인트(URL)를 지정하지 않고 루트 주소만 호출했기 때문이라는 점을 알게 되었다.
또한 어떤 API가 공개(Public) API이고 어 떤 API가 개별 서비스 엔드포인트를 사용하는지 구분하는 과정이 필요하다는 점을 배웠다.
도움이 필요한 부분
공공데이터포털의 다양한 API 엔드포인트(URL) 구조를 빠르게 파악하고 올바른 호출 경로를 찾는 방법
API 문서를 Codex가 효과적으로 이해할 수 있도록 프롬프트를 작성하여 호출 코드를 자동 생성하는 방법
인증키는 정상적으로 설정되었으나, 아직 실제 API 엔드포인트를 이용한 데이터 호출까지는 완료하지 못한 상태로, API별 문서 해석과 호출 방식에 대한 경험이 더 필요함
앞으로의 계획
공공데이터포털의 다양한 API를 활용하여 데이터를 자동 수집하고, DuckDB와 Polars를 이용한 분석 및 ECharts 기반 대시보드 제작까지 진행해 볼 계획이다. 늦게 시작하여 마감시간이 다가와 현재까지 미완성 과정에 대해 양해 부탁드립니다.
