안티그래비티를 활용한 “네이버 골든키워드 채굴기” CLI 구축하기

소개

팀리더인 박카스님께서 제공한 네이버 골든키워드 채굴기의 기능을 분석하고 GUI 스타일에서 CLI 형태로 수정하고자 했어요. 그 이유는, 

  • 기존 채굴기는 GUI 기반이라 

  • 자동화 파이프라인에 끼워 넣기 어렵고 

  • 반복 실행/배치 작업/다른 도구와의 통합이 불편했어요. 

  • 그래서 목표는 하나! 

  • AI 에이전트(안티그래비티)로 GUI → CLI로 바꾸고, 최종적으로 자동화에 쓰기 

즉, “사람이 클릭하는 도구”에서 “시스템이 호출하는 도구”로 바꾸는 작업이었습니다. 😎 

 진행 방법 

1) AI 에이전트에게 ‘변환 작업’ 요청하기 (프롬프트) 

GUI로 만든 파이썬 파일은, AI 에이전트가 그대로 실행·검증하기가 애매했어요.  
그래서 처음부터 스킬(Skill) 형태로 바꾸는 것을 목표로 잡았습니다. 

아래 프롬프트로 핵심 요구사항을 한 번에 못 박았어요. 
(박카스님께서 알려주신 방법으로 진행한 결과 입니다.) 

@골든키워드채굴기.py 
 
현재 이 파이썬 파일은 GUI 기반이라 네가 실행하기 어려워. 너를 위한 '스킬(Skill)' 형태로 변환하고 싶어. 
 
    CLI 버전 생성: GUI 코드는 제거하고 API 호출 로직만 남겨서 keyword_agent_skill.py로 만들어 줘. 
 
    입출력 변경: argparse를 사용해 --keywords 인자를 받고, 결과는 반드시 JSON 형식으로 print하게 해 줘. 
 
    SKILL.md 작성: 네가 이 도구를 언제 어떻게 써야 하는지 정의한 설명서 파일도 만들어 줘. 

한국어 페이지 스크린샷

 [작업 계획 수립 및 요청] 

[작업 계획 내용]

 2) 골든키워드 채굴기 “CLI 스킬”로 변환 

계획 승인 후,  
본격적으로 GUI 제거 → API 로직 중심 CLI 스크립트로 변환을 진행했습니다. 

한국어 텍스트가 있는 페이지

[스킬 변환 완료 보고] 

휴대전화에 있는 한국어 문자 스크린샷

[완료 내용]

다만 여기서 바로 현실 이슈가 하나 나왔어요. 

  • “변환은 됐는데… 실행 결과를 확실히 확인하기가 애매한데?” 

  • 게다가 저는 결과를 엑셀로 저장해서 바로 공유/분석하고 싶었어요. 

그래서 다음 단계로 넘어갔습니다. 

 

3) 실행 결과를 엑셀 파일로 저장하게 만들기 (문제 해결의 핵심 🔥) 

요구사항을 이렇게 정리해서 기능 추가를 요청했어요. 

아래의 코드를 실행했을 때 최종결과가 엑셀 파일이 생성될 수 있도록 수정해 주세요. 
python d:\Experiment\keyword_agent_skill.py --keywords "캠핑,여행" --max_count 10 

그 결과, - 기본 실행 시에도 파일이 생성되거나 - --output 옵션으로 파일명을 지정할 수 있게 개선했습니다. 

python keyword_agent_skill.py --keywords "캠핑,여행" --output "result.xlsx" 

웹사이트에 있는 한국어 스크린샷

[기능 추가 내용 ]

[실행 최종 결과 파일]

여기서 느낀 포인트는 명확했어요. - 단순히 “코드가 돌아간다”가 아니라, - 결과물이 파일로 남는 순간, 작업이 ’도구’로 완성되더라고요. 😆 

 결과와 배운 점 

✅ 결과 

  • GUI 기반 골든키워드 채굴기를 CLI 스킬 형태로 재구성 

  • argparse 기반 입력 처리로 명령어 실행 가능 

  • 최종 결과를 엑셀 파일로 저장 가능하도록 확장

     

💡 배운 점 / 시행착오 

1) “안 되는 이유”는 의외로 환경이었다 😅 

  • 처음엔 코드 문제라고 생각했는데, 

  • 실제로는 파이썬 미설치 + PATH 설정부터 시간이 꽤 들었어요. 

  • 자동화는 ’코드’만이 아니라, 실행 환경(설치/경로/권한)까지 포함이라는 걸 다시 체감했습니다. 

2) 안티그래비티가 멈추면… 당황하지 말고 재시작 🧯 

  • 안티그래비티에서 
    모델이 너무 오래 진행되거나
    요청에 반응하지 않는 경우가 있었어요. 

  • 이때는
    중지 → 재실행
    그래도 안 되면 안티그래비티 자체 재시작 로 해결되는 경우가 있었습니다. 

3) 리뷰가 깊어질수록 “구조가 보이고, 수정이 쉬워진다” 

  • 전반적인 내용을 수정하는 과정에서
    “이 코드가 어떻게 구성돼 있는지” 
    “어떤 변경이 어디에 영향을 주는지” 를 훨씬 자세히 이해하게 됐어요. 

  • 그리고 최종적으로 파일 생성(엑셀 저장)으로 문제를 해결했을 때, 진짜 속이 뻥 뚫렸습니다. 🎉 

🚀 다음 계획 

  • 이번에는 CLI 변환 + 엑셀 저장까지 만들었으니, 

  • 다음에는 아래까지 확장할 계획입니다.
    배치 실행(스케줄러/크론) 연결
    여러 키워드 세트의 결과를 하나로 합치기
    “마케팅 캡틴”과 함께 완전 자동화 파이프라인으로 통합 

1

뉴스레터 무료 구독

👉 이 게시글도 읽어보세요