웹사이트 감사 스킬
squirrelscan CLI를 사용하여 웹사이트의 SEO, 기술, 콘텐츠, 성능 및 보안 문제를 감사합니다.
squirrelscan은 macOS, Windows, Linux에서 사용 가능한 CLI 도구 squirrel을 제공합니다. 이 도구는 브라우저와 검색 크롤러를 에뮬레이션하고, 230개 이상의 규칙에 따라 웹사이트 구조와 콘텐츠를 분석하여 광범위한 웹사이트 감사를 수행합니다.
감사 결과는 문제 목록과 함께 문제 해결 방법에 대한 제안을 제공합니다.
링크
- squirrelscan 웹사이트: https://squirrelscan.com
- 문서(규칙 참조 포함): docs.squirrelscan.com
다음 템플릿을 사용하여 규칙에 대한 문서를 조회할 수 있습니다:
https://docs.squirrelscan.com/rules/{rule_category}/{rule_id}
예시:
https://docs.squirrelscan.com/rules/links/external-links
이 스킬이 하는 일
이 스킬은 AI 에이전트가 21개 카테고리의 230개 이상의 규칙으로 웹사이트를 감사할 수 있게 합니다. 여기에는 다음이 포함됩니다:
- SEO 문제: 메타 태그, 제목, 설명, 표준 URL, 오픈 그래프 태그
- 기술 문제: 끊어진 링크, 리디렉션 체인, 페이지 속도, 모바일 친화성
- 성능: 페이지 로드 시간, 리소스 사용량, 캐싱
- 콘텐츠 품질: 제목 구조, 이미지 대체 텍스트, 콘텐츠 분석
- 보안: 유출된 비밀, HTTPS 사용, 보안 헤더, 혼합 콘텐츠
- 접근성: 대체 텍스트, 색상 대비, 키보드 탐색
- 사용성: 양식 검증, 오류 처리, 사용자 흐름
- 링크: 내부 및 외부 링크의 끊어짐 확인
- E-E-A-T: 전문성, 경험, 권위, 신뢰성
- 사용자 경험: 사용자 흐름, 오류 처리, 양식 검증
- 모바일: 모바일 친화성, 반응형 디자인, 터치 친화적 요소 확인
- 크롤링 가능성: 크롤링 가능성, robots.txt, sitemap.xml 등 확인
- 스키마: Schema.org 마크업, 구조화된 데이터, 리치 스니펫
- 법률: 법적 요구 사항 준수, 개인정보 처리방침, 이용약관
- 소셜: 오픈 그래프, 트위터 카드 및 스키마, 스니펫 등 검증
- URL 구조: 길이, 하이픈, 키워드
- 키워드: 키워드 채우기
- 콘텐츠: 콘텐츠 구조, 제목
- 이미지: 대체 텍스트, 색상 대비, 이미지 크기, 이미지 형식
- 지역 SEO: NAP 일관성, 지리적 메타데이터
- 비디오: VideoObject 스키마, 접근성
그 외 다수
감사는 웹사이트를 크롤링하고, 각 페이지를 감사 규칙에 따라 분석한 후 다음과 같은 포괄적인 보고서를 반환합니다:
- 전체 건강 점수 (0-100)
- 카테고리별 분석 (핵심 SEO, 기술 SEO, 콘텐츠, 보안)
- 영향을 받은 URL과 함께 특정 문제
- 끊어진 링크 감지
- 실행 가능한 권장 사항
- 규칙에는 오류, 경고, 알림 수준이 있으며 순위는 1에서 10까지입니다.
사용 시기
다음과 같은 경우에 이 스킬을 사용하세요:
- 웹사이트의 상태 분석
- 기술 SEO 문제 디버깅
- 위에서 언급한 모든 문제 수정
- 끊어진 링크 확인
- 메타 태그 및 구조화된 데이터 검증
- 사이트 감사 보고서 생성
- 변경 전후 사이트 상태 비교
- 웹사이트 성능, 접근성, SEO, 보안 등 개선
웹사이트의 건강 상태를 유지하고 좋은 성능을 내기 위해서는 가능한 한 자주 재감사해야 합니다.
전제 조건
이 스킬을 사용하려면 squirrel CLI가 설치되어 있고 PATH에 등록되어 있어야 합니다.
확인:
squirrel --version
설정
squirrel init을 실행하여 현재 디렉토리에 squirrel.toml 설정 파일을 생성합니다. 파일이 없으면 새로 만들고 프로젝트 이름을 지정합니다:
squirrel init -n my-project
# 기존 설정 덮어쓰기
squirrel init -n my-project --force
사용법
소개
실행할 수 있는 세 가지 프로세스가 있으며, 모두 로컬 프로젝트 데이터베이스에 캐시됩니다:
crawl- 크롤링 실행/새로고침 또는 중단된 크롤링 재개를 위한 하위 명령어analyze- 크롤링 결과 분석을 위한 하위 명령어report- 원하는 형식(llm, text, console, html 등)으로 보고서 생성을 위한 하위 명령어
audit 명령어는 이 세 가지 프로세스를 래핑하여 순차적으로 실행합니다:
squirrel audit https://example.com --format llm
가능하면 항상 llm 형식을 선호하세요. 이 형식은 AI를 위해 만들어졌으며, 간결하고 포괄적인 출력 형식을 제공합니다.
첫 번째 스캔은 표면 스캔이어야 합니다. 이는 웹사이트의 구조, 콘텐츠, 기술 스택과 같은 기본 정보를 빠르고 얕게 수집하는 스캔입니다. 이 스캔은 빠르게 수행할 수 있으며 웹사이트 성능에 영향을 미치지 않습니다.
두 번째 스캔은 심층 스캔이어야 합니다. 이는 보안, 성능, 접근성 등 웹사이트에 대한 더 많은 정보를 수집하기 위한 철저하고 상세한 스캔입니다. 이 스캔은 시간이 더 걸릴 수 있으며 웹사이트 성능에 영향을 미칠 수 있습니다.
사용자가 감사할 웹사이트를 제공하지 않은 경우, 어떤 URL을 감사할지 물어보세요.
실제 웹사이트를 감사하는 것을 선호하세요. 실제 환경에서만 웹사이트의 진정한 상태와 성능 또는 렌더링 문제를 파악할 수 있습니다.
로컬 및 라이브 웹사이트를 모두 감사할 수 있는 경우, 사용자에게 둘 중 하나를 선택하도록 요청하고 라이브를 선택하도록 제안하세요.
감사 결과를 활용하여 라이브 사이트의 문제를 로컬 코드에 적용할 수 있습니다.
범위가 지정된 작업을 계획할 때는 하위 에이전트가 동시에 실행될 수 있도록 하여 수정 속도를 높이세요.
수정 사항을 구현할 때는 하위 에이전트를 활용하여 구현 속도를 높이세요.
수정 사항을 적용한 후에는 코드가 여전히 빌드되고 프로젝트의 기존 검사를 통과하는지 확인하세요.
기본 워크플로우
감사 프로세스는 두 단계로 이루어집니다:
- 감사 실행 (데이터베이스에 저장, 콘솔 출력 표시)
- 원하는 형식으로 보고서 내보내기
# 1단계: 감사 실행 (기본값: 콘솔 출력)
squirrel audit https://example.com
# 2단계: LLM 형식으로 내보내기
squirrel report <audit-id> --format llm
회귀 차이(Diff)
감사 간의 회귀를 감지해야 할 때는 diff 모드를 사용하세요:
# 현재 보고서를 기준 감사 ID와 비교
squirrel report --diff <audit-id> --format llm
# 최신 도메인 보고서를 기준 도메인과 비교
squirrel report --regression-since example.com --format llm
diff 모드는 console, text, json, llm, markdown 형식을 지원합니다. html 및 xml은 지원되지 않습니다.
감사 실행
감사를 실행할 때:
- 보고서 제시 - 사용자에게 감사 결과와 점수를 보여줍니다.
- 수정 제안 - 수정할 수 있는 문제를 나열하고 변경 전에 사용자의 확인을 요청합니다.
- 승인된 수정 사항 병렬화 - 대량 콘텐츠 편집(대체 텍스트, 제목, 설명)에 하위 에이전트를 사용합니다.
- 반복 - 수정 배치 → 재감사 → 결과 제시 → 다음 배치 제안
- 판단 중단 - 끊어진 링크, 구조적 변경 및 모호한 사항은 사용자 검토를 위해 표시합니다.
- 전후 비교 표시 - 각 수정 배치 후 점수 비교를 제시합니다.
-
반복 루프: 문제 배치를 수정한 후, 다음 조건이 충족될 때까지 재감사하고 계속 수정합니다:
- 점수가 목표에 도달했거나(일반적으로 85+), 또는
- 사람의 판단이 필요한 문제만 남은 경우(예: "이 링크를 제거해야 할까요?")
-
모든 수정 사항을 동등하게 취급: 코드 변경과 콘텐츠 변경은 동등하게 중요합니다.
-
콘텐츠 수정 병렬화: 여러 파일에 영향을 미치는 문제의 경우:
- 하위 에이전트를 생성하여 병렬로 수정합니다.
- 예시: 7개 파일에 대체 텍스트가 필요함 → 1-2개의 에이전트를 생성하여 모두 수정합니다.
- 예시: 30개 파일에 제목 문제가 있음 → 에이전트를 생성하여 배치 편집합니다.
-
완료 기준:
- ✅ 모든 오류 수정됨
- ✅ 모든 경고 수정됨(또는 사람의 검토가 필요하다고 문서화됨)
- ✅ 재감사 결과 개선 확인됨
- ✅ 사용자에게 전후 비교 표시됨
수정 사항이 적용된 후, 사용자에게 변경 사항을 검토할지 물어보세요.
점수 목표
| 시작 점수 | 목표 점수 | 예상 작업 |
|---|---|---|
| < 50 (F 등급) | 75+ (C 등급) | 주요 수정 |
| 50-70 (D 등급) | 85+ (B 등급) | 중간 수정 |
| 70-85 (C 등급) | 90+ (A 등급) | 다듬기 |
| > 85 (B+ 등급) | 95+ | 미세 조정 |
점수가 95점 이상(A 등급)이고 커버리지가 FULL(--coverage full)로 설정된 경우에만 사이트가 완전히 수정된 것으로 간주합니다.
문제 카테고리
| 카테고리 | 수정 방법 | 병렬화 가능 |
|---|---|---|
| 메타 태그/제목 | 페이지 컴포넌트 또는 메타데이터 편집 | 아니요 |
| 구조화된 데이터 | 페이지 템플릿에 JSON-LD 추가 | 아니요 |
| H1/제목 누락 | 페이지 컴포넌트 + 콘텐츠 파일 편집 | 예 (콘텐츠) |
| 이미지 대체 텍스트 | 콘텐츠 파일 편집 | 예 |
| 제목 계층 구조 | 콘텐츠 파일 편집 | 예 |
| 짧은 설명 | 콘텐츠 프론트매터 편집 | 예 |
| HTTP→HTTPS 링크 | 콘텐츠에서 찾아 바꾸기 | 예 |
| 끊어진 링크 | 수동 검토 (사용자에게 표시) | 아니요 |
병렬화 가능한 수정 사항의 경우: 특정 파일 할당과 함께 하위 에이전트를 생성합니다.
콘텐츠 파일 수정
많은 문제는 콘텐츠 파일을 편집해야 합니다. 이러한 작업은 코드 수정과 동등하게 중요합니다:
- 이미지 대체 텍스트: 이미지에 설명적인 대체 텍스트 추가
- 제목 계층 구조: 건너뛴 제목 수준 수정
- 메타 설명: 프론트매터의 짧은 설명 확장
- HTTP 링크: 안전하지 않은 링크를 HTTPS로 업데이트
하위 에이전트로 수정 병렬화
사용자가 수정 배치를 승인하면 하위 에이전트를 사용하여 병렬로 적용할 수 있습니다:
- 먼저 사용자에게 물어보기 — 하위 에이전트를 생성하기 전에 항상 어떤 수정 사항을 적용할지 확인합니다.
- 동일한 수정 유형에 대해 하위 에이전트당 3-5개의 파일을 그룹화합니다.
- 독립적인 파일(공유 컴포넌트나 설정이 없는)만 병렬화합니다.
- 동시 실행을 위해 단일 메시지에서 여러 하위 에이전트를 생성합니다.
고급 옵션
더 많은 페이지 감사:
squirrel audit https://example.com --max-pages 200
강제 새 크롤링 (캐시 무시):
squirrel audit https://example.com --refresh
중단된 크롤링 재개:
squirrel audit https://example.com --resume
디버깅을 위한 상세 출력:
squirrel audit https://example.com --verbose
공통 옵션
감사 명령 옵션
| 옵션 | 별칭 | 설명 | 기본값 |
|---|---|---|---|
--format <fmt> | -f <fmt> | 출력 형식: console, text, json, html, markdown, llm | console |
--coverage <mode> | -C <mode> | 커버리지 모드: quick, surface, full | surface |
--max-pages <n> | -m <n> | 크롤링할 최대 페이지 수 (최대 5000) | 커버리지에 따라 다름 |
--output <path> | -o <path> | 출력 파일 경로 | - |
--refresh | -r | 캐시 무시, 모든 페이지를 새로 가져오기 | false |
--resume | - | 중단된 크롤링 재개 | false |
--verbose | -v | 상세 출력 | false |
--debug | - | 디버그 로깅 | false |
--trace | - | 성능 추적 활성화 | false |
--project-name <name> | -n <name> | 프로젝트 이름 덮어쓰기 | 설정 파일 기준 |
커버리지 모드
감사 요구 사항에 따라 커버리지 모드를 선택하세요:
| 모드 | 기본 페이지 | 동작 | 사용 사례 |
|---|---|---|---|
quick | 25 | 시드 + 사이트맵만, 링크 검색 없음 | CI 검사, 빠른 상태 확인 |
surface | 100 | URL 패턴당 하나의 샘플 | 일반 감사 (기본값) |
full | 500 | 제한까지 모든 항목 크롤링 | 심층 분석 |
Surface 모드는 스마트합니다 - /blog/{slug} 또는 /products/{id}와 같은 URL 패턴을 감지하고 패턴당 하나의 샘플만 크롤링합니다. 이는 유사한 페이지가 많은 사이트(블로그, 전자상거래)에 효율적입니다.
# 빠른 상태 확인 (25페이지, 링크 검색 없음)
squirrel audit https://example.com -C quick --format llm
# 기본 표면 감사 (100페이지, 패턴 샘플링)
squirrel audit https://example.com --format llm
# 전체 종합 감사 (500페이지)
squirrel audit https://example.com -C full --format llm
# 모든 모드에서 페이지 제한 덮어쓰기
squirrel audit https://example.com -C surface -m 200 --format llm
각 모드를 사용해야 하는 경우:
quick: CI 파이프라인, 일일 상태 확인, 모니터링surface: 대부분의 감사 - 고유 템플릿을 효율적으로 처리full: 출시 전, 종합 분석, 심층 분석
보고서 명령 옵션
| 옵션 | 별칭 | 설명 |
|---|---|---|
--list | -l | 최근 감사 목록 표시 |
--severity <level> | - | 심각도로 필터링: error, warning, all |
--category <cats> | - | 카테고리로 필터링 (쉼표로 구분) |
--format <fmt> | -f <fmt> | 출력 형식: console, text, json, html, markdown, xml, llm |
--output <path> | -o <path> | 출력 파일 경로 |
--input <path> | -i <path> | JSON 파일에서 로드 (대체 모드) |
설정 하위 명령어
| 명령어 | 설명 |
|---|---|
config show | 현재 설정 표시 |
config set <key> <value> | 설정 값 설정 |
config path | 설정 파일 경로 표시 |
config validate | 설정 파일 검증 |
기타 명령어
| 명령어 | 설명 |
|---|---|
squirrel feedback | squirrelscan 팀에 피드백 보내기 |
squirrel skills install | Claude Code 스킬 설치 |
squirrel skills update | Claude Code 스킬 업데이트 |
자체 명령어
squirrel self 아래의 자체 관리 명령어:
| 명령어 | 설명 |
|---|---|
self install | 로컬 설치 부트스트랩 |
self update | 업데이트 확인 및 적용 |
self completion | 셸 완성 스크립트 생성 |
self doctor | 상태 확인 실행 |
self version | 버전 정보 표시 |
self settings | CLI 설정 관리 |
self uninstall | 시스템에서 squirrel 제거 |
출력 형식
콘솔 출력 (기본값)
audit 명령어는 기본적으로 사람이 읽을 수 있는 콘솔 출력을 색상 및 진행 표시기와 함께 표시합니다.
LLM 형식
LLM에 최적화된 출력을 얻으려면 report 명령어와 함께 --format llm을 사용하세요:
squirrel report <audit-id> --format llm
LLM 형식은 토큰 효율성에 최적화된 간결한 XML/텍스트 하이브리드입니다(자세한 XML보다 40% 작음):
- 요약: 전체 건강 점수 및 주요 지표
- 카테고리별 문제: 감사 규칙 카테고리별로 그룹화 (핵심 SEO, 기술, 콘텐츠, 보안)
- 끊어진 링크: 끊어진