mcp-web-validator
W3C HTML/CSS Validator and Technical SEO Audit MCP Server. Part of the DigestSEO (https://digestseo.com) suite.
Install / Use
claude mcp add AKzar1el -- npx -y github:AKzar1el/mcp-web-validatorIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
MarketingSupported Platforms
Tags
Our assessment of mcp-web-validator
mcp-web-validator scores 72/100 on our quality scale, 607th of 639 Marketing skills we index.
Its MCP Server is 41 KB long, well organised into 22 sections with 15 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so mcp-web-validator is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
mcp-web-validator compared with similar skills
All 4 of these similar skills score higher than mcp-web-validator; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| mcp-web-validator (this skill)by AKzar1el | 72 | 10 | today | MCP Server |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.3k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.5k | today | CLAUDE.md |
Frequently asked questions
- How do I install mcp-web-validator?
- Run
claude mcp add AKzar1el -- npx -y github:AKzar1el/mcp-web-validator. The install tabs above show the steps for each supported agent. - Which AI agents does mcp-web-validator work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is mcp-web-validator safe to use?
- It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is mcp-web-validator still maintained?
- The repository was last updated today, so mcp-web-validator is actively maintained.
Skill content
View source on GitHubWeb Validator by DigestSEO
An MCP server for HTML and CSS validation, technical SEO and accessibility checks, JSON-LD syntax validation, broken-link checks, and responsive screenshots. It is part of the DigestSEO suite of open-source SEO tools.
- Product: digestseo.com/validator-mcp
- Engineering case study: DigestSEO MCP Suite — AI visibility, Search Console, web validation, and trend intelligence
- Documentation: this README
- Support: digestseo.com/support
- Privacy: digestseo.com/privacy
Choose the right surface
This repository contains two deliberately separate MCP surfaces:
| Surface | Transport | Best for | Access and side effects | | --- | --- | --- | --- | | Local npm server | stdio | Claude Desktop, Cursor, and other local MCP clients | Can read user-selected workspace files, contact validation and link targets, and write screenshot files. | | Hosted app | Streamable HTTP | ChatGPT and remote MCP clients | Can fetch one authorized public HTML page, run a bounded sitemap-first site audit, or process supplied markup. It cannot access local files, authenticate, recursively crawl links, execute page JavaScript, or create screenshots. |
Local installation:
npx -y mcp-web-validator
Hosted endpoint:
https://web-validator-mcp.digestseo.com/mcp
Requirements
- Node.js 22.12.0 or newer
- An MCP client that supports stdio, or a client that supports Streamable HTTP for the hosted endpoint
The validation, SEO, schema, link, and report tools do not download a browser during installation. The local screenshot.capture tool installs its pinned headless browser into Puppeteer's cache on first use, then reuses that browser for later screenshots. Set PUPPETEER_CACHE_DIR if you need a custom cache location.
Tools
Large results: MCP structured diagnostic previews are bounded by serialized byte size. Exact totals and severity counts remain available, and truncated indicates omitted previews. links.broken also returns totalLinks. Extremely large report.validation results use a condensed Markdown summary instead of oversized tables; the score and check-status values still reflect the full audit.
The npm package exposes these exact runtime tool names:
| Tool | Purpose | Network or filesystem behavior |
| --- | --- | --- |
| html.local | Validate a local HTML or XHTML file. | Reads the selected file and submits its markup to the external W3C Nu HTML Checker at validator.w3.org/nu/; .xhtml paths use application/xhtml+xml parsing semantics. |
| html.url | Validate the markup returned by a public URL. | Fetches the URL, then submits the returned markup to the external Nu checker. |
| site.sitemaps | Review 1–8 XML/text sitemap documents, nested child coverage, duplicates, malformed URLs, lastmod consistency and independently observed page indexability/canonical conflicts, or fetch up to 3 safe sitemap documents live. | Bounded inventory, not a complete crawl or Google indexing verdict. No raw URLs, XML or headers returned. See V05. |
| site.link_graph | Compute shortest observed internal-link paths, sampled incoming-link counts, potential orphan leads and linked HTTP/robots/noindex/canonical conflicts from 1–8 supplied pages, or a guarded three-page live sample. | Static anchor links including navigation. Unsampled pages and sitemap URLs are never called confirmed orphans/broken; no source URLs or HTML echoed. See V06. |
| http.redirect_chain | Compare up to eight supplied HTTP response redirects and canonical declarations, or probe a bounded public same-origin redirect chain. Flags loops, mismatches against a specified expected target, conflicting/cyclic canonicals, final HTTP errors and declared noindex. | Bounded static evidence; live mode stays same-origin and query-free. No raw URL/HTML/header echo, Google-selected canonical claim or indexing verdict. See V04. |
| crawler.access | Evaluate 1–8 static pages against robots.txt per Googlebot desktop/smartphone/news/image, Bingbot and GPTBot, with independent robots meta/X-Robots-Tag indexing observations; optional bounded live public page probe. | Offline or service-user-agent live mode. Does not impersonate real crawlers, execute JS, decide actual index status or echo raw URLs/headers. See V03. |
| http.availability | Compare 2–48 timestamped HTTP or transport observations, or sample an authorized public URL with 2–3 GETs to detect intermittent failures, 429/5xx, status changes and challenges. | Bounded offline or live read-only mode. Sample success ratios are not continuous uptime and do not establish Googlebot outcomes. See V02. |
| availability.history | Explicitly capture one live public GET observation into local history, list existing outcomes or compare at least two previously captured outcomes for one exact URL. | Local-only guarded atomic JSON archive of at most 10 observations (24 KB), oldest evicted automatically; capture writes local state, never schedules checks. Hosted app remains stateless. See V02. |
| http.delivery | Diagnose HTTP 403, 429, 5xx, same-origin redirects, caching and explicit Cloudflare challenge signals from one live URL or up to four supplied response hops. | A live call makes a bounded DNS-pinned public GET without reading the response body; supplied mode is fully offline. Output is redacted, bounded, and not a Googlebot or historical availability verdict. See V01. |
| http.directives | Review 1-8 caller-supplied same-origin HTTP response observations for non-HTML document MIME types, X-Robots-Tag noindex/agent scopes and conflicts, HTTP Link canonical declarations, attachment dispositions and status. | Offline; no HTTP requests or binary downloads. Returns only bounded resource numbers/counts and fixed review messages, not original URLs, headers, files or Google indexing verdicts. |
| http.security | Review 1–8 caller-supplied, same-host HTTP/HTTPS status and response-header records plus optional static HTML for declared HTTPS redirects, HSTS, enforcing/report-only CSP, Referrer-Policy, nosniff, framing, potentially blockable/upgradable mixed content and insecure form submissions. | Fully offline with no TLS connection, redirect following, JS/CSS execution, file writes, browser use or website fetching. Returns numeric counts and fixed redacted review messages, not a certificate/security audit or proof of actual browser enforcement. |
| http.variants | Compare an explicit query-free reference against 1–12 supplied same-path HTTP/HTTPS, apex/www, trailing slash, path case and query response observations; analyze declared one-step redirects, canonical hints and optional SHA-256 body fingerprints for HTTP 200 responses. | Fully offline with no requests or redirects followed. Host/path families are only candidate variants; query or case differences may serve different content. Returns counts and fixed redacted findings, no URL paths, queries, raw response targets, hashes or Google-selected canonical verdicts. |
| css.local | Validate a local CSS file. | Reads the selected file and submits its CSS to the external W3C Jigsaw CSS Validator. |
| seo.metadata | Audit titles, descriptions, canonical tags, robots noindex directives, headings, viewport metadata, image alt attributes, and Open Graph metadata. | Processes supplied HTML locally. |
| content.duplicates | Compare exact and conservative near-duplicate main content within the same language across up to eight supplied HTML pages. | Fully offline, with no network, browser execution or storage; returns only evidence pairs and coverage, never main text. |
| content.quality | Review empty or short static main content, repeated substantive boilerplate within sampled same-language URL families, and possible low unique value. | Offline analysis of up to eight supplied HTML pages; results are review signals, not proof that a short page lacks value or that Google penalized it. |
| content.metadata | Compare repeated, conflicting and mismatched title, description, canonical, Open Graph, Twitter and explicit robots metadata across 1-8 supplied same-origin HTML pages. | Fully offline; no page fetch, canonical selection, ranking or indexing verdict. Identical duplicate fields and social-title differences are advisory, not automatic SEO errors. |
| content.provenance | Compare explicit citations, dataset releases/snapshot dates, publication chronology, and methodology links with optional supplied source evidence and opt-in freshness windows. | Fully offline for up to eight supplied HTML pages; no citation/dataset fetching, external fact checks, browser, storage or claim of scientific truth. Missing source evidence remains unverified. |
| content.competitors | Compare static search-intent signals between one primary page and up to six user-supplied competitor pages. Optional caller-chosen intent and query-heading word overlap identify review leads, never ranking winners. | Fully offline; does not fetch competitor sites, scrape SERPs, use GSC, run a semantic classifier or claim Google intent alignment. |
| product.claims | Compare explicit local MCP capability promises in supplied or fetched landing-page HTML against the local runtime's actually registered tools and metadata. | Processes supplied HTML offline or fetches exactly one authorized public page using SSRF-safe network rules; registration consistency is not successful execution or a full marketing truth verdict. |
| site.hreflang | Compare up to 16 supplied localized HTML pages for hreflang return links, self references, locale conflicts, x-default and canonical target clusters. | Fully offline and cross-domain aware; no crawling, private credentials, local-file access or storage. Unseen targets are unverified, not broken. |
| site.links | Review contextual same-origin internal links, accessible anchor labels, generic link text, internal nofollow, repeated labels and lexical overlap with supplied destination headings. | Fully offline across 1-8 user-supplied same-origin HTML pages; does not fetch linked pages, claim broken destinations, infer semantic relevance or Google rankings. Navigation links and unsupplied targets are excluded/unverified. |
| links.broken | Check links extracted from supplied HTML. | Sends bounded HTTP requests to eligible public links. Returned link URLs omit queries and embedded credentials; requests still use the original URLs. |
| media.diagnostics | Review supplied static image, picture and video metadata: alt and link-name hints, intrinsic dimensions, loading/decoding/fetch priority, picture fallbacks and caption-track declarations. | Local-only, offline markup inspection with bounded redacted results. Does not fetch m
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.3k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.5kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
