SEO 감사 스킬
SEOmator CLI를 사용하여 웹사이트의 SEO, 기술, 콘텐츠, 성능, 보안, JavaScript 렌더링 및 AI 준수 상태를 감사합니다.
SEOmator는 251개 규칙과 20개 카테고리에 걸쳐 웹사이트 구조와 콘텐츠를 분석하는 포괄적인 웹사이트 감사 도구입니다.
심각도 수준, 영향을 받는 URL 및 실행 가능한 수정 제안과 함께 문제 목록을 제공합니다.
링크
- SEOmator npm 패키지: npmjs.com/package/@seomator/seo-audit
- GitHub 저장소: github.com/seo-skills/seo-audit-skill
- 웹 UI: seomator.com/free-seo-audit-tool
이 스킬이 하는 일
이 스킬은 AI 에이전트가 20개 카테고리의 251개 규칙에 대해 웹사이트를 감사할 수 있도록 합니다. 여기에는 다음이 포함됩니다.
- 핵심 SEO (19개 규칙): 표준 URL, 색인 생성 지시문, 제목 고유성, 표준 URL 충돌/루프
- 성능 (22개 규칙): LCP, CLS, FCP, TTFB, INP, 압축, 캐싱, 최소화, HTTP/2
- 링크 (19개 규칙): 끊어진 링크, 리디렉션 체인, 앵커 텍스트, 고아 페이지, localhost/조각 링크
- 이미지 (14개 규칙): 대체 텍스트, 크기, 지연 로딩, 최신 형식, 대체 텍스트 길이, 배경 이미지
- 보안 (16개 규칙): HTTPS, HSTS, CSP, 외부 링크 안전성, 유출된 비밀, SSL 만료/프로토콜
- 기술 SEO (13개 규칙): robots.txt, sitemap.xml, URL 구조, 404 페이지, 소프트 404, 오류 코드
- 크롤링 가능성 (18개 규칙): 사이트맵 충돌, 색인 가능성 신호, 표준 체인, 페이지 매김 문제
- 구조화된 데이터 (13개 규칙): Schema.org 마크업, Article, Organization, FAQ, Product, Breadcrumb
- JavaScript 렌더링 (13개 규칙): 렌더링된 DOM 검사, 원시 대 렌더링 불일치, SSR 감지
- 접근성 (12개 규칙): ARIA 레이블, 색상 대비, 양식 레이블, 랜드마크, 터치 대상
- 콘텐츠 (17개 규칙): 단어 수, 가독성, 키워드 밀도, 중복 감지, 픽셀 너비
- 소셜 (9개 규칙): Open Graph 태그, Twitter 카드, 공유 버튼, 프로필 링크
- E-E-A-T (14개 규칙): 저자 서명, 인용, 신뢰 신호, 회사소개/연락처 페이지, YMYL 감지
- URL 구조 (14개 규칙): 키워드 슬러그, 불용어, 대문자, 밑줄, 세션 ID, 추적 매개변수
- 리디렉션 (8개 규칙): 리디렉션 루프, 유형 (301/302), 메타 새로고침, JavaScript 리디렉션, 끊어진 리디렉션
- 모바일 (5개 규칙): 글꼴 크기, 가로 스크롤, 방해가 되는 중간 페이지, 뷰포트 문제
- 국제화 (10개 규칙): lang 속성, hreflang 유효성 검사 (반환 링크, 충돌, 불일치)
- HTML 유효성 검사 (9개 규칙): Doctype, 문자 집합, head 구조, lorem ipsum, 여러 제목/설명
- AI/GEO 준비 (5개 규칙): 시맨틱 HTML, AI 봇 액세스, llms.txt, 스키마 드리프트
- 법적 준수 (1개 규칙): 쿠키 동의
감사는 웹사이트를 크롤링하고 각 페이지를 감사 규칙에 대해 분석한 후 다음을 포함한 포괄적인 보고서를 반환합니다.
- 전반적인 건강 점수 (0-100) 및 문자 등급 (A-F)
- 통과/경고/실패 개수가 포함된 카테고리별 분석
- 규칙별로 그룹화된 영향을 받는 URL이 있는 특정 문제
- 실행 가능한 수정 권장 사항
사용 시기
다음과 같은 경우에 이 스킬을 사용하세요.
- 웹사이트의 SEO 상태 분석
- 기술적 SEO 문제 디버깅
- 끊어진 링크 및 리디렉션 체인 확인
- 메타 태그, 표준 URL 및 구조화된 데이터 유효성 검사
- 보안 헤더, SSL 및 HTTPS 감사
- 접근성 준수 확인
- JavaScript 렌더링 및 SSR 호환성 분석
- AI/GEO 준비 상태 평가 (시맨틱 HTML, llms.txt, 봇 액세스)
- 페이지 간 중복 콘텐츠 감지
- hreflang 및 국제화 설정 유효성 검사
- HTML 문서 구조 및 유효성 검사
- 여러 형식의 사이트 감사 보고서 생성
- 변경 전후 사이트 상태 비교
전제 조건
이 스킬을 사용하려면 SEOmator CLI가 설치되어 있어야 합니다.
설치
npm install -g @seomator/seo-audit
설치 확인
seomator가 설치되고 시스템이 준비되었는지 확인합니다.
seomator self doctor
이 명령은 다음을 확인합니다.
- Node.js 버전 (18+ 권장)
- npm 사용 가능 여부
- Core Web Vitals 및 JS 렌더링을 위한 Chrome/Chromium
- ~/.seomator에 대한 쓰기 권한
- 로컬 설정 파일 존재 여부
설정
seomator init을 실행하면 현재 디렉토리에 seomator.toml 설정 파일이 생성됩니다.
seomator init # 대화형 설정
seomator init -y # 기본값 사용
seomator init --preset blog # 블로그 최적화 설정
seomator init --preset ecommerce # 전자상거래 설정
seomator init --preset ci # 최소 CI 설정
디렉토리에 seomator.toml이 없으면 감사를 실행하기 전에 seomator init으로 하나를 생성하세요.
사용법
AI 에이전트 모범 사례
--format llm을 항상 우선적으로 사용해야 합니다. - AI 에이전트를 위해 특별히 설계된 토큰 최적화 XML 출력을 제공합니다 (JSON보다 50-70% 작음).
감사 시:
- 정확한 성능 및 렌더링 데이터를 위해 로컬 개발 서버보다 라이브 웹사이트를 선호하세요.
- Core Web Vitals 및 JS 렌더링 검사가 필요하지 않은 경우 더 빠른 감사를 위해
--no-cwv를 사용하세요. - 여러 수정 사항을 구현할 때 동시 작업으로 범위를 지정하세요.
- 수정 사항 구현 후 타입 검사/서식 지정을 실행하세요 (tsc, eslint, prettier 등).
웹사이트 발견
사용자가 감사할 웹사이트를 제공하지 않는 경우:
- 로컬 개발 서버 설정 확인 (package.json 스크립트, .env 파일)
- Vercel/Netlify 프로젝트 링크 찾기
- 환경 변수에서 배포 URL 확인
- 감사할 URL을 사용자에게 문의하세요.
로컬 및 라이브 웹사이트를 모두 사용할 수 있는 경우, 정확한 결과를 위해 라이브 사이트 감사를 제안하세요.
기본 워크플로
# LLM 출력을 사용한 빠른 단일 페이지 감사
seomator audit https://example.com --format llm --no-cwv
# 다중 페이지 크롤링 (최대 50페이지)
seomator audit https://example.com --crawl -m 50 --format llm --no-cwv
# Core Web Vitals + JS 렌더링 분석을 포함한 전체 감사
seomator audit https://example.com --crawl -m 20 --format llm
고급 옵션
강제로 새 크롤링 (캐시 무시):
seomator audit https://example.com --refresh --format llm
중단된 크롤링 재개:
seomator audit https://example.com --resume --format llm
특정 카테고리만 감사:
seomator audit https://example.com -c core,security,js --format llm --no-cwv
공유를 위해 HTML 보고서 저장:
seomator audit https://example.com --format html -o report.html
디버깅을 위한 상세 출력:
seomator audit https://example.com --format llm -v
명령어 참조
감사 명령어 옵션
| 옵션 | 별칭 | 설명 | 기본값 |
|---|---|---|---|
--format <fmt> | -f | 출력 형식: console, json, html, markdown, llm | console |
--max-pages <n> | -m | 크롤링할 최대 페이지 수 | 10 |
--crawl | 다중 페이지 크롤링 활성화 | false | |
--categories <list> | -c | 감사할 쉼표로 구분된 카테고리 | 모두 |
--refresh | -r | 캐시 무시, 새로 가져오기 | false |
--resume | 중단된 크롤링 재개 | false | |
--no-cwv | Core Web Vitals + JS 렌더링 건너뛰기 | false | |
--verbose | -v | 진행 상황 표시 | false |
--output <path> | -o | 출력 파일 경로 | |
--config <path> | 설정 파일 경로 | ||
--save | ~/.seomator에 저장 | false |
기타 명령어
seomator init # 설정 파일 생성
seomator self doctor # 시스템 설정 확인
seomator config --list # 모든 설정 값 표시
seomator report --list # 과거 보고서 목록 표시
seomator db stats # 데이터베이스 통계 표시
출력 형식
| 형식 | 플래그 | 용도 |
|---|---|---|
| console | --format console | 사람용 터미널 출력 (기본값) |
| json | --format json | CI/CD, 프로그래밍 방식 처리 |
| html | --format html | 독립 실행형 보고서, 공유 |
| markdown | --format markdown | 문서화, GitHub |
| llm | --format llm | AI 에이전트 (권장) |
--format llm 출력은 토큰 효율성을 위해 최적화된 간결한 XML 형식입니다:
- JSON 출력보다 50-70% 더 작음
- 심각도별로 정렬된 문제 (중요도 순)
- 각 문제에 대한 수정 제안 포함
- AI 도구로 파이핑하기 위한 깔끔한 stdout
예제
예제 1: LLM 출력을 사용한 빠른 감사
# 사용자 질문: "example.com의 SEO 문제를 확인해줘"
seomator audit https://example.com --format llm --no-cwv
예제 2: 대규모 사이트를 위한 심층 크롤링
# 사용자 질문: "최대 100페이지까지 철저한 감사를 해줘"
seomator audit https://example.com --crawl -m 100 --format llm --no-cwv
예제 3: 변경 후 새 감사
# 사용자 질문: "사이트를 다시 감사해줘, 캐시된 결과는 무시하고"
seomator audit https://example.com --refresh --format llm --no-cwv
예제 4: 공유 가능한 보고서 생성
# 사용자 질문: "공유할 수 있는 HTML 보고서를 만들어줘"
seomator audit https://example.com --crawl -m 20 --format html -o seo-report.html
예제 5: 특정 영역에 집중
# 사용자 질문: "JavaScript 렌더링과 리디렉션만 확인해줘"
seomator audit https://example.com -c js,redirect --format llm
결과 평가
점수 범위
| 점수 | 등급 | 의미 |
|---|---|---|
| 90-100 | A | 우수 - 사소한 최적화만 필요 |
| 80-89 | B | 양호 - 경고 해결 필요 |
| 70-79 | C | 개선 필요 - 우선 수정 사항 필요 |
| 50-69 | D | 불량 - 여러 중요 문제 존재 |
| 0-49 | F | 심각 - 해결해야 할 주요 문제 |
우선 순위 (카테고리 가중치 기준)
최대 효과를 위해 다음 순서로 문제를 수정하세요.
- 핵심 (12%) - 메타 태그, 표준 URL, H1, 색인 생성
- 성능 (12%) - Core Web Vitals + 최적화
- 링크 (8%) - 내부 링크 구조
- 이미지 (8%) - 성능 + 접근성
- 보안 (8%) - 신뢰 신호, SSL
- 기술 SEO (7%) - 크롤링 기반
- 크롤링 가능성 (5%) - 색인 가능성, 페이지 매김
- 구조화된 데이터 (5%) - 리치 스니펫
- JavaScript 렌더링 (5%) - 렌더링된 DOM, SSR
- 콘텐츠 (5%) - 텍스트 품질 + 중복
- 접근성 (4%) - WCAG 준수
- 소셜 (3%) - 소셜 공유
- E-E-A-T (3%) - 신뢰, 전문성
- URL 구조 (3%) - URL 위생
- 리디렉션 (3%) - 리디렉션 체인
- 모바일 (2%) - 뷰포트, 글꼴
- 국제화 (2%) - Hreflang
- HTML 유효성 검사 (2%) - 문서 구조
- AI/GEO 준비 (2%) - 시맨틱 HTML, AI 봇
- 법적 준수 (1%) - 쿠키 동의
심각도별 수정
- 실패 (상태: "fail") - 즉시 수정 필요
- 경고 (상태: "warn") - 조만간 수정 필요
- 통과 (상태: "pass") - 조치 불필요
출력 요약
수정 사항을 구현한 후 사용자에게 모든 변경 사항에 대한 요약을 제공하세요.
범위를 계획할 때는 구현 속도를 높이기 위해 하위 에이전트로 동시에 실행할 수 있도록 작업을 구성하세요.
문제 해결
seomator 명령어를 찾을 수 없음
이 오류가 표시되면 seomator가 설치되지 않았거나 PATH에 없는 것입니다.
해결 방법:
npm install -g @seomator/seo-audit
Core Web Vitals가 측정되지 않음
CWV 메트릭이 누락된 경우 Chrome/Chromium을 사용할 수 없을 수 있습니다.
해결 방법:
- Chrome, Chromium 또는 Edge 설치
seomator self doctor를 실행하여 브라우저 감지 확인- CWV가 필요하지 않은 경우
--no-cwv를 사용하여 건너뛰기
크롤링 시간 초과 또는 느린 성능
대규모 사이트의 경우 감사에 몇 분이 걸릴 수 있습니다.
해결 방법:
- 진행 상황을 확인하려면
--verbose사용 - 더 빠른 결과를 위해
-m 20으로 페이지 제한 - 브라우저 기반 측정을 건너뛰려면
--no-cwv사용
잘못된 URL
URL에 프로토콜이 포함되어 있는지 확인하세요.
# 잘못된 예
seomator audit example.com
# 올바른 예
seomator audit https://example.com
작동 방식
- 가져오기: 페이지 HTML을 다운로드하고 응답 시간을 측정합니다.
- 파싱: DOM, 메타 태그, 링크, 이미지, 구조화된 데이터를 추출합니다.
- 보강: 감사당 한 번씩 robots.txt 및 sitemap을 가져옵니다.
- 렌더링 (CWV 활성화된 경우): Playwright를 통해 렌더링된 DOM을 캡처하여 JS 렌더링을 분석합니다.
- 크롤링 (활성화된 경우): 연결된 페이지를 발견하고 가져옵니다.
- 분석: 각 페이지에 대해 251개의 감사 규칙을 실행합니다.
- 점수 계산: 카테고리 및 전체 가중 점수를 계산합니다.
- 보고: 요청된 형식으로 보고서를 생성합니다.
결과는 ~/.seomator/에 저장되며, seomator report 명령으로 나중에 검색할 수 있습니다.
리소스
- 전체 규칙 참조: 모든 251개 규칙은
docs/SEO-AUDIT-RULES.md를 참조하세요. - 스토리지 아키텍처: 데이터베이스 세부 사항은
docs/STORAGE-ARCHITECTURE.md를 참조하세요. - CLI 도움말:
seomator --help및seomator <command> --help