기존에 파이썬(customtkinter)으로 개발하여 사용하던 '네이버 골든키워드 채굴기(GUI 버전)'를 구글의 새로운 AI 개발 환경인 '안티그래비티(Antigravity)'에서 AI 에이전트가 직접 사용할 수 있는 '스킬(Skill)' 형태로 변환하고자 했습니다.
매번 프로그램을 실행해서 버튼을 누르는 대신, AI 에이전트에게 "스마트스토어 관련 키워드 분석해줘"라고 자연어로 명령하면 AI가 알아서 도구를 실행하고 결과를 가져오게 만드는 '마케팅 자동화 커맨드센터'를 구축하는 것이 목표였습니다.
진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
도구: Google Antigravity (VS Code 기반), Python, 네이버 검색광고 API
핵심 전략: 기존 GUI 코드에서 '껍데기(화면)'를 벗겨내고, AI가 터미널에서 실행할 수 있는 'CLI(Command Line Interface)' 버전으로 재구축했습니다.
1. 폴더 구조 최적화 (필수 선행 작업)
가장 먼저 AI가 경로를 인식할 때 오류가 나지 않도록 폴더명에서 공백을 제거했습니다.
기존:
D:\2nd week\→ 변경:D:\2nd_week\
2. AI 에이전트에게 코드 변환 요청 (프롬프트)
기존 GUI 코드를 AI가 사용할 수 있는 스크립트로 변환하기 위해 다음과 같은 프롬프트를 사용했습니다.
[사용 프롬프트]
"@골든키워드채굴기.py
현재 이 파이썬 파일은 GUI 기반이라 네가 실행하기 어려워. 너를 위한 '스킬(Skill)' 형태로 변환하고 싶어.
CLI 버전 생성: GUI 코드는 제거하고 API 호출 로직만 남겨서
keyword_agent_skill.py로 만들어 줘.입출력 변경:
argparse를 사용해--keywords인자를 받고, 결과는 반드시 JSON 형식으로SKILL.md 작성: 네가 이 도구를 언제 어떻게 써야 하는지 정의한 설명서 파일도 만들어 줘."
3. 스킬 정의 파일 (SKILL.md) 작성
AI가 이 도구를 인식할 수 있도록 .agent/skills/golden-keyword/ 폴더에 SKILL.md를 정의했습니다.
Markdown
# Skill: Golden Keyword Miner
## Description
사용자가 특정 주제에 대한 키워드 분석 및 경쟁률 확인을 요청할 때 사용합니다.
## Usage
### 명령어 예시
python .agent/skills/golden-keyword/keyword_agent_skill.py --keywords "제주도 여행" --limit 50
## Output format
결과는 JSON 형식으로 출력됩니다. (키워드, 검색량, 문서수, 경쟁률 포함)
결과와 배운 점
배운 점과 나만의 꿀팁을 알려주세요.
스킬(Skill) 방식의 효율성: 매번 프롬프트에 긴 코드를 붙여넣는 것보다, 기능을 파일로 쪼개서(
SKILL.md+.py) 저장해 두니 AI의 기억 용량(Context)도 아끼고 실행 속도도 훨씬 빨라졌습니다.구조의 모듈화: '핵심 로직(뇌)'은 공유하되, 사람용 'GUI(얼굴)'와 AI용 'CLI(얼굴)'를 따로 만드는 투 트랙 전략이 유지보수에 유리하다는 것을 배웠습니다. 이로써 배포용 EXE 프로그램 제작과 AI 자동화를 동시에 잡을 수 있게 되었습니다.
JSON의 중요성: AI 에이전트와 소통할 때는 줄글보다 JSON 데이터로 결과를 출력해 주는 것이 훨씬 정확도가 높습니다.
과정 중에 어떤 시행착오를 겪었나요?
폴더명의 공백 문제: 폴더 이름에 띄어쓰기(
2nd week)가 있으면 AI가 터미널 명령어를 입력하다가 경로를 못 찾고 무한 로딩에 걸리는 현상을 겪었습니다. 개발 폴더명에는 공백 대신 언더바(_)를 써야 한다는 기본을 다시 확인했습니다.설정 파일 위치: 스크립트는 하위 폴더에 있지만, AI는 최상위 폴더에서 명령을 실행하므로
config.json파일을 최상위 경로(D:\2nd_week)에 복사해 두어야 에러가 나지 않았습니다.
앞으로의 계획
이제 '키워드 채굴' 스킬이 완성되었으니, 다음 단계로는 '블로그 글 초안 작성 스킬'과 '이미지 생성 스킬'을 추가하여, 키워드 발굴부터 포스팅 생성까지 한 번에 이어지는 완전 자동화 워크플로우를 만들 계획입니다.
