A11y Check

Name: A11y Check
Author: a11ychk.com

本地服务

a11ychk.com开发工具31 天前更新

代码仓库访问官网

关于 A11y Check

A11y Check 是面向开发者和无障碍审查人员的网页自动审计工具，将问题同时映射到 WCAG 2.2 与 KWCAG 2.2。它提供韩语修复指南，并生成可供 AI 编码工具使用的修改请求。

主要功能

01WCAG 2.2 与 KWCAG 2.2 双重映射
02韩语问题修复指南
03生成 Markdown 和 JSON 修改请求
04导出 PDF、CSV 和 EARL 报告
05提供 Chrome 扩展与 GitHub Action

适用场景

01检查网页并定位无障碍问题
02为 AI 编码工具准备修复请求
03在 PR 或部署前自动检查页面

MCP 相关

提供 MCP 服务，让 Claude Code、Cursor 等 AI 编码工具调用网页检查引擎并获取韩语修复指南。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "com-a11ychk": {
      "command": "npx",
      "args": [
        "-y",
        "@a11ychk/mcp"
      ]
    }
  }
}

启动命令npx -y @a11ychk/mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@a11ychk/mcp0.2.5stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
url	string	是	要检查的页面 URL（http/https 或 file://）
lang	enum	否	结果语言（默认 ko）ko \| en

详细介绍

A11y Check · 알리첵

WCAG 2.2 + KWCAG 2.2 双重映射的韩语优先 Web 无障碍自动检查引擎

输入一个 URL，即可采集代表性页面并检查无障碍情况，还能生成韩语改进指南以及供 AI 编码工具使用的修复请求文档。这是一项开源服务。

🔗 在线演示 a11ychk.com · 安装 Chrome 扩展 · 受检网站目录 · 影响指标 · English README

开源 Web 无障碍审计工具，将每项检查结果同时映射到 WCAG 2.2 和 KWCAG 2.2（韩国国家无障碍指南），并为全部 33 项 KWCAG 2.2 检查项提供韩语修复指南。

为什么选择 A11y Check

大多数自动检查工具只会用英语罗列违规项。A11y Check 不止于诊断，还会生成推动改进工作的产出。

🇰🇷 KWCAG 2.2 韩语规则目录 — 将 packages/core/src/catalog 中的 113 条规则（axe-core 98 条 + 自定义 15 条；最新数据见覆盖率文档）与 WCAG 2.2 成功标准和 KWCAG 2.2 检查项（33 项）双重映射，并为每条规则提供韩语改进指南。该目录本身也是对无障碍从业者和开发者独立有用的资源。
🔧 诊断 → 修复衔接 — 自动为每项违规生成韩语改进方法，以及可直接输入 AI 编码工具（如 Cursor、Copilot）的修复请求文档（Markdown·JSON）。
🧭 遵循 WCAG-EM 2.0 方法论 — 遵循结构化评估流程：选择代表性页面样本 → 自动检查 → 检查人员判定 → 汇总合规率，并可导出 EARL 报告。
🙅 诚实的自动化 — 不会隐瞒自动检查无法确定的项目，而是同时提供人工检查方法。不宣称“100% 自动通过”。
🧩 Chrome 扩展 — 在侧边栏中实时检查当前页面，并将违规项直接显示在页面上。

自动检查工具只能发现部分无障碍问题。本项目会明确说明其局限，并坚持为需要人工确认的项目提供相应的检查方法。

功能

	功能
检查	axe-core + 自定义规则（重排、焦点指示、键盘、替代文本质量、媒体、标记有效性等）+ 网站级检查（标题唯一性、导航一致性、多种方式）
映射	将所有违规项同时对应到 WCAG 2.2 成功标准和 KWCAG 2.2 检查项
报告	自动/人工/综合合规率、KWCAG 33 项矩阵、认证准备情况摘要、前后对比、PDF·CSV·EARL 导出
改进	各规则的韩语指南 + AI 修复请求文档（MD/JSON）
扩展	Chrome MV3 侧边栏 — 实时检查、结构可视化、障碍模拟、对比度吸管、专家判定
快速体验	无需登录即可即时检查 1 个 URL（1 个页面）— 可直接在首页体验，并提供机器人防护和次数限制
运营	域名所有权验证、定期自动检查、回归提醒、嵌入徽章、公开检查目录、好友邀请等级等
CI	通过 GitHub Action 在 PR 和部署前设置自动检查门禁 — 使用方法
MCP	Claude Code、Cursor 等 AI 编码工具可直接调用检查和韩语指南 — 使用方法

在 CI 中立即使用

每个 PR 都会检查指定页面；如果存在严重及以上级别的违规项，则任务会失败。结果会以 Markdown 表格的形式显示在任务摘要中。

- uses: IsaacEryn/a11ychk@v1
  with:
    urls: |
      https://example.com/
      https://example.com/login
    fail-on: serious

输入、输出及固定版本的方法见 docs/github-action.md。

在 AI 编码工具中立即使用（插件 · MCP）

在 Claude Code 中，只需安装一个插件，即可同时安装 2 种审计技能和检查引擎（MCP 服务）。可以直接检查开发中的 localhost 页面，获取每项违规对应的韩语改进指南并进行修复，然后在同一段对话中完成复查。

/plugin marketplace add IsaacEryn/a11ychk
/plugin install a11ychk@a11ychk

/a11ychk:a11y-audit — 检查 → 修复 → 复查循环（部署前检查）
/a11ychk:kwcag-audit — 从 KWCAG 2.2 的 33 项检查项角度进行检查

如果只需使用 MCP 服务（也包括 Cursor 等其他客户端）：

claude mcp add a11ychk -- npx -y @a11ychk/mcp

{
  "mcpServers": {
    "a11ychk": { "command": "npx", "args": ["-y", "@a11ychk/mcp"] }
  }
}

工具配置和安装说明见 docs/mcp.md。

结构（npm workspaces 单体仓库）

packages/core     @a11ychk/core — 검사 엔진 (오픈소스의 심장)
  src/crawler/      대표 페이지 수집 (sitemap → 내부 링크, robots.txt 존중)
  src/scanner/      axe-core 실행·결과 정규화 (Playwright Page 주입형) + 유한 애니메이션 종료 대기·2-패스 안정성 필터
  src/catalog/      규칙 카탈로그 → WCAG 2.2 · KWCAG 2.2 이중 매핑 + 한국어 개선 가이드
  src/manual/       수동 검사 항목 정의 (KWCAG 33개 중 자동 판정 불가 항목)
  src/report/       보고서 집계 (준수율, KWCAG 매트릭스, 사이트 수준 검사)
  src/security/     SSRF 가드 (사설 IP·DNS 리바인딩·redirect 차단), robots.txt 파서
packages/mcp      @a11ychk/mcp — AI 코딩 도구용 MCP 서버 (npm)
apps/web          Next.js 16 서비스 앱 (a11ychk.com)
apps/extension    크롬 확장 (MV3 Side Panel)
action            GitHub Action 러너 (워크스페이스 밖 독립 패키지 — 소비자 CI가 직접 설치)
supabase          DB 마이그레이션 + RLS 정책
docs              아키텍처 · 로드맵 · 운영 설정

快速开始

npm install
cp apps/web/.env.example apps/web/.env.local   # Supabase 키 등 입력
npx playwright install chromium                 # 로컬 스캔용 브라우저
npm run dev                                     # http://localhost:3000

Chrome 扩展可直接从**Chrome 网上应用店**安装。如需从源代码构建，请运行 npm run build -w @a11ychk/extension → 在 chrome://extensions 中以解压缩方式加载 apps/extension/dist。Supabase 设置请参阅 docs/SETUP.md。

기술 스택

Next.js 16 (App Router) · TypeScript · Tailwind CSS v4 · next-intl(ko/en) · Supabase (Auth + PostgreSQL/RLS) · playwright-core + @sparticuz/chromium · axe-core 4.12 · Zod · Vercel

테스트

npm run test                        # core 유닛 테스트 + 웹 테스트
npm run test:e2e -w @a11ychk/core   # 실제 크로미엄으로 fixture 스캔 E2E
npm run typecheck && npm run lint

보안 원칙

모든 시크릿은 환경변수로만 관리 — 저장소에는 .env.example만 존재
사용자 입력 URL은 SSRF 가드(스킴 검증 → DNS resolve → 사설 대역 차단 → 브라우저 DNS 핀 → redirect 재검증)를 통과
Supabase RLS로 사용자 데이터 격리, service role은 서버에서 권한 검증 후에만 사용
검사 횟수 제한(일/주/월) + robots.txt 존중, CSP nonce·표준 보안 헤더 적용

기여

규칙 카탈로그(packages/core/src/catalog)의 한국어 개선 가이드 보강·매핑 교정·새 규칙 제안 PR을 가장 환영합니다. 코드가 아니어도 기여입니다 — CONTRIBUTING.md 참고.

도움이 되었다면 ⭐️ Star로 프로젝트를 응원해 주세요. 한국어 접근성 도구 생태계를 함께 키웁니다.

라이선스

분할 라이선싱 — 자세한 내용은 LICENSING.md 참고.

검사 엔진·규칙 카탈로그 (packages/core) · MCP 서버 (packages/mcp) · 크롬 확장 (apps/extension) · GitHub Action (action/) → Apache-2.0: 자유롭게 사용·수정·재배포·통합할 수 있습니다.
서비스 앱 (apps/web) → AGPL-3.0-only: 열려 있지만, 이 앱을 수정해 네트워크 서비스로 운영하면 수정 소스를 공개해야 합니다.