Claude SEO는 공개 페이지의 제목, 본문, 검색 설정을 점검하는 Claude Code용 오픈소스 플러그인입니다. 페이지에서 확인할 수 있는 값부터 살펴보고, 저장소에서 수정할 곳을 찾을 때는 Codex를 쓸 수 있습니다. 11월 11일 Park Labs의 BrickQuest 수상 글 세 언어판을 예로, 공개 HTML과 사이트맵을 직접 대조했습니다.
먼저 페이지 하나 고르기
전체 사이트를 훑기 전에, 검색으로 들어온 사람이 뭘 하려는지 말할 수 있는 페이지 하나를 고릅니다. BrickQuest 수상 노트라면 독자가 먼저 알고 싶은 건 어느 대회에서 어떤 상을 받았는지입니다. 제목과 첫 문단에 대회명과 결과가 있는지 살피고, 직접 써 보고 싶은 사람이 서비스로 이동할 수 있는지도 봅니다. 제품을 찾는 사람과 대회 결과를 찾는 사람이 같은 페이지를 원한다고 가정하면 제목에서 어떤 정보를 먼저 줄지 정하기 어려워집니다.
Claude SEO 설치와 첫 점검
처음 쓴다면 Claude Code를 열고 아래 명령을 한 줄씩 실행합니다. 설정이 끝나면 /seo doctor로 준비 상태를 볼 수 있습니다. Claude SEO 설치 안내
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup준비가 되면 아래처럼 한 글에서 시작합니다. Park Labs 사례의 관측값은 Codex로 가져온 HTML과 사이트맵에서 읽었습니다.
/seo page https://park-labs.com/ko/notes/020/
/seo hreflang https://park-labs.com/ko/notes/020/첫 명령으로 제목, 본문, 페이지 설정을 살펴봅니다. 두 번째는 번역본 연결을 따라갈 때 씁니다. 여러 글에서 같은 문제가 반복되면 /seo audit로 범위를 넓혀 봅니다. 수정 전후를 남겨 둘 때는 같은 URL에 /seo drift baseline과 /seo drift compare를 차례로 쓸 수 있습니다. Claude SEO 명령어 문서
세 언어 페이지에서 읽은 값
canonical은 검색엔진에 대표 주소를 제안하는 태그입니다. hreflang은 같은 글의 언어별 주소를 연결합니다. 한국어 페이지에서 영어 페이지를 가리킨다면 영어 페이지에서도 한국어 페이지를 가리켜야 합니다. Google은 각 번역본이 자기 자신도 목록에 포함하도록 안내합니다. Google의 다국어 페이지 안내
Table 1 · 11월 11일 공개 HTML과 사이트맵에서 확인한 BrickQuest 노트
| 페이지 | HTML의 대표 주소 | HTML의 언어 연결 | 사이트맵 |
|---|---|---|---|
| 한국어 | /ko/notes/020/ | ko, en, ja | 포함 |
| 영어 | /en/notes/020/ | ko, en, ja | 포함 |
| 일본어 | /ja/notes/020/ | ko, en, ja | 포함 |
세 주소가 모두 200으로 응답했고, 각 페이지는 자기 주소를 대표로 제시했습니다. 실제로 Google이 어떤 주소를 대표로 골랐는지 보려면 Search Console의 URL 검사에서 색인된 버전을 엽니다. 지금 배포된 페이지는 같은 도구의 실시간 테스트로 확인합니다. Google Search Console URL 검사
Codex에 넘기는 점검 요청
아래 요청은 사이트의 저장소를 열어 둔 상태에서 사용합니다. AI가 경고를 내면 URL과 실제 값을 같이 받아야 수정할지 판단할 수 있습니다.
내 사이트의 아래 세 공개 페이지와 sitemap.xml을 읽기 전용으로 점검해 줘.
https://park-labs.com/ko/notes/020/
https://park-labs.com/en/notes/020/
https://park-labs.com/ja/notes/020/
각 URL의 응답 상태, HTML lang, title, robots 지시, canonical,
hreflang의 실제 대상과 왕복 연결, 사이트맵 포함 여부를 표로 보여 줘.
문제가 있으면 관측값과 기대값, 근거 URL, 수정할 소스 위치를 적어 줘.
공개 HTML에서 확인할 수 없는 색인 상태는 미확인으로 표시해 줘.
파일을 바꾸기 전에 결과부터 보여 줘.세 페이지가 전부 엉뚱한 대표 주소를 내보낸다면, 번역 글을 세 번 고치기 전에 공통 메타데이터 생성 코드를 먼저 찾습니다. 반대로 한국어 제목에만 대회명이 빠졌다면 그 글의 제목부터 바꿉니다. Park Labs는 수정 뒤 pnpm check로 정적 내보내기를 검사하고, 배포 후 같은 공개 URL에서 값이 바뀌었는지 다시 읽습니다.
%% 페이지 하나를 고른 뒤 수정과 배포를 검증하는 순서 · Park Labs 점검 흐름
flowchart TD
A["독자의 질문과 URL 선택"] --> B["AI로 점검 후보 찾기"]
B --> C["공개 HTML에서 근거 확인"]
C --> D["수정 후 빌드 검사"]
D --> E["배포된 URL 다시 확인"]
E --> F["Search Console에서 색인과 노출 확인"]배포 후 검색 실적 확인
AI 보고서의 점수는 어느 항목을 더 살펴볼지 고르는 데 씁니다. 검색 결과에서의 변화는 Search Console 실적 보고서에서 봅니다. 수정일과 대상 URL을 적어 두고, 데이터가 쌓이면 같은 페이지와 검색어에 대해 길이가 같은 기간의 노출수와 클릭수를 비교합니다. 계절이나 수요가 바뀌면 수치도 같이 움직입니다. Google Search Console 실적 보고서
/seo geo가 내놓는 소제목과 출처 관련 제안은 글을 편집할 때 참고할 수 있습니다. Google의 AI 검색 기능을 염두에 둘 때도 대회명, 날짜, 수상 결과처럼 독자가 확인할 수 있는 사실을 글 앞에 둡니다. Google은 생성형 검색 기능에도 검색의 기본 원칙을 적용하라고 안내합니다. 이번 점검 기록에는 세 URL, 각 URL의 대표 주소, 사이트맵 포함 여부를 남겼습니다. 다음 배포 때는 같은 세 줄을 그대로 비교할 수 있습니다. Google의 생성형 AI 검색 안내