Communitygithub.com

AndresOrozcoDev/website

SEOmator CLI를 사용하여 웹사이트의 SEO, 기술, 콘텐츠, 보안, JS 렌더링 및 AI 준수 상태를 감사합니다. 251개 규칙과 20개 카테고리에 걸친 건강 점수로 LLM 최적화 보고서를 반환합니다. 웹사이트 분석, SEO 문제 디버깅 또는 사이트 상태 확인 시 사용하세요.

website란 무엇인가요?

이 SEO 감사 스킬은 AI 에이전트가 웹사이트를 포괄적으로 분석할 수 있도록 설계되었습니다. SEOmator CLI를 활용하여 251개의 규칙과 20개 카테고리(핵심 SEO, 성능, 링크, 이미지, 보안, 기술 SEO, 크롤링 가능성, 구조화된 데이터, JavaScript 렌더링, 접근성, 콘텐츠, 소셜, E-E-A-T, URL 구조, 리디렉션, 모바일, 국제화, HTML 유효성 검사, AI/GEO 준비, 법적 준수)에 걸쳐 사이트를 감사합니다. 주요 기능으로는 단일 페이지 감사, 다중 페이지 크롤링, Core Web Vitals 측정, JavaScript 렌더링 분석, AI/GEO 준비 상태 평가 등이 있습니다. 출력 형식은 `llm` (토큰 최적화 XML, AI 에이전트용), JSON, HTML, 마크다운, 콘솔을 지원합니다. 스킬은 전반적인 건강 점수(0-100), 카테고리별 분석, 심각도별 문제 목록 및 실행 가능한 수정 제안을 제공합니다. 보고서는 ~/.seomator/에 저장되며 나중에 검색할 수 있습니다. 이 스킬은 Claude Code, Cursor, Codex 등 SEOmator CLI에 접근할 수 있는 모든 AI 에이전트와 호환됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AndresOrozcoDev/website/tree/HEAD/.agents/skills/seo-audit

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

SEO 감사 스킬

SEOmator CLI를 사용하여 웹사이트의 SEO, 기술, 콘텐츠, 성능, 보안, JavaScript 렌더링 및 AI 준수 상태를 감사합니다.

SEOmator는 251개 규칙과 20개 카테고리에 걸쳐 웹사이트 구조와 콘텐츠를 분석하는 포괄적인 웹사이트 감사 도구입니다.

심각도 수준, 영향을 받는 URL 및 실행 가능한 수정 제안과 함께 문제 목록을 제공합니다.

링크

이 스킬이 하는 일

이 스킬은 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% 작음).

감사 시:

  1. 정확한 성능 및 렌더링 데이터를 위해 로컬 개발 서버보다 라이브 웹사이트를 선호하세요.
  2. Core Web Vitals 및 JS 렌더링 검사가 필요하지 않은 경우 더 빠른 감사를 위해 --no-cwv를 사용하세요.
  3. 여러 수정 사항을 구현할 때 동시 작업으로 범위를 지정하세요.
  4. 수정 사항 구현 후 타입 검사/서식 지정을 실행하세요 (tsc, eslint, prettier 등).

웹사이트 발견

사용자가 감사할 웹사이트를 제공하지 않는 경우:

  1. 로컬 개발 서버 설정 확인 (package.json 스크립트, .env 파일)
  2. Vercel/Netlify 프로젝트 링크 찾기
  3. 환경 변수에서 배포 URL 확인
  4. 감사할 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, llmconsole
--max-pages <n>-m크롤링할 최대 페이지 수10
--crawl다중 페이지 크롤링 활성화false
--categories <list>-c감사할 쉼표로 구분된 카테고리모두
--refresh-r캐시 무시, 새로 가져오기false
--resume중단된 크롤링 재개false
--no-cwvCore 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 jsonCI/CD, 프로그래밍 방식 처리
html--format html독립 실행형 보고서, 공유
markdown--format markdown문서화, GitHub
llm--format llmAI 에이전트 (권장)

--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-100A우수 - 사소한 최적화만 필요
80-89B양호 - 경고 해결 필요
70-79C개선 필요 - 우선 수정 사항 필요
50-69D불량 - 여러 중요 문제 존재
0-49F심각 - 해결해야 할 주요 문제

우선 순위 (카테고리 가중치 기준)

최대 효과를 위해 다음 순서로 문제를 수정하세요.

  1. 핵심 (12%) - 메타 태그, 표준 URL, H1, 색인 생성
  2. 성능 (12%) - Core Web Vitals + 최적화
  3. 링크 (8%) - 내부 링크 구조
  4. 이미지 (8%) - 성능 + 접근성
  5. 보안 (8%) - 신뢰 신호, SSL
  6. 기술 SEO (7%) - 크롤링 기반
  7. 크롤링 가능성 (5%) - 색인 가능성, 페이지 매김
  8. 구조화된 데이터 (5%) - 리치 스니펫
  9. JavaScript 렌더링 (5%) - 렌더링된 DOM, SSR
  10. 콘텐츠 (5%) - 텍스트 품질 + 중복
  11. 접근성 (4%) - WCAG 준수
  12. 소셜 (3%) - 소셜 공유
  13. E-E-A-T (3%) - 신뢰, 전문성
  14. URL 구조 (3%) - URL 위생
  15. 리디렉션 (3%) - 리디렉션 체인
  16. 모바일 (2%) - 뷰포트, 글꼴
  17. 국제화 (2%) - Hreflang
  18. HTML 유효성 검사 (2%) - 문서 구조
  19. AI/GEO 준비 (2%) - 시맨틱 HTML, AI 봇
  20. 법적 준수 (1%) - 쿠키 동의

심각도별 수정

  1. 실패 (상태: "fail") - 즉시 수정 필요
  2. 경고 (상태: "warn") - 조만간 수정 필요
  3. 통과 (상태: "pass") - 조치 불필요

출력 요약

수정 사항을 구현한 후 사용자에게 모든 변경 사항에 대한 요약을 제공하세요.

범위를 계획할 때는 구현 속도를 높이기 위해 하위 에이전트로 동시에 실행할 수 있도록 작업을 구성하세요.

문제 해결

seomator 명령어를 찾을 수 없음

이 오류가 표시되면 seomator가 설치되지 않았거나 PATH에 없는 것입니다.

해결 방법:

npm install -g @seomator/seo-audit

Core Web Vitals가 측정되지 않음

CWV 메트릭이 누락된 경우 Chrome/Chromium을 사용할 수 없을 수 있습니다.

해결 방법:

  1. Chrome, Chromium 또는 Edge 설치
  2. seomator self doctor를 실행하여 브라우저 감지 확인
  3. CWV가 필요하지 않은 경우 --no-cwv를 사용하여 건너뛰기

크롤링 시간 초과 또는 느린 성능

대규모 사이트의 경우 감사에 몇 분이 걸릴 수 있습니다.

해결 방법:

  • 진행 상황을 확인하려면 --verbose 사용
  • 더 빠른 결과를 위해 -m 20으로 페이지 제한
  • 브라우저 기반 측정을 건너뛰려면 --no-cwv 사용

잘못된 URL

URL에 프로토콜이 포함되어 있는지 확인하세요.

# 잘못된 예
seomator audit example.com

# 올바른 예
seomator audit https://example.com

작동 방식

  1. 가져오기: 페이지 HTML을 다운로드하고 응답 시간을 측정합니다.
  2. 파싱: DOM, 메타 태그, 링크, 이미지, 구조화된 데이터를 추출합니다.
  3. 보강: 감사당 한 번씩 robots.txt 및 sitemap을 가져옵니다.
  4. 렌더링 (CWV 활성화된 경우): Playwright를 통해 렌더링된 DOM을 캡처하여 JS 렌더링을 분석합니다.
  5. 크롤링 (활성화된 경우): 연결된 페이지를 발견하고 가져옵니다.
  6. 분석: 각 페이지에 대해 251개의 감사 규칙을 실행합니다.
  7. 점수 계산: 카테고리 및 전체 가중 점수를 계산합니다.
  8. 보고: 요청된 형식으로 보고서를 생성합니다.

결과는 ~/.seomator/에 저장되며, seomator report 명령으로 나중에 검색할 수 있습니다.

리소스

  • 전체 규칙 참조: 모든 251개 규칙은 docs/SEO-AUDIT-RULES.md를 참조하세요.
  • 스토리지 아키텍처: 데이터베이스 세부 사항은 docs/STORAGE-ARCHITECTURE.md를 참조하세요.
  • CLI 도움말: seomator --help 및 seomator <command> --help

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

AndresOrozcoDev/website

Frontend design skill that generates, restyles, and guides UI development in mager's signature aesthetic — hot, sleek, sexy, usable, fun, and addictive interfaces with dark-first themes, terminal-inspired typography, neon accents, and visual discovery patterns. Use this skill when building or reviewing any frontend UI.

AndresOrozcoDev/website

Generate beautiful, production-ready, animated single-file HTML landing pages. Use this skill whenever the user asks to create a landing page, marketing page, product page, startup homepage, SaaS landing, app launch page, waitlist page, or any promotional single-page site. Also trigger when user says "make a landing for...", "generate landing page", "build me a homepage", "create a product page", "landing page for my startup", or asks to improve/redesign an existing landing page. Covers both "from scratch" generation and "improve/convert" workflows. Outputs one self-contained HTML file with Tailwind CSS, vanilla JS animations, responsive design, dark/light mode, and curated visual style presets. Always use this skill even for simple landing requests — it ensures premium, non-generic output.

AndresOrozcoDev/website

This skill should be used when the user asks to "write SEO content", "create a blog post", "write an article", "content writing for SEO", "draft optimized content", "write a how-to guide", "create a product description", "write a landing page", "SEO copywriting", "draft content targeting [keyword]", or "write 2000-word article about [topic]". Creates keyword-optimized content using a 12-step workflow: CORE-EEAT pre-write checklist, keyword integration, title optimization (5 formula options), meta description, H1/H2/H3 hierarchy, featured snippet targeting, internal/external linking, and readability enhancement. Produces full drafts with embedded SEO elements, title variants, meta description, FAQ section with schema, and a self-scored CORE-EEAT checklist. For AI-citation optimization, see geo-content-optimizer. For updating existing content, see content-refresher.

관련 스킬