이슈
Ahrefs에서는 Ahrefs bot을 보내서 SEO에 대한 문제가 있는지 확인하는 Site Audit를 제공합니다. 그런데 Ahrefs bot은 구글에서 순위를 매기는 Google Bot과는 다르기 때문에, Ahrefs bot이 발견한 문제가 구글에서도 동일하기 발생하는지 확인하는 과정을 거쳐야 합니다.
Ahrefs에서 확인한 이슈가 구글 서치 콘솔, Page Speed에서 문제가 발생하는지 확인하는 것이 핵심이며, 지피터스에서는 이를 매주 진행합니다. 이를 ClaudeCode로 자동화하는 것을 진행해보았습니다.
ClaudeCode의 작동 방식
ClaudeCode는 일반적으로 문제가 주어지면 (1) 사용할 수 있는 툴을 고려해서 계획을 세우고 (2) 문제를 해결합니다.
이번 문제 상황에서는 Ahrefs 결과물이 구글에서도 문제가 있는지 확인하는 것이 필수적이므로 이를 ClaudeCode에게 제공할 툴로 만드는 것을 우선 만들어야겠다고 판단했습니다.
즉, Ahrefs Site Audit에 대한 이슈가 구글에서도 동일하게 발생하는 문제인지 확인하는 과정이 필요하기에, 링크 하나를 입력하면 구글 봇이 보기에 SEO 문제가 있는지 확인하는 툴(일종의 API)를 만들기로 했습니다.
ClaudeCode로 SEO 보고서 자동화
1. 단일 게시글 SEO 피드백
소유 권한이 있는 gpters.org 게시글 링크를 입력하면, 해당 게시글에 대한 SEO 피드백을 해주는 API를 만들고자 했습니다. 최대한 구글 봇과 동일한 환경에서 SEO를 만들기 위해 얻을 수 있는 데이터를 나열해 GPT-5에게 정보를 전달했습니다.
Google Search Console (GSC) URL Inspection API
PageSpeed Insights API
javascript 실행 후 랜더링 된 HTML
서버 응답 HTML 원본
확인해야 하는 SEO 이슈 리스트 전달
AI를 사용할 때 Input과 Output를 제대로 전달하는 것이 중요합니다. SEO의 경우 확인해야 하는 이슈 리스트가 어느정도 정리된 편입니다. SEO를 가장 잘한다고 생각하는 Ahrefs와 Moz에서 확인하는 이슈 리스트를 챗GPT에게 전달하고 이를 기반으로 점검해야 할 SEO 리스트 를 알려달라고 요청했습니다.
이후 희망하는 결과값의 형태도 챗GPT에게 전달했습니다.
PRD 작성
이후 챗GPT에게 이제까지 대화를 기반으로 PRD 문서를 작성해달라고 요청했습니다. 그 리고 GPT-5에게 PRD 문서에 대해서 잘 이해가 안되는 부분을 질문하면서 PRD 문서를 이해하고, 빠진 부분을 채워나갔습니다.
ClaudeCode에게 제공할 프롬프트로 제공
ClaudeCode에게 PRD를 제공해 만들어달라고 요청할 경우, 문제가 발생하면 어디서 발생하는지 모르는 문제가 존재합니다. 이 문제를 해결하기 위해서 ClaudeCode에게 검증 가능한 단위로 프롬프트를 나열해달라고 요청했습니다.
사용한 프롬프트:
PRD를 ClaudeCode에게 입력해, ClaudeCode가 만들고자 하는 서비스의 맥락을 파악하게 한 후 ClaudeCode에 프롬프트를 입력해서 서비스를 만들어 나가고자 합니다. PRD를 참고해서, 입력해야 하는 프롬프트를 기능 검증이 가능한 단위로 순차적으로 알려주세요.
챗GPT는 ClaudeCode에 넣어야 할 프롬프트를 알려주었고, 이를 기반으로 차근차근 만들고자 하는 API를 만들 수 있었습니다.
이제, ClaudeCode에게 지피터스 게시글 링크를 입력하면, (1) Google Search Console (GSC) URL Inspection API (2) PageSpeed Insights API (3) javascript 실행 후 랜더링 된 HTML (4) 서버 응답 HTML 원본를 고려해 SEO 리포트를 남겨줍니다.
2. Ahrefs SiteAudit에 대한 SEO 보고서 작성
Ahrefs에서는 Site Audit 결과를 Export할 수 있는 기능이 존재하는데 이를 Input으로 넣어 보고서를 작성해주는 로직을 생각했습니다.
Ahrefs SiteAudit에서 뽑힌 이슈 리스트를 단일 게시글 SEO 피드백 API를 확인해 실제 문제인지 확인하는 로직입니다.
ClaudeCode Subagents 활용
ClaudeCode에는 Subagents 기능이 존재합니다. 해야 할 일을 알려주면 ClaudeCode Agent가 알아서 문제를 해결해주는 기능입니다. 이걸 활용하기 위해서는 Agent가 어떻게 움직여야 하는지 알려주는 MD파일을 만들어야 합니다.
만들고자 하는 아이디어와 더불어 최대한 많은 맥락 (e.g, API MD 파일, ClaudeCode Subagents 자료)를 첨부해 어떻게 작동하는지에 대한 MD파일을 만들어달라고 gpt-5에게 요청했습니다.
ClaudeCode에서 /agents를 이용해 gpt-5에 결과물을 복사 붙여넣기해 Agent를 만들었습니다.
작동 확인
ClaudeCode에게 Ahrefs Site Audit를 통해 얻은 CSV를 제공하고 이를 기반으로 리포터를 작성해달라고 요청했습니다. ClaudeCode는 모든 CSV 파일을 확인하고 이에 대한 보고서를 작성했습니다.
아직은 불완전하지만, 매번 직접 확인해야 했는 과정을 ClaudeCod로 자동화할 수 있게 되었습니다.
이것만은 배워가기
전체를 자동화하기 위해서 AI Agent가 사용해야 할 툴이 있으면, 이를 ClaudeCode로 같이 만들기
만들고자 하는 기능을 ClaudeCode에서 검증할 수 있도록 ChatGPT에게 검증 가능한 단위로 ClaudeCode에게 넣을 프롬프트를 알려달라고 하기