
상세페이지도 올리고 쿠폰도 돌리는데, 구글이나 AI 검색에서 내 사이트가 어떻게 읽히는지는 한 번도 확인해 보지 못했습니다.
이 레터에서 다루는 것:
- claude-seo가 점검하는 항목과 AI 검색 대응(GEO) 항목이 보는 것
- 설치 세 줄과 파이썬 버전 때문에 막혔다가 푼 과정
- 저희 자료실 점검에서 나온 주요 지적과 자사몰 셀러의 점검 순서
주소 하나로 구글·AI 검색을 점검하는 플러그인
무엇을 점검하나요?
claude-seo는 MIT 라이선스로 공개된 무료 플러그인입니다. 사이트별 요금이나 사용 제한이 없고 클로드 코드만 있으면 됩니다[2]. 주소를 주면 사업 유형을 판별해 항목별로 점검하고 우선순위가 붙은 실행 계획을 마크다운 파일로 남깁니다. SEO는 검색 결과에 사이트가 잘 잡히도록 만드는 작업을 말합니다.
점검 범위는 다섯 갈래입니다. 기술 SEO는 검색엔진이 페이지를 읽고 색인하는 데 문제가 없는지 보고 구글이 보는 로딩 지표인 Core Web Vitals(속도)도 여기서 봅니다. 콘텐츠 신뢰도는 경험·전문성·권위·신뢰를 뜻하는 E-E-A-T 기준입니다. 구조화 데이터는 검색엔진이 읽는 설명 표기인 Schema입니다. AI 검색 대응(GEO)이 있고 마지막이 지역·이커머스 SEO입니다. 전체 점검에는 에이전트가 최대 17개까지 병렬로 일한다고 설명합니다[3].

AI 검색 대응(GEO)은 무엇을 보나요?
GEO는 구글 AI 개요, ChatGPT, Perplexity 같은 AI 답변이 내 페이지를 인용하기 쉬운 구조인지 보는 항목입니다. 공식 설명에 따르면 /seo geo는 페이지가 인용하기 쉬운 정도를 점수로 매기고 AI 크롤러가 접근할 수 있는지 확인하고 위키백과·레딧·유튜브·링크드인에서 브랜드가 얼마나 보이는지도 살펴봅니다[4]. 별도 명령 /seo agentic은 AI 에이전트가 사이트를 쓰기 쉬운지 봅니다. README는 구글이 'AI 검색 최적화도 결국 SEO'라고 한 설명을 들어, 기본 SEO부터 본다고 적었습니다.
설치는 세 줄입니다
클로드 코드 1.0.33 이상에서 아래 세 줄을 차례로 입력합니다.
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup/seo setup은 전용 파이썬 환경과 화면 없는 브라우저를 만듭니다. 이후 /seo doctor로 준비 상태를 확인합니다. 파이썬 3.11~3.14가 필요합니다[5].

설치가 막힌 자리, 파이썬 버전
저희 컴퓨터의 파이썬은 3.9였습니다. /seo setup이 첫 검사에서 멈추면서 3.11~3.14가 필요한데 3.9가 있다는 안내가 나왔습니다. 도구가 해결책을 직접 제안했습니다. 파이썬 버전을 따로 받아 주는 도구 uv로 3.13을 받고 그 경로를 환경 변수 CLAUDE_SEO_PYTHON에 지정하는 방법입니다.
uv python install 3.13
export CLAUDE_SEO_PYTHON="$(uv python find 3.13)"다시 /seo setup을 실행하자 45초 만에 끝났고 /seo doctor가 준비 완료를 알렸습니다. 시스템 파이썬은 건드리지 않았다는 표시도 나왔습니다. 맥에는 파이썬 3.9가 기본으로 깔려 있는 경우가 있어 저희처럼 이 단계에서 막힐 수 있습니다.

저희 자료실을 점검했더니
89.7초 만에 나온 점수 38/100
/seo page https://library.swimmingcode.kr 한 줄을 실행했습니다. 저희 무료 자료실 주소이고, 한 페이지만 보는 명령입니다. 89.7초 만에 영어 보고서가 나왔습니다[6]. 종합 점수는 38/100이었고 항목별로는 페이지 내 SEO 60, 콘텐츠 품질 25, 기술 45, 구조화 데이터 0, 이미지 50이었습니다. 지적은 모두 11개였고 치명 1·높음 3·중간 4·낮음 3으로 나뉘었습니다. 숫자와 지적은 보고서 원문 그대로입니다.

가장 크게 짚은 문제, 크롤러가 받는 화면
브라우저가 보여 주는 화면과 검색 크롤러가 받는 화면은 다를 수 있습니다. 이 글에서는 후자를 크롤러 화면이라고 부르겠습니다. 점검 결과에 따르면 저희 자료실 HTML은 2,001,138바이트이고 98%가 썸네일 이미지 45장을 글자로 적어 넣은 데이터입니다. 안내서 카드 45개는 자바스크립트가 브라우저 안에서 그립니다. 그래서 내려받은 HTML에는 제목 1개, 문장 1개, 링크 4개만 남습니다[7].
점검기는 이 파일이 구글이 읽는 2MB 한도 근처에 있다고 치명 등급으로 올렸습니다. 2MB를 2,097,152바이트로 해석하면 약 96KB 여유가 있을 수도 있다고 함께 적었습니다. 보고서는 또 네이버·빙·대부분의 AI 크롤러가 자바스크립트를 실행하지 않아 이 페이지를 빈 페이지로 본다고 적었습니다. 이 두 가지는 저희가 따로 검증하지 않은 도구의 주장입니다.

우선순위 실행 계획 상위 3개
보고서는 순서를 붙여 실행 계획을 냈습니다. 각 항목에 이유와 됐는지 확인하는 방법이 붙어 있었습니다.
1. 썸네일 45장을 HTML 밖의 이미지 파일로 분리합니다. HTML이 약 2MB에서 약 45KB로 줄어든다고 설명하고 100KB 미만이면 됐다고 봅니다.
2. 카드 45개를 HTML에 직접 넣고 자바스크립트는 필터·검색에만 씁니다. 터미널에서 페이지를 받았을 때 안내서 제목이 보이면 됐다고 봅니다.
3. robots.txt와 sitemap.xml을 추가합니다. 둘 다 열면 404였고 정상 응답하면 됐다고 봅니다.
점검까지만 했고 수정은 하지 않았습니다. 그래서 이 계획대로 하면 점수가 어떻게 바뀌는지는 말씀드릴 수 없습니다.

네이버에 집중한 셀러가 알아둘 점과 자사몰 점검 순서
이 도구가 다루지 않는 것
claude-seo의 README에는 네이버와 한국어 언급이 한 건도 없습니다. 네이버 노출을 점검하려고 만든 도구가 아니라서 스마트스토어나 네이버 블로그가 네이버에서 어떻게 노출되는지는 기대하기 어렵습니다. 한국어 사이트 점검은 저희 자료실 1회 실행에서 동작했고 보고서만 영어였습니다.
자사몰이 있다면 점검 순서
구글·AI 검색은 자사몰(카페24·아임웹 등으로 직접 운영하는 온라인 쇼핑몰)이 가진 또 하나의 입구입니다. 저희 보고서의 순서를 따라 하면 이렇게 됩니다.
1. 대표 페이지 한 곳을 /seo page로 점검합니다. 단일 페이지는 사용량 부담이 작습니다.
2. 치명·높음 등급 지적부터 읽습니다. 크롤러가 받는 화면에 상품 목록이나 설명이 실제로 들어 있는지가 먼저입니다.
3. 수정은 사이트 제작 담당자나 호스팅 설정과 함께 정합니다. 점검 결과만으로 고칠 수 있는 항목과 개발이 필요한 항목이 섞여 있습니다.
4. 여러 페이지를 보고 싶을 때 /seo audit을 씁니다.
사용량과 한계
전체 점검(/seo audit)은 Opus 모델 에이전트 5개가 돌아 단일 페이지보다 클로드 구독 사용량이 많다고 안내합니다[8]. 저희 단일 페이지 점검은 사용량 표시로 약 0.66달러어치였습니다. 구글 API 키를 연결하지 않으면 속도는 실험실 추정치이고 색인 여부는 추정입니다[9].
셀러라면 이렇게
▶ 셀러라면: 자사몰이 있다면 주소 하나로 구글·AI 검색에서 무엇이 부족한지 우선순위 목록을 받아 볼 수 있습니다. 스마트스토어 노출 점검은 이 도구의 대상이 아닙니다.
🔑 핵심
다음 발행에서 또 인사드리겠습니다.
swimmingcode 드림.
이 레터에서 다룬 내용에 대해 궁금한 점이 있으시면 답장으로 알려주세요. 확인해서 답해드립니다.
AI를 내 업무 어디에 붙일지 궁금하면 1분 진단부터 받아 보세요.
각주
- [1] claude-seo 공식 저장소 README (Agrici Daniel) — https://github.com/AgriciDaniel/claude-seo (MIT, 2026년 11월 16일 열람, v2.6.2)
- [2] claude-seo 공식 저장소 README (Agrici Daniel) — https://github.com/AgriciDaniel/claude-seo (MIT, 2026년 11월 16일 열람, v2.6.2)
- [3] claude-seo 공식 저장소 README (Agrici Daniel) — https://github.com/AgriciDaniel/claude-seo (MIT, 2026년 11월 16일 열람, v2.6.2)
- [4] claude-seo 공식 저장소 README (Agrici Daniel) — https://github.com/AgriciDaniel/claude-seo (MIT, 2026년 11월 16일 열람, v2.6.2)
- [5] claude-seo 공식 저장소 README (Agrici Daniel) — https://github.com/AgriciDaniel/claude-seo (MIT, 2026년 11월 16일 열람, v2.6.2)
- [6] 저희 자료실 `/seo page` 실행 결과 원문 (2026년 11월 16일 실행, claude-seo v2.6.2)
- [7] 저희 자료실 `/seo page` 실행 결과 원문 (2026년 11월 16일 실행, claude-seo v2.6.2)
- [8] claude-seo 공식 저장소 README (Agrici Daniel) — https://github.com/AgriciDaniel/claude-seo (MIT, 2026년 11월 16일 열람, v2.6.2)
- [9] claude-seo 공식 저장소 README (Agrici Daniel) — https://github.com/AgriciDaniel/claude-seo (MIT, 2026년 11월 16일 열람, v2.6.2)
의견을 남겨주세요