나는 실제로 자체 감사를 통과하는 무료 접근성 감사 도구를 만들었다

발행: (2026년 3월 18일 AM 10:49 GMT+9)
6 분 소요
원문: Dev.to

Source: Dev.to

대부분의 무료 접근성 도구에는 접근성 문제가 있습니다.

  • WAVE – 키보드 전용 워크플로가 없는 브라우저 확장 프로그램.
  • Lighthouse – Chrome DevTools에서 실행되며, 화면 읽기 프로그램 사용자가 우회 방법으로 탐색해야 함.
  • axe DevTools (무료 티어) – WCAG 매핑이 없는 결과를 제공하며, 매핑을 보려면 비용을 지불해야 함.

저는 미시간 주 그랜드래피즈에 있는 CIS 학생이며, 부업으로 웹 접근성 작업을 프리랜서로 하고 있습니다. 고객과의 프로젝트에서 실제로 사용할 수 있는 도구가 필요했습니다—구조화된 출력, WCAG 매핑된 결과, 심각도 그룹화—하지만 월 $200을 내고 플랫폼을 쓰고 싶지는 않았습니다.

그래서 직접 만들었습니다.

무엇을 하는가

MAS Accessibility Audit Toolkit은 파이썬과 Tkinter로 만든 무료 오픈소스 데스크톱 GUI입니다. URL을 붙여넣고 Run Audit을 클릭하면 60초 이내에 구조화된 결과 보고서를 얻을 수 있습니다.

현재 WCAG 2.1 AA 기준 14개의 검사 모듈을 실행합니다:

  • Alt 텍스트 감지
  • 헤딩 구조 (h1 개수 + 하위 순서)
  • 폼 라벨 연결
  • 언어 속성 존재 여부
  • tabindex 남용 (양수 값)
  • 빈 링크 및 빈 버튼
  • 자동재생 미디어 감지
  • PDF 링크 경고 (사용자 알림 없음)
  • 페이지 제목 검사
  • 중복 ID 감지
  • 랜드마크 역할 (main, nav, header, footer)
  • 스킵 내비게이션 링크 검사
  • 접근성 패턴 (일반 링크 텍스트, placeholder‑as‑label, 비대화형 요소에 onclick, 테이블 헤더 누락, 빈 target)

추가 62개 모듈이 대기 중이며—색 대비, 화면 읽기 시뮬레이션, 플랫폼 감지, 터치 타겟 CSS 검사 등을 포함합니다.

가장 자랑스러운 부분

감사 도구 자체가 완전히 접근 가능합니다. 자체 감사를 통과하지 못하는 접근성 도구는 변명할 수 없습니다.

접근성 기능

  • 네 가지 테마: 다크, 라이트, 고대비, CVD‑Safe
  • CVD 시뮬레이션 모드: 프로타노피아, 디우테라노피아, 트리타노피아, 모노크롬 (도구 내부)
  • 난독증 폰트 프리셋 – 일반, 크게, 아주 크게 (세션 간 유지)
  • 폰트 패밀리 및 크기 조절 – 14 pt부터 20 pt까지, 사용자 조정 가능, 지속 저장
  • 단어 간격 및 줄 높이 슬라이더 – 지속 저장
  • 스크린 리더 알림 – 테마 변경, 스캔 완료, 오류 상태 시
  • 색이 아닌 접두사 표시: 오류는 [!], 통과는 [OK], 정보는 [>] (색만으로는 충분하지 않음)

이러한 기능은 WAVE, Lighthouse, 혹은 내가 사용해 본 어떤 도구의 무료 티어에서도 찾아볼 수 없습니다. 접근성을 위한 접근성 감사 도구가 바로 핵심 포인트입니다.

할 수 없는 것

자동화 도구는 WCAG 위반 중 대략 **30–40 %**만 잡아냅니다. MAS Toolkit도 같은 범위에 속합니다. 정적 HTML 분석만 수행하므로 다음은 할 수 없습니다:

  • 키보드 인터랙션 테스트
  • 실제 보조 기술에서의 화면 읽기 프로그램 알림 평가
  • 사용자 테스트를 통한 인지 부하 평가

빠르고 구조화된, WCAG 매핑된 시작점이지만—수동 검토를 대체할 수는 없습니다. 저는 모든 고객 계약에서 이를 명확히 밝히며, 감사 보고서에도 명시합니다. 범위에 대한 정직함은 부인 조항이 아니라 기능입니다.

앞으로의 방향

다음 단계에서는 플랫폼 감지를 추가합니다—클라이언트 사이트가 잠긴 CMS(예: Squarespace, Wix 등)인지 식별하고, 모든 결과에 PLATFORM RESTRICTED 표시를 붙여, 수정 로드맵을 제공해도 수정이 불가능한 경우를 방지합니다.

향후 마일스톤:

  • 색 대비 검사
  • 뷰포트 메타 검사
  • 터치‑타겟 CSS 검사
  • Stripe 결제와 팀 접근 권한을 갖춘 웹 SaaS 버전

사용해 보기

  • GitHub:
  • MIT 라이선스 – 자유롭게 사용, 포크, 확장 가능.

접근성 작업을 하시면서 모듈 목록, 결과 형식, 혹은 다른 부분에 대한 피드백이 있다면 알려 주세요—공개적으로 개발하고 있으며, 무엇이 빠졌는지 알고 싶습니다.

0 조회
Back to Blog

관련 글

더 보기 »

오픈소스를 위한 지속적인 운영

Ryan은 Chainguard CEO인 Dan Lorenc와 함께 앉아 그의 팀이 인터넷의 기반인 오픈 소스 프로젝트를 포킹 아카이브를 통해 어떻게 살아 있게 유지하고 있는지에 대해 이야기합니다.