Claude SEO 사용법 - 내 사이트 점검했더니 59점 나왔다

SEO는 늘 나중으로 미루는 일이었다. 만드는 게 우선이고 검색은 그다음이었다.

그러다 Claude SEO를 봤다. Claude Code에 붙이는 오픈소스 SEO 스킬이다.

설치하고 내가 만든 사이트에 돌려봤더니 59점이 나왔다.

점수보다 리포트가 인상적이었다. 뭐가 문제인지, 왜 문제인지, 어떻게 확인하는지까지 적혀 있었다.

 

이런 리포트가 PDF로 자동 생성된다. 그래서 툴 자체를 좀 뜯어봤다.

 

---

1. Claude SEO

AgriciDaniel/claude-seo. MIT 라이선스에 스타 15,100개다.

Claude Code에 /seo 명령어를 붙여주는 스킬이다.

쉽게 말해 SEO 컨설턴트를 터미널에 앉혀두는 것이다. 사이트 주소만 던지면 알아서 뜯어본다.

 

구성이 꽤 크다. 서브스킬 25개, 전문 에이전트 18개가 들어 있다.

기술 SEO, 콘텐츠 품질, 스키마 마크업, AI 검색, 로컬 SEO, 이커머스, 다국어로 나눠져 있다.

전체 감사를 돌리면 에이전트 15개가 동시에 붙는다. 몇 시간 걸릴 일이 10~15분에 끝난다.

 

Codex를 쓴다면 같은 저자가 만든 codex-seo가 따로 있다.

 

---

2. 설치

Claude Code 1.0.33 이상이면 플러그인으로 넣는 게 제일 빠르다.

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

마지막 /seo setup이 중요하다. 격리된 파이썬 환경과 Playwright Chromium을 따로 깔아준다.

제대로 깔렸는지는 /seo doctor로 확인한다.

 

필요한 건 파이썬 3.10 이상과 Claude Code CLI뿐이다.

 

---

3. 명령어

명령어가 32개나 되는데 처음엔 이거 하나면 된다.

/seo audit https://example.com

자주 쓸 만한 것만 추리면 이 정도다.

명령어	하는 일
/seo audit	사이트 전체 감사
/seo page	한 페이지 깊게 파기
/seo technical	기술 SEO 9개 항목
/seo content	콘텐츠 품질과 E-E-A-T
/seo schema	구조화 데이터 검사·생성
/seo geo	AI 검색 최적화
/seo sitemap	사이트맵 분석·생성
/seo images	이미지 최적화
/seo cluster	키워드 의미 클러스터링
/seo drift	변화 추적 (스냅샷 비교)

이 외에 로컬 SEO, 백링크, 이커머스, 다국어 hreflang까지 있다.

 

---

4. 진단 항목

점검 항목이 많아서 주요한 것만 정리한다.

 

Core Web Vitals

LCP(2.5초), INP(200ms), CLS(0.1) 세 가지를 잰다.

FID는 아예 참조하지 않는다. 2024년에 INP로 대체되고 크롬 도구에서 빠졌기 때문이다.

실측은 CrUX에서 가져오고, 없으면 PageSpeed Insights의 실험실 값으로 떨어진다.

LCP는 TTFB, 로드 지연, 로드 시간, 렌더 지연으로 쪼개서 병목이 어딘지 짚어준다.

 

E-E-A-T

구글 검색 품질 평가 가이드라인 기준으로 본다. 2025년 9월 개정판을 쓴다.

경험은 직접 찍은 사진과 사례, 전문성은 저자 이력, 권위는 외부 인용, 신뢰는 연락처와 날짜 표기다.

네 개 중 신뢰 비중이 가장 크다고 명시돼 있다.

AI로 쓴 글 자체는 문제 삼지 않는다. 다만 저품질 페이지를 대량 찍어내는 건 스팸으로 잡는다.

 

스키마

JSON-LD 기준으로 검사하고 없으면 만들어준다.

HowTo, SpecialAnnouncement, ClaimReview는 이미 폐기된 타입이다.

FAQPage도 2026년 5월부터 리치 결과가 사라졌다. 넣어도 구글에서 얻는 게 없다.

 

AI 검색

구글 AI 최적화 가이드를 따른다. 여기서 AEO와 GEO는 SEO를 다시 이름 붙인 것이라고 못박는다.

AI 개요든 AI 모드든 결국 같은 랭킹 시스템을 쓰기 때문이다.

그래서 134~167단어짜리 자립형 답변 블록을 만들었는지를 점수로 잰다.

 

저자가 널리 퍼진 통념 세 개를 반박한다.

• llms.txt는 지금 인용에 도움이 안 된다 — 근거 문서까지 따로 붙여놨다
• 콘텐츠를 잘게 쪼갤 필요 없다
• AI용으로 키워드를 다시 쓸 필요 없다 — 동의어는 이미 이해한다

 

---

5. 리포트와 구글 API

결과는 마크다운, PDF, JSON으로 나온다. 전부 내 컴퓨터에 파일로 떨어진다.

PDF는 WeasyPrint로 A4 레이아웃을 잡고 그래프는 200DPI로 그린다. 위 리포트가 그렇게 나온 거다.

 

구글 API는 4단계로 나눠져 있다. 키 없이 시작해서 필요한 만큼 붙이면 된다.

단계	필요한 것	열리는 데이터
0	API 키	PageSpeed, CrUX, 25주 추이
1	+ OAuth	서치콘솔, 색인 API
2	+ GA4 설정	유입, 랜딩페이지, 기기·국가
3	+ 애즈 토큰	키워드 검색량과 경쟁도

설정은 /seo google setup 마법사로 한다.

자격증명은 ~/.config/claude-seo/에 권한 600으로 저장된다. 저장소에는 안 들어간다.

 

네이버를 쓴다면 반가운 것도 있다. v2에 IndexNow 제출기가 들어갔는데 빙, 얀덱스와 함께 네이버도 지원한다.

 

---

6. 기존 툴과 비교

README에 비교표가 있는데, 두 가지가 눈에 띄었다.

 

첫째, 데이터가 밖으로 안 나간다.

기본값이 완전 로컬이다. 무료 티어는 외부 API를 아예 안 부른다.

상용 툴은 사이트를 벤더 서버에 올려야 하고 대행사는 아예 넘겨야 한다. 이쪽은 내 컴퓨터에서 끝난다.

 

둘째, 지적마다 "틀렸는지 확인하는 법"이 붙는다.

그냥 "이거 고쳐라"가 아니라 근거와 검증 방법을 같이 준다.

실패했는지 어떻게 알 수 있는지, 뭘 선행 지표로 볼지까지 적어준다.

 

그리고 기준을 내가 고칠 수 있다. SKILL.md를 직접 수정하면 된다.

상용 툴처럼 벤더가 정한 점수 기준에 끌려다니지 않아도 된다.

 

---

7. 한계

저자가 한계를 두 개 명시해뒀다.

 

SPA는 완벽하지 않다.

v2에서 Next.js, React, Vue, Nuxt를 자동 감지해 Playwright로 넘기도록 바뀌긴 했다.

그래도 스크롤이나 클릭 후에 뜨는 콘텐츠는 놓칠 수 있다. 이럴 땐 seo-visual 에이전트를 직접 부르라고 안내한다.

 

무료로 쓰면 실측 데이터가 없다.

Google API 키를 안 붙이면 Core Web Vitals가 실험실 추정치다.

색인 상태도 페이지 신호로 추측하는 수준이다.

 

비교표에 나오는 비용 절감 수치는 저자가 잡은 가정이다. 검증된 값은 아니다.

 

---

마무리

정리하면 이렇다.

• Claude Code에 붙이는 오픈소스 SEO 스킬, MIT
• 설치 세 줄이면 끝난다
• 기본이 로컬이라 사이트를 외부에 안 올려도 된다
• 폐기된 스키마나 FID 같은 옛날 정보를 안 쓴다
• 무료 티어는 실측 데이터가 없다는 걸 감안해야 한다

SEO 툴은 대부분 구독제고 데이터를 벤더에 넘겨야 한다.

이건 깔면 끝이고 결과물이 내 폴더에 남는다.

일단 리포트에서 지적받은 것부터 고치고 다시 돌려볼 생각이다!

 

---

참고 자료

• claude-seo GitHub
• claude-seo 공식 사이트
• codex-seo (Codex용)
• Google AI 최적화 가이드