Web Validator MCP by DigestSEO

DigestSEO 的 Web Validator

一个用于 HTML 和 CSS 验证、技术 SEO 与无障碍检查、JSON-LD 语法验证、失效链接检查以及响应式截图的 MCP 服务。它是 DigestSEO 开源 SEO 工具套件的一部分。

• 产品：digestseo.com/validator-mcp
• 工程案例：DigestSEO MCP Suite — AI visibility, Search Console, web validation, and trend intelligence
• 文档：本 README
• 支持：digestseo.com/support
• 隐私：digestseo.com/privacy

选择合适的接入方式

此代码库包含两个有意分开的 MCP 接入方式：

接入方式	传输方式	适用场景	访问权限和副作用
本地 npm 服务	stdio	Claude Desktop、Cursor 和其他本地 MCP 客户端	可以读取用户选择的工作区文件、连接验证目标和链接目标，并写入截图文件。
托管应用	Streamable HTTP	ChatGPT 和远程 MCP 客户端	可以获取一个经过授权的公开 HTML 页面、运行范围受限且优先检查站点地图的网站审计，或处理提供的标记。无法访问本地文件、进行身份验证、递归抓取链接、执行页面 JavaScript 或创建截图。

本地安装：

npx -y mcp-web-validator

托管端点：

https://web-validator-mcp.digestseo.com/mcp

要求

• Node.js 22.12.0 或更高版本
• 支持 stdio 的 MCP 客户端，或支持托管端点 Streamable HTTP 的客户端

验证、SEO、架构、链接和报告工具在安装时不会下载浏览器。本地 screenshot.capture 工具会在首次使用时将固定版本的无头浏览器安装到 Puppeteer 缓存中，之后的截图会复用该浏览器。如需自定义缓存位置，请设置 PUPPETEER_CACHE_DIR。

工具

npm 包公开了以下确切的运行时工具名称：

工具	用途	网络或文件系统行为
html.local	验证本地 HTML 或 XHTML 文件。	读取所选文件，并将其标记语言提交给外部 W3C Nu HTML Checker（位于 validator.w3.org/nu/）；.xhtml 路径采用 application/xhtml+xml 解析语义。
html.url	验证公共 URL 返回的标记语言。	获取该 URL，然后将返回的标记语言提交给外部 Nu 检查器。
css.local	验证本地 CSS 文件。	读取所选文件，并将其 CSS 提交给外部 W3C Jigsaw CSS Validator。
seo.metadata	审核标题、描述、规范链接标签、robots noindex 指令、标题、视口元数据、图像 alt 属性和 Open Graph 元数据。	在本地处理提供的 HTML。
links.broken	检查从提供的 HTML 中提取的链接。	向符合条件的公共链接发送数量受限的 HTTP 请求。
schema.markup	解析 JSON-LD 块并报告 JSON 语法错误。	在本地处理提供的 HTML。
report.validation	在 Markdown 报告中汇总 HTML/XHTML、可选 CSS、SEO、JSON-LD 和数量受限的链接检查。	读取所选文件、联系验证器，并检查标记语言中符合条件的公共链接；.xhtml 输入在 Nu 验证时采用 XHTML 解析语义。
screenshot.capture	捕获桌面、平板、移动设备或自定义视口的屏幕截图。	打开所选本地文件或符合条件的公共 URL，并将 PNG 文件写入所选输出目录；可能会替换已有的匹配文件。

托管应用工具

托管应用提供八种工具：

工具	用途
audit_public_webpage	获取一个经授权的公开 HTML 页面，并运行综合 HTML、SEO/无障碍信号和 JSON-LD 语法审计。链接检查为可选项。
audit_public_site	对最多八个经授权、同源的公开页面运行范围受限、优先使用站点地图的审计。它会遵守 robots.txt，返回精简的页面覆盖情况和去重后的发现项，且不会运行全站链接检查。
validate_html	验证对话中已提供的原始 HTML 标记。
validate_css	在 Worker 内解析提供的 CSS，检查语法错误。
audit_seo_metadata	审计所提供 HTML 中受支持的页面 SEO、robots noindex 和无障碍信号。
validate_schema_markup	检查所提供 HTML 中 JSON-LD 区块的 JSON 语法错误。
check_broken_links	检查从所提供 HTML 中提取的最多 20 个经授权的公开链接。
generate_validation_report	综合检查所提供的标记；base_url 用于解析相对链接，但不会获取页面。

audit_public_webpage 最多跟随三个经过验证的重定向，接受范围受限的 text/html 响应，并记录最终 URL。它不会爬取其他页面、执行 JavaScript、进行身份验证，也不会获取链接的样式表和资源。audit_public_site 首先锁定最终公开源站，然后读取范围受限的 robots.txt，以及同源的 XML Sitemap、RSS 2.0、Atom 1.0 和纯文本站点地图表示，之后在一次调用中审计最多八个符合条件的站点地图页面。根据 robots 协议，robots 发现过程可以跨源站跟随最多五个经过验证的公开重定向；但所得规则和相对 Sitemap 指令仍会按最初审计的源站进行解析。站点地图条目和审计页面始终保持同源；私有/保留目的地、凭据、自定义端口、服务自我获取请求以及 HTTPS 降级到 HTTP 的重定向都会被拒绝。该工具不会跟随 HTML 链接或外部站点地图条目；如果响应提示仍有符合条件的页面，请使用 page_offset。获取的 HTML 会发送到 https://html5.validator.nu/，这是 validate_html 和报告工具使用的同一外部 Nu HTML Checker。CSS 解析、SEO 分析和 JSON-LD 解析均在 DigestSEO Worker 内运行。可选的链接检查会向符合条件的公开 HTTP(S) URL 发出数量受限的 HEAD 请求，并在必要时进行范围受限的 GET 回退；链接重定向会被报告，但不会跟随。站点工具有意不执行全站链接检查。托管应用不会保留工具输入、获取的 HTML 或结果。

隐私政策

仅验证你拥有或获准检查的文件、标记和公开网页。公开页面 URL 可能包含敏感查询值，因此提交前请移除令牌和私人标识符。请勿提交密码、API 密钥、访问令牌、支付数据、健康数据、私有源代码或其他敏感个人数据。

本地服务使用与其 MCP 客户端相同的操作系统权限运行。在批准文件访问、外部验证、链接检查或截图创建前，请检查工具输入。托管应用无法访问你的本地文件系统。

有关数据处理详情，请参阅已发布的隐私政策，如需私下报告漏洞，请参阅 SECURITY.md。

配置本地客户端

Claude Desktop

将服务添加到 claude_desktop_config.json：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

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

保存配置后，重启 Claude Desktop。

Cursor 和兼容客户端

创建一个命令/stdio MCP 服务：

npx -y mcp-web-validator

此仓库还包含 Cursor Marketplace 插件清单。插件发布后，可从 Cursor Marketplace 安装 Web Validator by DigestSEO，也可以通过 Cursor 的插件界面添加此仓库。该插件捆绑了相同的本地 stdio 服务，无需 API 密钥或环境变量。

OpenAI Codex

Codex CLI 可以直接添加已发布的本地 stdio 包：

codex mcp add mcp-web-validator -- npx -y mcp-web-validator

也可以改为添加现有的托管 Streamable HTTP 接口：

codex mcp add mcp-web-validator-hosted --url https://web-validator-mcp.digestseo.com/mcp

使用以下命令验证任一配置：

codex mcp list

本地包支持工作区文件验证和响应式截图捕获。托管接口仅支持远程访问，无法访问本地文件或创建截图。

Gemini CLI

Gemini CLI 支持本地 stdio MCP 服务。使用以下命令添加已发布的包：

gemini mcp add mcp-web-validator npx -y mcp-web-validator

这会将服务定义写入 Gemini CLI 的 MCP 配置。Web Validator 无需 API 密钥或环境变量。

GitHub Copilot CLI

使用以下命令添加已发布的本地 stdio 服务：

copilot mcp add mcp-web-validator -- npx -y mcp-web-validator

在此仓库的克隆目录中启动 Copilot CLI 时，它也可以发现已纳入版本控制的根目录 .mcp.json，其中已将 mcp-web-validator 指向 npx -y mcp-web-validator。

Kiro

这会安装本地 stdio 包，并保留其工作区文件和截图功能。需要 Node.js 22.12.0+。

开发

克隆仓库并安装锁定的依赖项：

git clone https://github.com/AKzar1el/mcp-web-validator.git
cd mcp-web-validator
npm ci

运行本地质量检查：

npm run check
npm test
npm run build
npm pack --dry-run

运行本地 stdio 服务：

npm start

单独验证托管 Worker：

cd chatgpt-plugin
npm ci
npm run check
npm test
npm run deploy:dry-run

有关贡献要求，请参阅 CONTRIBUTING.md。部署和 Marketplace 审核说明请参阅 chatgpt-plugin/SUBMISSION.md。 有关借助 Agent 安装的信息，请参阅 llms-install.md。

生态系统

许可证

根据 MIT License 授权。