claude-seo 설치법: 클로드 코드로 내 사이트 SEO 점검하기

claude-seo 공식 사이트 'YOUR SEO TEAM IN THE TERMINAL' 위에 'claude-seo 설치법' 제목

SEO 점검을 대행사에 맡기면 한 번에 수백만 원이 나간다는 얘기, 블로그나 쇼핑몰 하는 분들은 한 번쯤 들어 보셨을 거예요. 그런데 깃허브에서 별 2만 3천 개를 넘긴 무료 도구가 그 점검을 클로드 코드 안에서 10~15분 만에 해 준다고 합니다. 이름은 claude-seo예요.

저도 이 블로그를 직접 운영하다 보니 “검색에 왜 안 걸리지?”를 매일 고민해요. 그래서 공식 저장소 README와 10월 22일 나온 v2.5.0 릴리스 노트를 처음부터 끝까지 읽어 봤습니다. 설치 명령, 실제로 뭘 점검하는지, 돈은 정말 안 드는지, 조심할 점까지 순서대로 적어 볼게요.

claude-seo 공식 사이트 첫 화면, v2.5.0 무료 오픈소스 MIT 표시
v2.5.0 · 무료 · MIT · 출처: claude-seo 공식 사이트

claude-seo, 정체가 뭔가요?

claude-seo는 Agrici Daniel이라는 개발자가 만든 클로드 코드용 플러그인이에요. 플러그인 안에 하위 스킬 26개와 전문 에이전트 19개가 들어 있고, 명령어는 기본·확장을 합쳐 30개가 넘습니다. 라이선스는 MIT라서 누구나 무료로 쓸 수 있어요.

2026년 10월 29일 확인 기준으로 깃허브 별은 23.3k, 포크는 3.2k예요. 저장소가 처음 만들어진 게 올해 2월이니 9개월도 안 돼서 이만큼 모인 셈이죠. 최신 버전은 10월 22일 나온 v2.5.0입니다.

AgriciDaniel/claude-seo 깃허브 저장소 첫 화면
별 23.3k · 포크 3.2k · 출처: claude-seo 깃허브

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
claude-seo 설치 명령 3줄이 적힌 터미널 그림
설치는 명령 3줄 · 출처: claude-seo 공식 README

첫 줄은 마켓플레이스(플러그인 목록)를 등록하고, 둘째 줄이 실제 설치예요. 마지막 /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 를 입력하자 나온 SEO 명령 목록 화면
/seo 를 치면 나오는 명령 목록 · 출처: claude-seo 공식 데모

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

/seo audit 실행 후 할 일 목록을 만드는 클로드 코드 화면
사이트 종류 파악 후 에이전트 동시 점검 · 출처: claude-seo 공식 데모
claude-seo 전문 에이전트 19개를 소개하는 그림, seo-geo 에이전트
에이전트 19개, 최대 17개 동시 실행 · 출처: claude-seo 공식 README

다른 명령도 쓸 만한 게 꽤 있어요. 자주 쓸 만한 것만 골라 봤습니다.

명령하는 일
/seo page 주소페이지 한 장만 깊게 분석
/seo technical 주소기술 SEO 9개 분야 점검
/seo schema 주소구조화 데이터 찾기·검사·만들기
/seo geo 주소AI 개요·AI 검색 인용 준비도
/seo local 주소구글 비즈니스 프로필·리뷰·지도 노출
/seo content-brief 주제새 글 키워드·목차·내부 링크 기획
/seo drift baseline 주소현재 상태를 저장해 두고 나중에 바뀐 점 비교
claude-seo 명령 30개를 6개 묶음으로 보여 주는 지도 그림
명령 30개, 6개 묶음 · 출처: claude-seo 공식 README

결과 보고서는 마크다운 파일로 내 컴퓨터에 저장되고, /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에 한계로 적혀 있어요.

대행사 SEO 비용과 claude-seo 무료를 비교한 그림
제작자 예시 가격 · 출처: claude-seo 공식 README

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

제작자 사이트의 서치콘솔 클릭 10.8K와 PageSpeed 99점 화면
제작자 공개 결과(첫 12주) · 출처: claude-seo 공식 README

쓰기 전에 알아 둘 것

데이터가 어디로 가는지부터 볼게요. claude-seo는 클로드 코드 안에서 돌아가니까, 분석하는 페이지 내용은 다른 작업처럼 앤트로픽의 클로드로 전달됩니다. 보고서는 내 컴퓨터에 파일로 남고, 확장이나 API를 직접 연결하지 않는 한 다른 SEO 업체로는 데이터가 가지 않는다고 PRIVACY 문서에 적혀 있어요. 위키백과·레딧·커먼 크롤 같은 공개 자료는 일부 점검에서 읽어 옵니다.

그리고 이건 점검 도구지, 대신 고쳐 주는 도구가 아니에요. 할 일 목록이 나오면 테마·플러그인·서버 설정을 바꾸는 건 결국 운영자 몫입니다. 스크리밍 프로그 같은 전문 크롤러와 비교하면 크롤링 속도·깊이는 그쪽이 낫다고 FAQ에서 제작자도 인정하고 있어요. 대신 왜 문제인지 설명하고, 영향이 큰 순서로 정리하고, 이어서 질문할 수 있다는 게 차이라고 하고요.

눈에 띈 게 하나 있어요. v2.5.0 기술 점검에 “서버 스택 CVE 노출 확인”이 새로 들어갔는데, 첫 항목이 바로 얼마 전 이 블로그에서 다룬 PHP2Shell 취약점(CVE-2026-109618·109619)입니다. 응답 헤더로 PHP·워드프레스 신호만 읽고 공격용 요청은 보내지 않으며, 다른 경로를 보기 전에 사이트 주인인지 먼저 묻는다고 해요. 고쳐진 버전(8.3.36 등)보다 낮으면 ‘높음’으로 표시합니다.

누구한테 맞을까

claude-seo 설치·명령·비용·API 키·보고서 요약표
claude-seo 한눈에 보기 · 출처: claude-seo 공식 README

제작자가 꼽은 대상은 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일 확인)

컴퓨터가 고장 났다면 부산 컴퓨터수리 · 출장수리 부컴에 맡겨 주세요. 부산·울산·김해·양산 어디든 직접 방문합니다.

함께 보면 좋은 글

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다