---
원제목: "AgriciDaniel/claude-seo — Universal SEO skill for Claude Code"
창작제목: "SEO 감사를 15분으로 줄인 스킬 25개짜리 오픈소스 플러그인"
출처: https://github.com/AgriciDaniel/claude-seo
작성일: 2026-08-31
문서목적: Claude Code용 오픈소스 SEO 플러그인의 구조·주장·검증 결과를 정리해 커리큘럼 소재 가치를 판단한다.
---

# Claude SEO — Core Synthesis

**출처 URL:** https://github.com/AgriciDaniel/claude-seo (GitHub, MIT 라이선스, 스타 15.1k)

---

## 쉬운 설명

웹사이트를 검색에 잘 노출되게 고치는 일을 SEO라고 합니다. 원래는 전문가가 4~8시간 동안 하나하나 확인해야 했는데, 이 프로젝트는 그 작업을 Claude Code 안에서 명령어 한 줄(`/seo audit`)로 돌리게 만든 오픈소스 플러그인입니다. 25개의 하위 스킬과 18개의 전문 에이전트가 있고, 사이트 전체 점검 때는 최대 15개가 동시에 일을 나눠 맡습니다.

특이한 점은 "이렇게 하면 좋아집니다"로 끝내지 않는다는 겁니다. 모든 권고안에 **"이 조언이 틀렸다면 무엇을 보고 알 수 있나"**라는 반증 조건과 관찰 지표를 함께 붙입니다. 또 유행하는 AI 검색 최적화 주장(llms.txt, 콘텐츠 청킹, AI 전용 키워드 재작성) 세 가지를 근거를 들어 "필요 없다"고 명시적으로 반박합니다.

---

## Core Message

Agrici Daniel가 만든 Claude SEO는 SEO 감사를 사람이 하는 컨설팅이 아니라 **병렬 에이전트가 돌리는 재현 가능한 스크립트**로 바꾼 MIT 라이선스 플러그인이다. 기존 상용 도구가 대시보드와 크롤 데이터를 파는 것과 달리, 이 플러그인은 모든 권고에 반증 조건·의존 관계·선행 지표를 붙여 검증 가능한 실행 계획을 만든다. 핵심 주장은 "AI 검색 최적화(GEO/AEO)는 별도 분야가 아니라 그냥 SEO"라는 Google의 1차 자료 입장을 그대로 도구에 구현했다는 것이다.

## Core Keywords

- Claude Code Agent Skills (3계층 구조)
- 병렬 서브에이전트 디스패치 (최대 15개 동시)
- E-E-A-T (Experience·Expertise·Authoritativeness·Trustworthiness)
- QRG (Search Quality Rater Guidelines, 2025년 9월판)
- GEO / AEO
- Schema.org JSON-LD
- Core Web Vitals (LCP·INP·CLS)
- CrUX / PageSpeed Insights / Search Console API
- Playwright 헤드리스 렌더링 (SPA 대응)
- Falsifiability check (반증 가능성 검사)
- Passage citability (134~167단어 자족형 답변 블록)
- MCP 확장 (DataForSEO, Ahrefs, Firecrawl, Profound)

## Key Framework/Mechanism

**10원칙 4단계 감사 프레임워크**

1. **PERCEIVE (관찰)** — OBSERVE(외부)·OBSERVE(내부)·LISTEN. 원시 신호를 모으고, 자기 가정을 스스로 점검하며, SERP와 커뮤니티가 실제로 무엇을 말하는지 읽는다.
2. **ANALYZE (분석)** — THINK·CONNECT(측면)·CONNECT(시스템). 제1원리로 환원하고, 스킬 간 비자명한 연결을 찾아 의존 그래프로 순서를 정한다.
3. **VALIDATE (검증)** — FEEL·ACCEPT. UX·브랜드 목소리·실행 인력 여력에 맞춰 압박 테스트하고 반증 조건을 드러낸다.
4. **ACT (실행)** — CREATE·GROW. 산출물을 내보내고 다음 감사를 위한 피드백 루프를 건다.

각 권고안은 4개 필드를 반드시 달고 나온다: ① 근거가 된 제1원리 관찰 ② 다른 권고와의 의존 관계 ③ "실패했다면 어떻게 알 수 있나" 검사 ④ 감시할 선행 지표.

**Why This Works:**
- 병렬화가 시간을 압축한다 — 4~8시간 수작업이 10~15분으로.
- 반증 조건이 컨설팅을 검증 가능한 가설로 바꾼다.
- 3계층(지시·오케스트레이션·실행) 분리로 스킬을 폴더 추가만으로 확장한다.
- 1차 자료(Google 공식 문서) 기준이라 유행어에 흔들리지 않는다.

## Why This Matters

**생산성 배수** — 감사 1건당 4~8시간이 10~15분으로 줄어든다. 분기 1회 감사가 주 1회로 바뀌면 커버리지가 약 4배가 된다.

**인지 부하 이전** — 25개 스킬이 체크리스트를 대신 기억한다. 사람은 "무엇을 볼지"가 아니라 "무엇을 결정할지"에만 집중한다.

**확장성** — 스킬과 에이전트가 `skills/seo-*/`, `agents/seo-*.md`에서 자동 발견된다. 파일을 넣으면 기능이 늘어난다.

**기존 가정 반박** — "AI 검색은 새로운 최적화 분야다"라는 2년치 업계 서사를 Google 1차 자료로 반박한다. llms.txt·청킹·AI 전용 리라이팅은 Google 기준 불필요.

**학습 가능성** — SKILL.md가 전부 마크다운이다. 프롬프트 설계와 에이전트 분업 구조를 그대로 읽고 뜯어볼 수 있는 교재다.

**데이터 주권** — 기본값이 로컬 실행이다. 무료 티어는 제3자 API를 호출하지 않는다(감사 대상 URL 자체는 접속).

## What to Remember

**패턴부터 뜯어라** — 도구를 그대로 쓰기 전에 `skills/seo/SKILL.md`와 `agents/` 폴더를 열어 오케스트레이터-서브에이전트 분업 구조를 읽어라. 이 구조는 SEO가 아닌 어떤 도메인에도 이식된다.

**반증 조건을 자기 산출물에 붙여라** — 모든 권고에 "틀렸다면 무엇으로 알 수 있나"를 한 줄 추가하라. 이것만 차용해도 컨설팅 품질이 바뀐다.

**4단계 자격증명 설계를 모방하라** — Tier 0(키 없음)에서도 실제 가치가 나오게 만든 구조다. 진입 장벽을 0으로 두고 단계적으로 여는 방식을 자기 도구에 적용하라.

**성과 스크린샷은 증거가 아니다** — README의 3개월 트래픽 그래프는 자기 보고 사례 1건이다. 인과 주장으로 읽지 마라.

**FAQ 스키마를 지금 점검하라** — 2026년 5월 7일부로 FAQ 리치 결과는 사라졌고, 8월에는 Search Console API 지원까지 종료된다. FAQ 지표를 쓰는 대시보드는 값이 조용히 비어버린다.

**배포는 계층으로 나눠라** — Python·Playwright·API 키가 얽힌 이 플러그인은 수업에서 시연할 대상이지, 수강생에게 통째로 배포할 대상이 아니다.

## Bottom Line

SEO 감사는 "전문가의 시간"에서 "재현 가능한 스크립트"로 넘어갔다. 진짜 전환은 자동화가 아니라 **모든 권고에 반증 조건을 강제한 것**이다 — 검증 불가능한 조언을 팔던 시장에 검증 가능한 기준선이 생겼다. 도구는 관망하되 패턴은 오늘 차용하라: 오케스트레이터-서브에이전트 3계층 분업, Tier 0 무자격증명 진입 설계, 권고안 4필드 포맷. 지금 저장소를 클론해 `skills/` 폴더 하나만 열어보고, 자기 산출물의 다음 권고안부터 "이게 틀렸다면 무엇으로 알 수 있나" 한 줄을 붙여 시작하라.

---

## 전문가 의견 (팩트체크 포함)

웹 검색으로 교차 검증한 결과, 이 저장소가 근거로 삼은 외부 사실들은 대체로 정확했다. Google이 2026년 5월 15일 "생성형 AI 검색 최적화" 공식 가이드를 발행하며 AEO·GEO를 별도 분야가 아닌 SEO로 규정하고 llms.txt·콘텐츠 청킹·AI 전용 재작성이 불필요하다고 명시한 것, FAQ 리치 결과가 2026년 5월 7일부로 검색에서 사라지고 6월 Search Console 리포트·8월 API 지원까지 단계 종료되는 것, QRG가 2025년 9월 11일 갱신되며 YMYL이 정부·시민·사회 영역으로 확장된 것 모두 확인된다. INP의 FID 대체(2024년 3월), HowTo 리치 결과 폐지(2023년 9월)도 사실이다. 반면 검증 불가능한 부분도 분명하다. "감사 10~15분", "테스트 410건 통과", "4배 감사 주기"는 전부 저장소 자기 신고 수치이고, 3개월 성장 그래프는 사례 1건이며 플러그인이 원인이라는 인과 증거가 없다. 상용 도구 비교표도 유리한 축(시간·비용·잠금)만 골라 놓은 것으로, 크롤 깊이나 백링크 인덱스 같은 불리한 축은 FAQ에서만 짧게 인정한다. 유지보수 리스크도 크다 — 단독 메인테이너 1인 체제에 v2.0.0 이후 8개월간 마이너 릴리스가 6회 나왔는데, 이는 Google 정책 변화를 계속 따라가야 하는 구조라는 뜻이다. 교육 소재로는 SEO 지식보다 **에이전트 분업 아키텍처와 반증 가능성 강제 포맷**의 가치가 훨씬 크며, Python·Playwright·다중 API 의존성 때문에 수강생 배포 대상이 아니라 시연 대상으로 두는 편이 안전하다.