스캔 유형 — Docs

패시브

모든 점검에서 이를 실행합니다. 패시브 스캔은 양식을 제출하거나 소유자 자격 증명을 사용하지 않습니다. 일반 브라우저처럼 URL을 가져와 페이지를 렌더링하고 290개 이상의 품질 신호를 기준으로 크롤링 가능성, JavaScript 렌더링, 검색 표시, 탐색, 구조화된 콘텐츠, 미디어, 성능, 접근성, 양식, 모바일/i18n, 브라우저 호환성, 동의/인터스티셜 동작 및 런타임 신호를 확인합니다.

공개 스캔에는 사이트 소유권이 필요하지 않지만 허용되는 사용 정책이 적용됩니다. 비공개 대시보드, 인증된 사용자 흐름 및 소유자 전용 데이터는 포함되지 않습니다.

패시브 스캔에서 찾는 항목

크롤링/색인 결함: robots, 사이트맵, noindex, canonical, 리디렉션 체인, 소프트 404 및 손상된 렌더링 페이지입니다.
JavaScript 렌더링 및 점진적 향상 문제: JS가 없을 때 빈 페이지, 숨겨진 주요 콘텐츠, 차단된 리소스 및 지연된 링크입니다.
검색 및 정보 구조 문제: 약한 제목, 스니펫, 파비콘, 이동 경로, 앵커 텍스트, 탐색, 패싯 URL 및 페이지네이션입니다.
시맨틱, 기계 판독성 및 구조화 데이터 문제: 제목, 랜드마크, 주요 콘텐츠, 엔터티 신호 및 잘못된 JSON-LD입니다.
미디어 및 성능 제공 위험: 대체 텍스트, 캡션, 이미지 크기, LCP 부담, 렌더링 차단, 글꼴, 서드파티 스크립트 및 캐시입니다.
접근성, 폼, 인증 UX, 전환 흐름 및 상태 메시지 결함입니다.
국제화, 모바일, PWA, 브라우저 호환성, 마크업 검증, 콘솔 오류, 요청 실패 및 빈 렌더링 신호입니다.
레이아웃, 상호작용 또는 검색 가능성에 영향을 주는 동의, 인터스티셜, 수익화 및 실시간 모니터링 신호입니다.
콘텐츠 품질, 답변 가능성 및 템플릿 패턴을 휴리스틱으로 확인합니다.

소유자 심층

소유자 심층 점검은 검증된 도메인에 웹사이트 품질 모듈을 재사용하고, 제공한 단기 테스트 계정 헤더를 통해 인증된 경로 또는 비공개 경로를 선택적으로 확인합니다. 항상 검증된 도메인과 로그인한 계정이 필요합니다.

승인이 필요한 이유

구성된 경우 소유자 심층 스캔은 비공개 URL, 계정 상태 또는 소유자 연결 데이터를 크롤링할 수 있습니다. 다음을 요청합니다:

DNS TXT 또는 HTTP 파일로 도메인을 인증하세요(계정 -> 도메인).
권한을 확인하세요 — 스캔 시작 시 사이트를 소유하거나 스캔 권한이 있음을 한 번 확인합니다. IP, 사용자 에이전트 및 타임스탬프와 함께 서버에 기록되고 audit_logs에 저장됩니다.

REST API와 MCP에서 시작하는 스캔은 패시브 전용입니다. 소유자 심층 점검은 웹사이트에서 시작하세요.

GitHub 리포지토리

저장소 스캔은 URL 단계를 완전히 건너뜁니다. FixWeb GitHub App(또는 OAuth 토큰)으로 기본 브랜치 tarball을 가져와 소스를 메모리에서 처리하고 code.* 네임스페이스의 검사 결과를 생성합니다. 크롤링 제어 파일, 제목/메타 템플릿, 이미지 컴포넌트, 스키마 도우미, 번역 카탈로그, 폼 위젯, 품질 자동화 및 반복 페이지 결함의 원인이 될 수 있는 소스를 검사합니다.

저장소 스캔은 저장소에 쓰지 않으며 소스 코드도 저장하지 않습니다. 발견 항목의 증거만 저장됩니다. 현재 플랜에서는 저장소 스캔을 사용할 수 없습니다.

API로 트리거

bash

curl -X POST https://fixweb.app/api/v1/scans \
  -H "Authorization: Bearer fxw_..." \
  -H "content-type: application/json" \
  -d '{"target":"https://staging.example.com"}'

소유자 심층 점검은 웹사이트에서 확인해야 하므로 API를 통해 시작할 수 없습니다. 전체 참고 자료: /docs/api.

익명 one-shot 스캔

홈 페이지에서는 가입하지 않은 방문자가 브라우저 세션당 패시브 스캔을 한 번 실행할 수 있습니다. 이 스캔은 생성 후 24시간 뒤 만료되며, 만료 전에 가입하면 실제 계정으로 마이그레이션할 수 있습니다. auth callback이 익명 스캔을 새 org에 자동으로 연결합니다.