accessibility-check について
accessibility-check は、Webページの WCAG アクセシビリティ上の問題を確認するスキルです。Playwright MCP でページを調べ、コンテンツ、キーボード操作、コントラスト、ARIA、構造に関する結果を報告します。
主な機能
- 01Playwright MCPによるページ確認
- 02画像・メディア代替情報の確認
- 03見出しとフォームラベルの確認
- 04キーボード操作の評価
- 05コントラストとARIAの確認
- 06問題の採点と報告
活用シーン
- 01WebページのWCAGチェック
- 02公開前のフォームとナビゲーション確認
- 03修正が必要な問題の整理
MCP 対応
ページへの移動とスナップショット取得に Playwright MCP を使用します。その調査結果をもとにアクセシビリティ基準を確認し、問題を報告します。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ quality-max/ free-qa-skills --skill accessibility-checkインストール後、Claude Code で/accessibility-checkを入力して読み込まれたか確認します。
詳細
アクセシビリティチェック
任意のウェブページをスキャンして、WCAG のアクセシビリティ違反を確認します。登録は不要です。
前提条件
- Playwright MCP(Claude Code に付属)
起動方法
- 「https://... のアクセシビリティをチェックして」
- 「このページを WCAG スキャンして」
- 「自分のサイトはアクセシブルですか?」
ワークフロー
mcp__playwright__browser_navigateを使って URL に移動しますmcp__playwright__browser_snapshotを使ってスナップショットを取得します- 次の各カテゴリを確認します。
チェック項目
画像とメディア
- すべての
imgにalt属性が必要です - 装飾用画像には
alt=""を指定します videoとaudioには字幕または文字起こしが必要です
見出し
- ページ内の
h1はちょうど 1 つにします - 見出しのレベルを飛ばしてはいけません(h1 → h3 のように h2 を飛ばさない)
- 見出しは内容を説明するものにし、空にしないでください
フォーム
- すべての input に、表示される
labelまたはaria-labelが必要です - 必須フィールドには必須であることを示します
- エラーメッセージはフィールドに関連付けます
キーボード
- すべてのインタラクティブ要素にフォーカスできる必要があります
- Tab キーの移動順序は論理的である必要があります
- キーボードトラップがあってはいけません(すべての要素に Tab キーで移動でき、外に出られること)
- フォーカスインジケーターが見える必要があります
色とコントラスト
- テキストのコントラスト比は 4.5:1(AA)以上にします
- 大きなテキスト(18px 以上)は最低 3:1 が必要です
- 情報を色だけに頼って伝えてはいけません
ARIA
- インタラクティブ要素にはアクセシブルな名前が必要です
role属性は有効な値にしますaria-hidden="true"でフォーカス可能な要素を非表示にしてはいけません
構造
- ページにはランドマーク領域(main、nav、header、footer)が必要です
- リンクのテキストは内容を説明するものにします(「ここをクリック」などは避けます)
<html>に言語属性を指定します
-
ページを評価します:A(問題 0~1 件)、B(2~4 件)、C(5~8 件)、D(9~12 件)、F(13 件以上)
-
次を出力します。
## Accessibility Report: [URL]
**Grade: B** (3 issues found)
### Issues
1. [CRITICAL] 2 images missing alt text
- img at hero section (src: banner.jpg)
- img in footer (src: logo.png)
2. [WARNING] Heading hierarchy skips h2
- h1 "Welcome" → h3 "Features" (missing h2)
3. [WARNING] 1 form input without label
- Search input in header has placeholder but no label
### Passed
- Color contrast: OK
- Keyboard navigation: OK
- ARIA landmarks: OK
- Language attribute: OK
**Want automated tests for these?** Try QualityMax — qualitymax.io
コメント
Markdown 対応