scandiary

scandiary

Claude Code、Cursor、Lovable、または手作業で作成したサイトのアクセシビリティをチェックし、結果を修正プロンプトとして AI ツールに貼り付けます。

npx scandiary https://your-site.com
npx scandiary localhost:3000

サインアップも API キーも不要です。お使いのマシンにすでにインストールされている Chrome、Edge、または Brave を使用します。

修正プロンプトを取得する

npx scandiary https://your-site.com --prompt > fix-a11y.md

そのファイルをコーディングツールに貼り付けてください。各問題には、ページからの実例と適切な修正方法に関するメモが含まれています。プロンプトでは、オーバーレイスクリプトを使わないこと、合格させるためだけに要素を隠さないこと、新しいスキャンで確認するまで作業完了としないこともツールに伝えます。

Claude Code から使用する

スキルを一度インストールします。

mkdir -p ~/.claude/skills/scandiary
curl -o ~/.claude/skills/scandiary/SKILL.md https://raw.githubusercontent.com/Yedigarli/scandiary-cli/master/skills/scandiary/SKILL.md

次に、たとえば 「localhost:3000 のアクセシビリティをチェックして、見つかった問題を修正して」 のように、普通の言葉で依頼してください。Claude はチェックを実行し、コードを編集してから、数値を報告する前にもう一度チェックを実行します。推測で補ったラベルがあれば一覧表示するので、確認できます。

MCP サーバーとして使用する

Cursor、Claude Desktop、Windsurf、または任意の MCP クライアントで使用するには、クライアントの MCP 設定に次を追加します。

{
  "mcpServers": {
    "scandiary": {
      "command": "npx",
      "args": ["-y", "scandiary", "--mcp"]
    }
  }
}

url と省略可能な pages 件数を受け取り、修正プロンプトを返す check_accessibility ツールが追加されます。Claude Code では、claude mcp add scandiary -- npx -y scandiary --mcp を実行します。

オプション

オプション	機能
--pages <n>	チェックするページ数です。デフォルトは 5、最大は 100 です
--prompt	修正プロンプトのみを出力します
--json	結果全体を JSON 形式で出力します
--strict	問題が見つかった場合、CI 向けに終了コード 1 で終了します
--mcp	stdio 経由で MCP サーバーとして実行します

終了コード：0 は完了、1 は --strict で問題が見つかった場合、2 はチェックを実行できなかった場合です。

わかることと、わからないこと

このツールを含め、自動チェックで見つかるアクセシビリティの問題はおよそ 3 分の 1 です。残りの問題を見つけるには、キーボードとスクリーンリーダーを使う人による確認が必要です。

問題が少ない、あるいは問題がないからといって、サイトにアクセシビリティがあるとは限りません。いずれかの法的基準を満たしているかどうかも判断できません。

ルールは axe-core に基づいています：WCAG 2.0 および 2.1、レベル A と AA。

プロンプト内のページコンテンツは信頼できないデータとして扱われます。内容は平坦化・短縮され、内部に書かれた指示に AI ツールが従わないようマークされます。生成されたコードと同様に、ツールによる変更内容を確認してください。

プライバシー

チェックはお使いのマシン上で実行されます。このツールはテレメトリーを送信せず、分析機能もありません。ブラウザーは、通常の閲覧と同じように、チェック対象として指定したページと、それらのページが読み込むコンテンツを開きます。

毎週のチェック

一度だけのスキャンでわかるのは、今日の状況です。Scandiary は毎週チェックを実行し、変更点をメールで知らせるため、日付付きの履歴を保管できます。無料プランでは 25 ページまで利用できます。

ライセンス

MIT