내 사이트,구글과 AI는어떻게 볼까
중급자용© AIKOREACLUBAgriciDaniel/claude-seo
내 사이트, 구글과 AI는 어떻게 볼까
클로드 코드에서 /seo audit 한 줄로 사이트 전체 SEO 점검을 맡기면, 전문 에이전트들이 나눠 살펴보고 점수와 고칠 순서를 파일로 남겨 주는 플러그인이에요
홈페이지를 만들고 몇 달이 지나도 검색에 안 나오면, 어디가 문제인지부터 막막해요. 사람 눈에는 멀쩡한 페이지인데 검색엔진과 AI는 전혀 다른 것을 보고 있을 수 있어요. 제목 태그, 사이트맵, 구조화 데이터, AI 크롤러를 들여보내는지 같은 것들이요.클로드 SEO는 클로드 코드 안에서 사이트 주소 하나로 이걸 한꺼번에 점검해요. README 기준 10~15분이면 끝나고, 무엇부터 고칠지 순서를 매긴 계획을 줘요. 구글 AI 개요나 챗GPT 같은 AI 검색에 인용될 준비가 됐는지도 따로 봐요.
README에 실린 데모 화면이에요. 먼저 홈페이지를 읽어 사업 종류를 알아낸 뒤, 전문 에이전트를 나눠 보내고, 결과를 모아 SEO 건강 점수와 고칠 순서를 만들어요.이미지: AgriciDaniel/claude-seo README (MIT)
사람 눈엔 멀쩡한데, 검색엔진 눈에는
클로드 SEO가 살펴보는 분야를 이해하기 쉽게 저희가 그린 예시예요. 사이트와 숫자는 지어낸 것이고, 실제 점검 결과는 사이트마다 달라요.
한눈에
무엇인가요
사이트 주소 하나로 전체를 점검해요. /seo audit 를 실행하면 홈페이지를 읽어 사업 종류(SaaS, 지역 가게, 쇼핑몰, 언론, 대행사)를 알아내고, 거기에 맞춰 점검 항목을 조정해요.전문가 여럿이 나눠 봐요. 기술, 콘텐츠, 구조화 데이터, 사이트맵, 속도, 화면, AI 검색 담당 에이전트가 동시에 사이트를 살펴요. 최대 17개가 한꺼번에 일한다고 README가 밝혀요.경고 더미가 아니라 계획을 줘요. 모든 권고에 왜 중요한지, 고친 뒤 무엇으로 확인하는지가 붙어요. 결과는 마크다운 파일로 남고, PDF 보고서로도 바꿀 수 있어요.
함께 쓰는 도구 · 클로드 코드
이런 분께
- 홈페이지나 쇼핑몰을 운영하는데 검색 유입이 왜 안 느는지 모르는 사장님과 마케터
- 고객사 사이트를 자주 점검하고, 바뀐 점까지 감시해야 하는 SEO 대행사와 프리랜서
- 구글 AI 개요나 챗GPT 답변에 우리 사이트가 인용되도록 준비하고 싶은 분
어떻게 작동하나요
점수는 0~100점의 SEO 건강 점수 하나로 모여요. 스킬 문서에 적힌 비중은 콘텐츠 품질 23%, 기술 SEO 22%, 페이지 요소(제목, 설명, 헤딩) 20%, 구조화 데이터 10%, 속도 10%, AI 검색 준비 10%, 이미지 5%예요.고칠 순서는 네 단계예요. 색인을 막거나 불이익을 받는 문제(Critical)는 바로, 순위에 크게 영향을 주는 문제(High)는 1주 안에, 개선 기회(Medium)는 한 달 안에, 있으면 좋은 것(Low)은 나중에 고쳐요.API 키 없이도 돌아가요. 다만 키가 없으면 속도 지표는 실험실 추정치이고, 색인 여부는 페이지를 보고 짐작한 값이에요. 무료 구글 API(PageSpeed, 크롬 사용자 경험 보고서, 서치 콘솔, GA4)를 /seo google setup 으로 연결하면 실제 데이터로 바뀌어요.
바로 쓸 수 있나요
필요한 것클로드 코드 1.0.33 이상과 파이썬 3.11~3.14. 구글 API 키는 선택이에요
비용저장소는 무료(MIT)이고 클로드 코드 요금제 사용량을 써요. 전체 점검은 판단이 많은 에이전트 5개가 Opus로 돌아서 한 페이지 점검보다 사용량이 많아요
시작하기
- 장터 추가
클로드 코드 1.0.33 이상에서, 대화창에 입력해요.
/plugin marketplace add AgriciDaniel/claude-seo - 플러그인 설치
스킬 26개와 에이전트 19개가 들어와요.
/plugin install claude-seo@agricidaniel-claude-seo - 준비
전용 파이썬 환경과 헤드리스 브라우저를 시스템의 나머지는 건드리지 않고 준비해요. 파이썬 3.11~3.14가 필요해요. 언제든 /seo doctor 로 상태를 확인할 수 있어요.
/seo setup - 첫 점검
example.com 자리에 내 사이트 주소를 넣어요. 우선순위가 매겨진 계획이 나와요.
/seo audit https://example.com
/seo page https://example.com/pricing
전체 점검은 사용량이 많아서, README 예시처럼 한 페이지부터 해 봐도 돼요. 주소는 내 사이트로 바꾸세요.처음 쓰는 순서
/seo setup전용 파이썬 환경과 브라우저 준비/seo audit <url>사이트 전체 점검, 점수와 고칠 순서 받기/seo page <url>가장 중요한 페이지 하나 깊게/seo geo <url>AI 검색 준비 점검/seo drift baseline <url>고친 뒤 기준점 저장, 다음엔 compare 로 비교
README 명령들을 처음 쓰는 순서로 저희가 묶은 예예요.
/seo audit 한 줄이 하는 일
README와 seo-audit 스킬 문서에 적힌 순서를 보여 주려고 저희가 그린 예시예요. 사이트, 점수, 발견한 문제는 지어낸 것이고, 실제 결과는 사이트와 연결한 API에 따라 달라져요.
명령어 전체 30개, 언제 쓰나
점검과 계획
/seo setup- 전용 파이썬 환경과 헤드리스 브라우저 준비
/seo doctor- 시스템을 바꾸지 않고 준비 상태만 확인
/seo audit <url>- 에이전트를 나눠 보내는 사이트 전체 점검
/seo page <url>- 한 페이지 깊게 분석
/seo plan <type>- SEO 전략 계획(saas, local, ecommerce, publisher, agency)
기술 SEO
/seo technical <url>- 기술 SEO 9개 분야 점검
/seo sitemap <url | generate>- XML 사이트맵 분석 또는 생성
/seo images <url>- 이미지 최적화 분석
/seo hreflang <url>- 다국어 사이트 설정 점검과 생성
/seo programmatic <url>- 틀로 대량 생성하는 페이지 분석과 계획
/seo google [command]- 구글 API: 서치 콘솔, PageSpeed, CrUX, 색인, GA4, PDF 보고서
/seo drift baseline | compare | history <url>- 기준점을 저장해 두고 바뀐 점 감시
콘텐츠와 신뢰도
/seo content <url>- E-E-A-T와 콘텐츠 품질 분석
/seo content-brief <topic>- 목표 키워드, 목차, 내부 링크를 담은 글 기획안
/seo cluster <keyword>- 검색 결과를 바탕으로 주제 묶기
/seo sxo <url>- 검색 경험 최적화: 페이지 유형, 사용자 이야기, 페르소나
/seo flow [stage]- 근거 중심 FLOW 프레임워크 프롬프트
/seo competitor-pages <url>- 경쟁사 비교 페이지 만들기
구조화 데이터와 AI 검색
/seo schema <url>- 구조화 데이터 찾기, 검증, 생성
/seo geo <url>- AI 개요와 생성형 검색 최적화
/seo agentic <url>- AI 에이전트가 쓰기 쉬운 사이트인지: llms.txt, 마크다운, WebMCP 등
지역, 링크, 쇼핑몰
/seo local <url>- 구글 비즈니스 프로필, 인용, 리뷰, 지도 묶음
/seo maps [command]- 지도 순위 격자, 비즈니스 프로필, 리뷰, 주변 경쟁사
/seo backlinks <url>- 백링크 분석(Moz, Bing, Common Crawl)
/seo ecommerce <url>- 쇼핑몰 SEO와 마켓플레이스 분석
확장(선택)
/seo image-gen [use-case]- SEO용 AI 이미지 만들기
/seo seranking [command]- 챗GPT, 제미나이 등 AI 답변 속 점유율
/seo profound [command]- AI 모델이 우리 사이트를 인용하는지 추적
/seo bing [command] <url>- 빙 웹마스터 도구와 IndexNow 제출
/seo unlighthouse <url>- 여러 페이지 Lighthouse 점수, 내 컴퓨터에서 실행
모두 클로드 코드 대화창에서 실행해요. 확장 명령은 그 서비스의 계정이나 키가 있어야 하고, 이 밖의 확장 명령은 명령 전체 문서(docs/COMMANDS.md)에 있어요.
비슷한 도구
클로드 SEO는 SEO 하나를 에이전트 여럿으로 깊게 파고, 아래 모음은 마케팅 전반을 넓게 다뤄요(각 README 기준).
주의할 점
- 점검하는 페이지 내용은 클로드(앤트로픽 모델)로 보내져요. 보고서는 내 컴퓨터에 파일로 남고, 확장이나 API를 직접 연결하지 않으면 다른 SEO 서비스는 데이터를 보지 않는다고 밝혀요. 위키백과, 레딧, Common Crawl 같은 공개 자료도 함께 읽어요.
- 키 없이 돌리면 속도 지표는 실험실 추정치, 색인 여부는 짐작이에요. 스크롤하거나 눌러야 내용이 나오는 페이지는 결과가 흔들릴 수 있다고 README가 적어 둬요.
- 한 번 점검할 때 내부 링크를 따라 최대 500쪽까지, 동시 5개씩 1초 간격으로 읽어요(robots.txt는 지켜요). 서버가 약한 사이트라면 이 점을 알고 돌리세요.
- 공개판(MIT) 말고 유료 커뮤니티(AI Marketing Hub Pro) 회원용 비공개판이 따로 있고, 새 기능이 그쪽에 먼저 들어가요.
- 수동 설치는 설치 스크립트를 실행해요. README는 curl로 받을 때 내용을 먼저 열어 본 뒤 실행하라고 안내해요.
더 보기
Agrici Daniel이 만들었고, AI Marketing Hub Pro 커뮤니티가 함께 다듬어요.
낯선 말
- SEO · 검색엔진 최적화. 검색 결과에서 내 사이트가 잘 보이게 하는 일이에요
- E-E-A-T · 경험, 전문성, 권위, 신뢰. 구글이 콘텐츠 품질을 볼 때 쓰는 기준이에요
- 구조화 데이터 · 주소, 영업시간, 가격처럼 페이지 정보를 기계가 읽기 쉬운 정해진 형식(Schema.org)으로 적어 둔 표시예요
- GEO · 생성형 검색 최적화. AI가 답을 만들 때 내 페이지를 인용하게 준비하는 일이에요
- Core Web Vitals · 구글이 보는 페이지 체감 속도 지표 묶음이에요. LCP(가장 큰 요소가 뜨는 시간) 등이 있어요
- robots.txt · 검색엔진과 크롤러에게 어디를 읽어도 되는지 알려 주는 사이트 맨 위 파일이에요
- 백링크 · 다른 사이트가 내 사이트로 걸어 준 링크예요
댓글
AI 답은 참고 자료예요. 법·세금·돈·건강처럼 삶에 큰 영향을 주는 일에서는 AI 답이 정답이 될 수 없어요. 최종 판단은 전문가나 공식 기관에서 확인하세요.
