claude-seo 설치법: 클로드 코드로 내 사이트 SEO 점검하기
SEO 점검을 대행사에 맡기면 한 번에 수백만 원이 나간다는 얘기, 블로그나 쇼핑몰 하는 분들은 한 번쯤 들어 보셨을 거예요. 그런데 깃허브에서 별 2만 3천 개를 넘긴 무료 도구가 그 점검을 클로드 코드 안에서 10~15분 만에 해 준다고 합니다. 이름은 claude-seo예요.
저도 이 블로그를 직접 운영하다 보니 “검색에 왜 안 걸리지?”를 매일 고민해요. 그래서 공식 저장소 README와 10월 22일 나온 v2.5.0 릴리스 노트를 처음부터 끝까지 읽어 봤습니다. 설치 명령, 실제로 뭘 점검하는지, 돈은 정말 안 드는지, 조심할 점까지 순서대로 적어 볼게요.

claude-seo, 정체가 뭔가요?
claude-seo는 Agrici Daniel이라는 개발자가 만든 클로드 코드용 플러그인이에요. 플러그인 안에 하위 스킬 26개와 전문 에이전트 19개가 들어 있고, 명령어는 기본·확장을 합쳐 30개가 넘습니다. 라이선스는 MIT라서 누구나 무료로 쓸 수 있어요.
2026년 10월 29일 확인 기준으로 깃허브 별은 23.3k, 포크는 3.2k예요. 저장소가 처음 만들어진 게 올해 2월이니 9개월도 안 돼서 이만큼 모인 셈이죠. 최신 버전은 10월 22일 나온 v2.5.0입니다.

README에 적힌 점검 범위는 이렇습니다. 크롤링·색인·사이트맵·robots.txt 같은 기술 SEO, 코어 웹 바이탈(구글이 보는 페이지 속도 지표), E-E-A-T(경험·전문성·권위·신뢰) 같은 콘텐츠 품질, 스키마(검색 결과에 별점·FAQ 등을 띄우는 구조화 데이터), 그리고 요즘 많이들 궁금해하는 AI 검색 노출(GEO)까지요. 구글 AI 개요나 챗GPT·퍼플렉시티·제미나이가 내 페이지를 인용할 가능성을 따져 준다는 게 이 도구가 내세우는 부분이에요.
설치는 명령 3줄
준비물은 클로드 코드 1.0.33 이상과 파이썬 3.11~3.14입니다. v2.5.0부터 파이썬 3.10은 지원하지 않아요. 릴리스 노트에 따르면 3.10이 2026년 10월 1일 지원 종료됐고, 보안 패치가 들어간 Pillow 13.0.0이 3.11 이상을 요구해서라고 합니다. 클로드 코드를 켠 상태에서 아래 세 줄을 차례로 입력하면 돼요.
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

첫 줄은 마켓플레이스(플러그인 목록)를 등록하고, 둘째 줄이 실제 설치예요. 마지막 /seo setup은 claude-seo 전용 파이썬 환경과 헤드리스 브라우저(화면 없이 돌아가는 크롬)를 따로 만들어 줍니다. 공식 설명으로는 다른 시스템 설정은 건드리지 않는다고 하고요. 나중에 /seo doctor를 치면 준비 상태만 확인할 수 있습니다. 플러그인 설치가 처음이라면 예전에 쓴 클로드 코드 공식 플러그인 설치법을 먼저 보시면 흐름이 금방 잡혀요.
한 가지 더. 외부 마켓플레이스 플러그인은 자동 업데이트가 기본으로 꺼져 있어요. 새 버전이 나오면 claude plugin update claude-seo@agricidaniel-claude-seo로 직접 올려야 합니다. 지울 때는 /plugin uninstall claude-seo@agricidaniel-claude-seo예요.
/seo audit 한 줄이면 뭐가 돌아가나
설치가 끝나고 /seo만 입력하면 쓸 수 있는 명령 목록이 뜹니다. 공식 데모 영상에서 이 장면을 그대로 볼 수 있어요.

제일 많이 쓸 건 아무래도 /seo audit 주소일 거예요. README 설명대로라면 순서는 세 단계입니다. 먼저 사이트 종류(SaaS·지역 가게·쇼핑몰·언론/블로그·대행사)를 알아낸 다음, 최대 17개 에이전트가 기술·콘텐츠·스키마·속도·AI 검색을 동시에 나눠 봅니다. 마지막으로 결과에 점수를 매겨 우선순위 순서로 할 일 목록을 만들어 줘요.


다른 명령도 쓸 만한 게 꽤 있어요. 자주 쓸 만한 것만 골라 봤습니다.
| 명령 | 하는 일 |
|---|---|
/seo page 주소 | 페이지 한 장만 깊게 분석 |
/seo technical 주소 | 기술 SEO 9개 분야 점검 |
/seo schema 주소 | 구조화 데이터 찾기·검사·만들기 |
/seo geo 주소 | AI 개요·AI 검색 인용 준비도 |
/seo local 주소 | 구글 비즈니스 프로필·리뷰·지도 노출 |
/seo content-brief 주제 | 새 글 키워드·목차·내부 링크 기획 |
/seo drift baseline 주소 | 현재 상태를 저장해 두고 나중에 바뀐 점 비교 |

결과 보고서는 마크다운 파일로 내 컴퓨터에 저장되고, /seo google report를 쓰면 PDF로도 뽑을 수 있다고 해요. README에는 실제 스키마 점검 보고서 앞부분이 예시로 실려 있는데, JSON-LD 블록 수·치명적 문제·경고·통과 항목·등급(B+)을 표로 보여 주고 “페이지엔 공동 창업자가 있는데 스키마엔 빠져 있다” 같은 식으로 무엇이 왜 문제인지까지 적어 줍니다.
정말 공짜예요? 돈 드는 부분
플러그인 자체는 무료가 맞아요. README FAQ에 “사이트당 요금·사용량 제한·추적 없음”이라고 적혀 있고, API 키도 기본으로는 필요 없습니다. 다만 공짜라는 말을 그대로 믿으면 곤란한 부분이 두 군데 있어요.
첫째, 클로드 코드 요금제 사용량은 꽤 듭니다. 에이전트 19개 중 판단이 많이 필요한 5개는 오퍼스, 나머지는 소네트로 돌아가요. 그래서 전체 점검(/seo audit)은 페이지 하나 점검보다 사용량을 훨씬 많이 쓴다고 제작자가 직접 적어 뒀습니다. 사용량이 빠듯한 요금제라면 /seo page로 중요한 페이지부터 보는 게 낫겠어요.
둘째, 확장 기능 일부는 유료 서비스예요. SE Ranking·Profound 같은 확장은 자기 계정이 있어야 하고, 실측 데이터를 원하면 구글 API(PageSpeed·CrUX·서치콘솔·GA4)를 /seo google setup으로 따로 연결해야 합니다. 구글 API 쪽은 무료예요. 이걸 연결하지 않으면 코어 웹 바이탈은 실측이 아닌 실험실 추정치이고, 색인 여부도 페이지를 보고 짐작하는 수준이라고 README에 한계로 적혀 있어요.

위 그림은 대행사 비용과 비교한 README 그림인데, 제작자 스스로 “예시 가격이고 실제와 다를 수 있다”고 밝혀 둔 숫자라 참고만 하시면 됩니다. 아래 성과 화면도 마찬가지로 제작자 본인 사이트(claude-seo.md)의 결과예요. 출시 첫 12주 서치콘솔 클릭 10.8K, 모바일 PageSpeed 99점이라고 공개했지만, 다른 사이트에서도 같은 결과가 나온다는 보장은 아닙니다.

쓰기 전에 알아 둘 것
데이터가 어디로 가는지부터 볼게요. claude-seo는 클로드 코드 안에서 돌아가니까, 분석하는 페이지 내용은 다른 작업처럼 앤트로픽의 클로드로 전달됩니다. 보고서는 내 컴퓨터에 파일로 남고, 확장이나 API를 직접 연결하지 않는 한 다른 SEO 업체로는 데이터가 가지 않는다고 PRIVACY 문서에 적혀 있어요. 위키백과·레딧·커먼 크롤 같은 공개 자료는 일부 점검에서 읽어 옵니다.
그리고 이건 점검 도구지, 대신 고쳐 주는 도구가 아니에요. 할 일 목록이 나오면 테마·플러그인·서버 설정을 바꾸는 건 결국 운영자 몫입니다. 스크리밍 프로그 같은 전문 크롤러와 비교하면 크롤링 속도·깊이는 그쪽이 낫다고 FAQ에서 제작자도 인정하고 있어요. 대신 왜 문제인지 설명하고, 영향이 큰 순서로 정리하고, 이어서 질문할 수 있다는 게 차이라고 하고요.
눈에 띈 게 하나 있어요. v2.5.0 기술 점검에 “서버 스택 CVE 노출 확인”이 새로 들어갔는데, 첫 항목이 바로 얼마 전 이 블로그에서 다룬 PHP2Shell 취약점(CVE-2026-109618·109619)입니다. 응답 헤더로 PHP·워드프레스 신호만 읽고 공격용 요청은 보내지 않으며, 다른 경로를 보기 전에 사이트 주인인지 먼저 묻는다고 해요. 고쳐진 버전(8.3.36 등)보다 낮으면 ‘높음’으로 표시합니다.
누구한테 맞을까

제작자가 꼽은 대상은 SEO 대행사, 사내 SEO 팀, 프리랜서 컨설턴트예요. 그런데 README 내용을 쭉 읽어 보면 블로그나 작은 쇼핑몰을 직접 굴리는 사람한테도 쓸모가 있어 보입니다. 특히 /seo local은 지역 가게용 점검이라 동네 장사하는 분들이 눈여겨볼 만하고요.
개인적으로는 점검 결과를 그대로 다 따르기보다 ‘치명적’·’높음’으로 나온 것부터 하나씩 손보는 용도가 맞다고 봐요. 다만 한국 사이트라면 네이버 검색은 점검 대상에 따로 없다는 점(IndexNow 제출 대상에 네이버가 들어 있는 정도)은 감안해야 합니다. 저는 이 Bucom Blog에 /seo page부터 한 번 돌려 보고, 실제로 뭐가 잡히는지 후기로 정리해 볼 생각이에요. 여러분은 내 사이트에서 제일 먼저 확인해 보고 싶은 게 속도인가요, AI 검색 노출인가요?
출처
· AgriciDaniel/claude-seo 깃허브 저장소·README
· claude-seo v2.5.0 릴리스 노트
· claude-seo PRIVACY 문서
· claude-seo 공식 사이트
· claude-seo 공식 데모 영상(유튜브)
(2026년 10월 29일 확인)
컴퓨터가 고장 났다면 부산 컴퓨터수리 · 출장수리 부컴에 맡겨 주세요. 부산·울산·김해·양산 어디든 직접 방문합니다.
