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"]
    }
  }
}

它会添加一个工具 check_accessibility，该工具接受 url 和可选的 pages 数量，并返回修复提示词。在 Claude Code 中：claude mcp add scandiary -- npx -y scandiary --mcp。

选项

选项	作用
--pages <n>	要检查的页面数。默认值为 5，最大值为 100
--prompt	仅打印修复提示词
--json	以 JSON 格式打印完整结果
--strict	发现问题时以代码 1 退出，供 CI 使用
--mcp	通过 stdio 作为 MCP 服务运行

退出代码：0 已完成，1 使用 --strict 时发现问题，2 无法运行检查。

此工具能告诉你什么，不能告诉你什么

自动检查只能发现约三分之一的无障碍问题，本工具也不例外。其余问题需要有人使用键盘和屏幕阅读器进行检查。

问题列表很短，甚至为空，都不代表你的网站具备无障碍性。它也不能说明你是否符合任何法律标准。

规则来自 axe-core：WCAG 2.0 和 2.1 的 A 级和 AA 级。

提示词中的页面内容会被视为不可信数据。它会被扁平化、缩短并加上标记，以便你的 AI 工具不会遵循其中写下的任何内容。请像审核任何生成的代码一样，审核工具所做的更改。

隐私

检查在你的机器上运行。本工具不会发送遥测数据，也不包含分析功能。浏览器会打开你要求检查的页面，以及这些页面加载的所有内容，就像正常访问一样。

每周检查

单次扫描只能告诉你当前的情况。Scandiary 会每周运行检查并通过电子邮件发送变更内容，让你保留带日期的历史记录。免费套餐支持 25 个页面。

许可证

MIT