SEO 검토 스킬 (seo-review) — 메타와 색인 준비 점검

seo-review는 반복 업무를 더 안정적으로 처리하기 위한 AI 에이전트 스킬입니다.

사용자가 “SEO 검토해줘”, “검색 노출 검수해줘”, “메타태그/OG/구조화 데이터/사이트맵/robots/canonical 확인해줘”, “검색엔진 최적화 점수 봐줘”라고 요청할 때 사용한다. 웹사이트의 검색 노출 준비 상태, 메타 품질, 색인 가능성, 공유 카드, 구조화 데이터, 콘텐츠 신뢰도를 점수화하고 수정 우선순위를 제시한다.

사용 방법

Codex나 호환되는 AI 에이전트의 스킬 폴더에 아래 SKILL.md 내용을 저장한 뒤, 설명에 포함된 트리거 문장으로 호출하세요.

사용 예:
seo-review 스킬 사용해줘.
이 작업은 seo-review 기준으로 진행해줘.

원본 위치

.codex/skills/seo-review/SKILL.md

SKILL.md

---
name: seo-review
description: 사용자가 “SEO 검토해줘”, “검색 노출 검수해줘”, “메타태그/OG/구조화 데이터/사이트맵/robots/canonical 확인해줘”, “검색엔진 최적화 점수 봐줘”라고 요청할 때 사용한다. 웹사이트의 검색 노출 준비 상태, 메타 품질, 색인 가능성, 공유 카드, 구조화 데이터, 콘텐츠 신뢰도를 점수화하고 수정 우선순위를 제시한다.
---

# SEO Review

## 목적

- 사이트가 검색엔진과 공유 플랫폼에서 제대로 이해되고 노출될 준비가 됐는지 검수한다.
- 단순 키워드 나열보다 검색 사용자의 의도, 페이지 목적, 색인 안정성, 클릭 신뢰도를 우선한다.
- 문제를 치명도와 점수로 정리하고, 바로 수정 가능한 Fix 체크리스트로 넘길 수 있게 만든다.

## 절대 규칙

- 가능하면 실제 URL을 HTTP 요청이나 브라우저로 확인한다. 코드만 보고 단정하지 않는다.
- 확인한 사실과 추정한 판단을 구분한다.
- 검색엔진 순위 보장을 말하지 않는다. 검수는 “노출 준비도와 리스크” 기준이다.
- 페이지별 SEO는 해당 페이지의 사용자 의도와 콘텐츠 맥락에 맞아야 한다.
- 수정은 사용자가 명시적으로 요청하기 전에는 하지 않는다.
- 외부 검색결과, Search Console, Lighthouse 등 최신/외부 데이터가 필요하면 확인 가능 여부를 먼저 밝힌다.

## 검수 준비

1. 대상 URL, 핵심 페이지, 검색 노출 목표, 주요 키워드나 사용자 의도를 파악한다.
2. 사용자가 제공하지 않으면 사이트 목적, 메뉴, 대표 페이지를 보고 핵심 페이지 3~7개를 선정한다.
3. 가능하면 다음 URL을 확인한다: 홈, 주요 카테고리/목록, 대표 상세글, 검색/태그/카테고리, sitemap, robots.
4. 라이브 접근이 안 되면 소스/DB 기준 잠정 검수로 표시한다.

## 검수 범위

### 1. 메타 기본 품질

- `<title>`이 페이지별로 고유하고 검색 사용자의 기대와 맞는지 확인한다.
- `meta description`이 사이트/페이지 맥락과 맞고, 중복되거나 엉뚱한 사업 설명이 아닌지 확인한다.
- 제목과 설명이 너무 짧거나 길지 않은지, 클릭할 이유가 있는지 본다.
- 사이트명, 게시판명, 글 제목의 조합이 자연스러운지 확인한다.

### 2. Canonical과 URL 정규화

- canonical이 현재 페이지의 대표 URL을 가리키는지 확인한다.
- `?mid=`, `?category=`, `/category/...`, 슬래시 유무, 중복 필터 URL이 불필요하게 색인되지 않는지 본다.
- 리다이렉트가 301/302 의도에 맞고, 루프나 엉뚱한 최종 URL이 없는지 확인한다.

### 3. 색인 가능성

- HTTP 상태가 200인지, 404/500/권한 오류가 없는지 확인한다.
- `robots` 메타, `X-Robots-Tag`, `robots.txt`에서 색인을 막지 않는지 확인한다.
- 빈 목록, 얇은 콘텐츠, 중복 페이지가 색인 대상이 되는지 판단한다.
- 로그인/비공개/승인대기 글이 검색 노출되지 않아야 하는지 확인한다.

### 4. OG/Twitter 공유 카드

- `og:title`, `og:description`, `og:url`, `og:type`, `og:image`가 페이지 맥락과 맞는지 확인한다.
- `twitter:card`, `twitter:title`, `twitter:description`, `twitter:image`를 확인한다.
- 상세글은 글 제목/본문 요약/대표 이미지가 반영되는지 본다.
- 사이트 공통 설명이 상세 페이지 설명을 덮어쓰는 문제를 찾는다.

### 5. 구조화 데이터

- JSON-LD가 유효한 JSON인지 확인한다.
- 홈/조직/웹사이트, 게시글 Article/BlogPosting/DiscussionForumPosting, BreadcrumbList 등 타입이 페이지 목적과 맞는지 본다.
- headline, description, url, author, datePublished, dateModified, image, articleBody/text 같은 필수/권장 값이 비어 있지 않은지 확인한다.
- 구조화 데이터의 내용이 실제 화면 콘텐츠와 모순되지 않는지 확인한다.

### 6. 사이트맵과 robots

- `/sitemap.xml`, `/robots.txt` 접근 가능 여부를 확인한다.
- 사이트맵 URL이 200이고 canonical과 일치하는지 본다.
- 삭제/비공개/빈 페이지/중복 필터 URL이 사이트맵에 들어가지 않았는지 확인한다.
- robots가 중요한 경로를 막거나, 민감한 경로를 불필요하게 열어두지 않았는지 확인한다.

### 7. 콘텐츠와 검색 의도

- 페이지 본문이 제목/메타 설명에서 약속한 내용을 실제로 제공하는지 본다.
- “무료/유료”, 가격, 라이선스, 다운로드, 구매, 문의 같은 검색 사용자의 핵심 의문이 명확한지 확인한다.
- 더미 문구, 다른 사이트 설명, 샘플 숫자, 빈 상태가 신뢰를 해치지 않는지 본다.
- 카테고리/태그/목록 페이지는 색인 가치가 있는 설명과 내부 링크를 제공하는지 확인한다.
- 메뉴별 H1/리드 문구/본문/빈 상태가 메타 title/description/OG 설명과 같은 의도를 말하는지 대조한다.
- 화면에서는 프롬프트 마켓인데 메타는 일반 제작사 설명처럼 다른 맥락을 말하면 High 또는 Medium으로 본다.

### 8. 기술 품질

- 모바일에서 title/description/본문이 의미 있게 노출되는지 확인한다.
- 이미지 alt, lazy loading, 대표 이미지 크기, 깨진 이미지, 과도한 JS 의존을 확인한다.
- 페이지 속도는 측정 가능할 때만 판단하고, 측정하지 못하면 미확인으로 둔다.

## 점수 산정

100점 만점으로 점수화한다. 확인하지 못한 범위가 있으면 “잠정 점수”라고 표시한다.

축별 점수:

- **메타/검색 스니펫 20점**: title, description, 페이지별 고유성, 검색 의도 일치.
- **색인/URL 정규화 20점**: HTTP 상태, canonical, robots, 중복 URL, 리다이렉트.
- **OG/공유 카드 15점**: 공유 제목/설명/이미지/URL이 페이지 맥락과 일치.
- **구조화 데이터 15점**: JSON-LD 유효성, 타입 적합성, 실제 콘텐츠와 일치.
- **사이트맵/크롤링 15점**: sitemap, robots, 중요 URL 포함/제외 품질.
- **콘텐츠/신뢰 15점**: 검색 의도 충족, 정책/가격/빈 상태/더미 문구 리스크.

치명도 감점:

- Blocker: 색인 불가, 핵심 페이지 500/404, 전체 noindex, canonical 대량 오지정: -25
- High: 주요 페이지 메타가 완전히 다른 사이트 설명, 상세 콘텐츠 미노출, 구조화 데이터 심각한 모순: -12
- Medium: 중복 description, OG 이미지 누락, 빈 목록 색인, 필터 URL 중복, sitemap 품질 문제: -5
- Low: title 길이, 미세한 문구, alt 일부 누락, 보완하면 좋은 내부 링크: -2
- 미확인: sitemap/robots 미확인 -3, 브라우저/모바일 미확인 -5, Search Console 미확인 -3

공개 판단:

- **95~100점**: SEO 기본 공개 가능.
- **90~94점**: 조건부 공개 가능. High 이상 없어야 한다.
- **80~89점**: 공개는 가능하나 검색 유입 확대 전 보완 권장.
- **79점 이하**: 검색 노출 관점 공개 보류 권장.
- Blocker가 있으면 점수와 관계없이 검색 노출 공개 보류.

## 출력 형식

```text
SEO 검수 범위
- 대상:
- 확인한 URL:
- 확인하지 못한 범위:

SEO 점수
- 점수: 00/100
- 공개 판단:
- 축별 점수:
  - 메타/검색 스니펫: 00/20
  - 색인/URL 정규화: 00/20
  - OG/공유 카드: 00/15
  - 구조화 데이터: 00/15
  - 사이트맵/크롤링: 00/15
  - 콘텐츠/신뢰: 00/15

주요 이슈
1. [High] 이슈 제목
   - 위치:
   - 증거:
   - 검색 영향:
   - 권장 수정:

페이지별 SEO 평가
- 홈:
- 목록/카테고리:
- 상세글:
- 기타:

검색 의도와 화면 텍스트 일치
- URL:
  - title/description:
  - 화면 핵심 문구:
  - 판정:
  - 권장 수정:

Fix 체크리스트
- [ ] [High] 메타 설명 불일치 — 수정 대상/확인 URL
- [ ] [Medium] OG 이미지 누락 — 수정 대상/확인 URL

우선순위
1. 먼저 고칠 것
2. 다음에 고칠 것
3. 나중에 다듬을 것

재검수 필요 항목
- 수정 후 다시 확인할 URL:
- 외부 도구가 필요한 항목:
- Search Console에서 확인할 항목:
```

## 수정 요청을 받은 경우

- 사용자가 “SEO 수정까지 해줘”라고 명시하면 명확한 결함부터 고친다.
- title/description/canonical/OG/JSON-LD처럼 명확한 오류는 바로 수정한다.
- 키워드 전략, 콘텐츠 방향, URL 구조 개편은 2~3개 선택지를 점수화하고 사용자가 고른 안으로 진행한다.
- 수정 후 같은 URL을 다시 요청해 HTML 결과로 재검수한다.