seo-audit · v2.0.0 · 2026-04-20 · sha256 d338c1c3f399fa83
seo-audit v2.0.0A

Name: seo-audit
Author: dannykkh
Immutable. This exact content is served forever at /api/v1/blob/d338c1c3f399fa83.
---
name: seo-audit
description: "웹 프로젝트 SEO + AEO + GEO 종합 감사. robots.txt, sitemap, 메타태그, 구조화 데이터, 성능, AI 크롤러, 답변 엔진, 생성형 AI 최적화 등 10개 영역 자동 점검. /seo-audit로 실행."
license: MIT
metadata:
  version: "2.0.0"
---

# SEO + AEO + GEO Audit — 웹 프로젝트 검색 종합 감사

웹 프로젝트의 검색 최적화 상태를 **10개 영역**에 걸쳐 자동 점검합니다.
전통적인 SEO(영역 1~7)에 더해, AI 시대의 **AEO**(Answer Engine Optimization)와 **GEO**(Generative Engine Optimization)까지 포괄합니다.

Next.js, Nuxt, Astro, Remix, SvelteKit, 정적 HTML 등 **모든 웹 프레임워크**에 대응합니다.

### SEO vs AEO vs GEO

| 구분 | SEO (영역 1~7) | AEO (영역 9) | GEO (영역 10) |
|------|---------------|-------------|--------------|
| **대상** | Google/Bing 검색 결과 | Featured Snippet, 음성 비서, AI 답변 | ChatGPT, Perplexity, Gemini, Claude 등 생성형 AI |
| **목표** | 검색 순위 상위 노출 | "하나의 답변"으로 선택됨 | AI가 출처로 인용/추천 |
| **핵심 전략** | 키워드, 백링크, 기술적 최적화 | FAQ 스키마, 간결한 답변 블록, Q&A 형식 | 팩트 밀도, 인용 가능한 콘텐츠, 권위 신호 |

## 적용 시점

- `/seo-audit` 명시적 실행
- 웹 프로젝트 배포 전 점검
- "SEO 점검해줘", "검색 최적화 확인" 요청 시
- "AI 검색 최적화", "AEO 점검", "GEO 점검" 요청 시

---

## Step 1: 프로젝트 정찰

먼저 기술 스택과 구조를 파악합니다.

**필수 확인:**
```
- package.json → 프레임워크 종류, SEO 관련 패키지
- 프레임워크 설정 파일 (next.config.*, nuxt.config.*, astro.config.*, vite.config.* 등)
- 라우팅 디렉토리 구조 (src/app/, src/pages/, src/routes/ 등)
- public/ 또는 static/ 디렉토리 내 정적 파일
- middleware 파일 존재 여부
```

**프레임워크 자동 감지:**

| 감지 패턴 | 프레임워크 | 메타데이터 방식 |
|-----------|-----------|---------------|
| `next` in package.json | Next.js | `metadata` export / `<Head>` |
| `nuxt` in package.json | Nuxt | `useHead()` / `nuxt.config` SEO |
| `astro` in package.json | Astro | frontmatter / `<BaseHead>` |
| `@remix-run` in package.json | Remix | `meta()` function |
| `@sveltejs/kit` in package.json | SvelteKit | `<svelte:head>` |
| `gatsby` in package.json | Gatsby | `gatsby-plugin-react-helmet` |
| `*.html` in root/public | 정적 HTML | `<meta>` 태그 직접 확인 |

---

## Step 2: 10개 영역 감사

각 영역을 순차적으로 점검하고 P0~P3 등급으로 분류합니다.
[등급 판정 기준 → references/severity-guide.md](references/severity-guide.md)

### 영역 구성

| 카테고리 | 영역 | 한 줄 설명 |
|---------|------|-----------|
| **SEO** | 1. robots.txt | 크롤러 접근 정책 및 sitemap 참조 |
| **SEO** | 2. Sitemap | 모든 공개 라우트 등록 및 유효성 |
| **SEO** | 3. 메타태그 | title, description, OG, canonical, viewport |
| **SEO** | 4. 구조화 데이터 | JSON-LD @type 적절성 및 필수 필드 |
| **SEO** | 5. 이미지 | alt 속성, 최적화 컴포넌트, lazy loading |
| **SEO** | 6. 링크 & 내비게이션 | 404, rel, 앵커 텍스트 |
| **SEO** | 7. 성능 | Core Web Vitals 관련, SSR/SSG 여부 |
| **AEO/GEO** | 8. AI 크롤러 접근성 | GPTBot/ClaudeBot 허용, llms.txt |
| **AEO/GEO** | 9. AEO (답변 엔진) | FAQPage 스키마, 질문형 헤딩, 40단어 규칙 |
| **AEO/GEO** | 10. GEO (생성형 AI) | 팩트 밀도, E-E-A-T, 인용 가능한 콘텐츠 |

[영역별 상세 체크리스트 및 탐색 방법 → references/10-areas-checklist.md](references/10-areas-checklist.md)

[구현 코드 예시 → references/seo-patterns.md](references/seo-patterns.md)

---

## Step 2.5: Lighthouse 자동 실행 (성능 측정)

영역 7(성능) 점검 시 수동 체크리스트 대신 **Lighthouse CLI를 직접 실행**합니다.

### 실행 방법

```bash
# Lighthouse CLI 확인
npx lighthouse --version 2>/dev/null || echo "미설치 — npm install -g lighthouse"

# dev server 실행 중인지 확인
curl -s -o /dev/null -w "%{http_code}" http://localhost:3000 || echo "서버 미실행"

# Lighthouse 실행 (JSON 리포트)
npx lighthouse http://localhost:3000 \
  --output=json \
  --output-path=./lighthouse-report.json \
  --chrome-flags="--headless --no-sandbox" \
  --only-categories=performance,accessibility,best-practices,seo \
  2>/dev/null
```

### 점수 파싱 + 등급 매핑

```bash
# JSON에서 점수 추출
node -e "
  const r = require('./lighthouse-report.json');
  const c = r.categories;
  console.log('Performance:', Math.round(c.performance.score * 100));
  console.log('Accessibility:', Math.round(c.accessibility.score * 100));
  console.log('Best Practices:', Math.round(c['best-practices'].score * 100));
  console.log('SEO:', Math.round(c.seo.score * 100));
"
```

| Lighthouse 점수 | 등급 | 조치 |
|----------------|------|------|
| 90-100 | 녹색 | 양호 |
| 50-89 | 주황 | P1~P2 개선 필요 |
| 0-49 | 빨강 | P0 즉시 수정 |

### Core Web Vitals 추출

| 메트릭 | 기준 | Lighthouse 항목 |
|--------|------|----------------|
| LCP | < 2.5s | `largest-contentful-paint` |
| CLS | < 0.1 | `cumulative-layout-shift` |
| INP | < 200ms | `interaction-to-next-paint` |
| FCP | < 1.8s | `first-contentful-paint` |
| TTFB | < 800ms | `server-response-time` |

### Lighthouse 실행 불가 시

- dev server 미실행 → 사용자에게 서버 시작 안내
- Chrome 미설치 → 수동 체크리스트로 폴백 (기존 영역 7 방식)
- CI 환경 → `--no-sandbox --headless` 플래그 추가

---

## Step 3: 감사 리포트 생성

모든 영역 점검 + Lighthouse 결과를 통합하여 리포트를 출력합니다.

```
# SEO 감사 리포트

프로젝트: {프로젝트명}  |  프레임워크: {감지된 프레임워크}  |  점검일: {날짜}
전체: P0 {n}건 / P1 {n}건 / P2 {n}건 / P3 {n}건

Lighthouse 점수:
  Performance:    {N}/100
  Accessibility:  {N}/100
  Best Practices: {N}/100
  SEO:            {N}/100
```

- **P0** (즉시 수정): 현재 상태 → 영향 → 수정 코드
- **P1** (빠른 수정): 현재 상태 → 영향 → 수정 방법
- **P2** (개선 권장): 항목 설명
- **P3** (최적화 제안): 항목 설명
- **Lighthouse 결과**: 점수 + Core Web Vitals + 상위 5개 개선 제안
- **통과 항목**: 체크리스트
- **권장 액션 플랜**: Lighthouse 점수 기반 우선순위 정렬

[전체 리포트 형식 → references/severity-guide.md](references/severity-guide.md)

---

## 다음 단계 안내

```
✅ SEO + AEO + GEO 감사 완료!
   SEO  (영역 1~7):  P0: {n}건, P1: {n}건, P2: {n}건, P3: {n}건
   AEO/GEO (영역 8~10): P0: {n}건, P1: {n}건, P2: {n}건, P3: {n}건

다음 단계 (선택):
  security-reviewer    → 보안 점검
  /minos          → Playwright 자동 테스트
  /commit              → 변경사항 커밋
```