줍줍분석기 ZUPZUP·ANALYZER

사용자 가이드

줍줍분석기 사용 가이드 — 설치부터 결과 해석까지.

어떤 도구를 골라야 할지, 분석 결과가 안 보일 때 무엇을 확인할지, 점수가 무엇을 뜻하는지 한 페이지에 모았습니다.

어떤 걸 쓰면 좋은가

익스텐션 권장
  • 한 번 설치하면 모든 페이지 자동
  • strict CSP 사이트(은행·금융·매거진 등)도 그대로 분석
  • 로그인 페이지 분석 시 쿠키 자동 전달
  • Alt+Z 단축키 / Esc 닫기 / Tab 포커스 trap
북마클릿 대안
  • 설치 / 권한 / 계정 없이 한 번 드래그
  • Chrome 스토어 못 쓰는 회사 PC에서도 동작
  • 일부 strict CSP 사이트에서 차단됨 (해결책은 익스텐션)
  • 같은 분석 패널, 같은 결과

strict CSP 사이트에서 북마클릿이 안 돼요

은행·금융·일부 매거진처럼 connect-src 'self'를 엄격하게 설정한 페이지는 북마클릿이 분석기 자산을 다운받지 못해 차단됩니다. (보안적으로는 잘 설정된 사이트입니다.)

해결 — Chrome 익스텐션을 사용하세요. 익스텐션은 content script로 페이지 CSP와 무관하게 분석합니다.

※ vlyvly.me 자체도 strict CSP라 vlyvly.me 페이지 분석은 익스텐션 권장.

점수가 뜻하는 것

4축 점수(SEO · GEO · AEO · A11Y) — 축마다 가중치가 다릅니다. 종합 점수는 SEO·A11Y가 가장 무겁고 GEO가 가장 가볍게 반영되는 가중 평균입니다. 발견된 이슈의 심각도(critical / warning / info)에 따라 페널티 크기도 달라집니다.

축 옆 작은 별표(*)나 점수 hover 시 나오는 tooltip은 "이 축에 적용된 분석기 중 실제로 발화한 비율"입니다. 비율이 너무 낮으면(예: 정적 페이지 A11Y) 점수가 100점에 가깝게 나와도 "검사 대상이 부족"한 것으로 해석해야 합니다.

점수 공식 자세히 보기 (개발자용)
  • 축 점수 = 100 − (이슈 weight × severity factor 합 ÷ 적용 가능 분석기 weight 합) × 100
  • severity factor: critical 1.0 / warning 0.55 / info 0.1
  • 종합 점수 = SEO×0.30 + A11Y×0.30 + AEO×0.25 + GEO×0.15 (Lighthouse 풍 가중 평균)
  • page-type 보정: 분석기 중 일부는 페이지 종류에 따라 적용 여부가 다릅니다 (예: Article 룰은 article 페이지에서만 분모에 포함).
  • coverage 신호: 발화한 분석기 수 / 적용 가능 분석기 수. 너무 낮으면 점수보다 신뢰 신호로 해석.

프라이버시 — 분석 본문은 어디로도 안 갑니다

  • 모든 분석은 사용자 브라우저 안에서 실행됩니다. 페이지 HTML 본문 / 메타데이터 본문 / 자산 URL은 외부 서버로 전송되지 않습니다.
  • "결과 복사" / "내보내기"는 사용자 클립보드 / 다운로드 폴더로만 갑니다.
  • "문의하기" form을 제출하면 입력하신 이름·이메일·메시지만 Resend를 통해 support@vlyvly.me로 전달됩니다. 분석한 페이지 URL은 첨부되지만 페이지 본문은 전송되지 않습니다.
  • 사용량 통계 — 분석할 때마다 도메인(example.com) + 페이지 제목 + 4축 점수가 익명으로 운영자(VLYVLY)에 전송됩니다. IP·식별 정보·페이지 본문 일체 없음. 도구 사용 빈도 파악 + 분석기 개선 입력으로만 사용.
  • 익스텐션은 activeTab·storage·scripting 권한만 사용합니다. 백그라운드 추적·광고 식별·계정 정보 수집 일체 없음.

자주 묻는 질문

Q. 분석 결과가 어디로 전송되나요?

아니요. 모든 분석은 브라우저 안에서 실행되고 결과도 화면에만 표시됩니다. 결과를 공유하려면 패널의 "결과 복사" 또는 "내보내기"를 사용하세요.

Q. 한국어 사이트만 분석 가능한가요?

아니요, 어떤 사이트든 분석 가능합니다. 내부 분석기 중 일부(lang 검증, 한국어 lazy alt 패턴, 스킵 링크 한국어 어구 등)는 한국어 사이트 특화 휴리스틱이지만 외국 사이트 분석에도 대부분의 룰이 그대로 적용됩니다.

Q. 점수가 너무 후하게 나옵니다.

단순한 정적 페이지는 인터랙티브 요소(button·form·video·ARIA 등)가 거의 없어 접근성 룰 대부분이 검사 대상에서 빠집니다. 점수 옆 * 또는 tooltip이 그 신호입니다. 진짜 "통과"는 콘텐츠와 인터랙션이 추가된 뒤 다시 분석해서 확인하세요.

Q. 로그인이 필요한 페이지도 분석 가능한가요?

네. 익스텐션은 사용자가 이미 로그인한 상태 그대로 분석합니다. 북마클릿도 페이지 안에서 실행되므로 동일합니다. 다만 strict CSP 페이지에서는 북마클릿 차단 가능.

Q. 분석 결과를 PDF로 받을 수 있나요?

현재는 JSON 내보내기만 지원합니다. PDF / Markdown 자동 생성은 유료 모델로 준비 중.

Q. 모바일 / 태블릿에서도 사용 가능한가요?

북마클릿은 모바일 Chrome 일부 환경에서 제한적입니다. 익스텐션은 데스크탑 Chrome 전용 (Chrome 128+). 모바일 분석은 데스크탑 브라우저 모바일 모드 또는 별도 도구 사용 권장.

Q. 같은 페이지를 다시 분석하려면?

패널 하단의 "다시 분석" 버튼을 누르면 페이지를 새로고침합니다. 그 다음 다시 익스텐션 아이콘 / 북마클릿을 클릭하세요.

Q. 발견한 이슈가 사실은 의도된 디자인이에요.

분석기는 휴리스틱이라 false positive 가 있을 수 있습니다. 패널 하단 "문의하기"로 알려 주세요 — 다음 버전에 반영됩니다. 실제로 vlyvly.me 홈팀 피드백 4건을 Phase 5에서 fix 했습니다.

문의

분석 결과 / 도구 동작 / 신규 룰 제안 — 분석기 패널 안에서 카테고리를 열고 "문의하기"를 누르거나, 직접 메일로 support@vlyvly.me.