Codex와 함께 완성한 키워드 채굴기 오류 해결 사례 🛠️✨

Codex와 함께 완성한 키워드 채굴기 오류 해결 사례 🛠️✨

소개

스터디장님이 공유해주신 키워드 채굴용 파이썬 파일을 실행해보면서 작업을 시작했다.
처음엔 단순 실행만 하면 될 줄 알았지만, 실제로는 각종 오류와 환경 문제로 인해 한 번에 되지 않았다.

결과적으로는 Codex와 함께 오류를 하나씩 추적하고 수정하며, 단순 실행 실패 상태의 파일을
👉 실제로 키워드 채굴이 가능한 프로그램으로 완성하게 되었다.


진행 방법

아래는 실제로 겪었던 오류와 해결 과정을 시간 흐름에 따라 정리한 내용입니.

1️⃣ 실행 실패 – customtkinter 모듈 없음

  • 증상: 프로그램 실행 시 ModuleNotFoundError: customtkinter

  • 원인: GUI 라이브러리 미설치

  • 해결 방법:

pip install customtkinter

2️⃣ 골든키워드채굴기 대신 블로그 분석기 실행

  • 증상: 실행은 되지만 전혀 다른 프로그램 창이 뜸

  • 원인: 골든키워드채굴기.py__main__에서 잘못된 클래스 실행

  • 해결 방법:

if __name__ == "__main__":
    KeywordApp()

3️⃣ 키워드 결과 0 / 진행상황 0/0

  • 증상: 프로그램은 정상 실행되지만 결과가 전혀 나오지 않음

  • 원인: 네이버 검색광고 API 베이스 URL 오류

  • 해결 방법:

https://api.naver.com ❌
https://api.searchad.naver.com ⭕

4️⃣ ProxyError 발생

  • 증상: API 호출 시 프록시 연결 오류 발생

  • 원인: 시스템 프록시 설정을 requests가 자동 적용

  • 해결 방법:

session = requests.Session()
session.trust_env = False
  • API 호출을 self.http.get() 방식으로 통일


5️⃣ 다른 버전 실행 시 모듈 없음 오류

  • 대상: 마케팅 캡틴_키워드추가완성버전

  • 원인: 가상환경(venv)에 라이브러리 미설치 + 전역 파이썬 실행

  • 해결 방법:

pip install ttkbootstrap google-genai openpyxl
  • 실행 파이썬 명확히 지정:

venv\Scripts\python.exe

6️⃣ API 요청이 여전히 api.naver.com으로 나감

  • 원인: 다른 파일에 동일한 베이스 URL 하드코딩

  • 해결 방법:

    • 해당 파일에서도 api.searchad.naver.com으로 수정

    • 프록시 무시 Session 로직 동일 적용


7️⃣ 프로그램 창이 뜨지 않는 문제

  • 증상: 실행 시 아무 창도 뜨지 않음

  • 원인: 콘솔 출력 중 UnicodeEncodeError (cp949) 발생 → 스레드 종료

  • 해결 방법:

    • log_mine() 함수에 안전 출력 처리 추가

    • _safe_print() 적용하여 출력 오류 방지


결과와 배운 점

  • 단순 실행 문제가 아니라 환경 / API / 네트워크 / 인코딩이 얽힌 복합 이슈였음

  • Codex를 활용해:

    • 오류 원인 추적 속도가 빨라졌고

    • "왜 안 되는지"를 이해하며 수정 가능

  • 결과적으로 키워드 채굴이 정상 동작하는 상태까지 완성 🎯

이번 경험을 통해 느낀 점은,

❝ 코드가 안 될 때는 당황하기보다, 하나씩 분해해서 보면 반드시 길이 보인다 ❞

특히 Codex는 디버깅 파트너로서 꽤 든든했다 💪

한국 마케팅 캡틴의 스크린샷

마침내 키워드 채굴에 성공한것입니다


1

뉴스레터 무료 구독

👉 이 게시글도 읽어보세요