mcp-web-validator 1.3.21 → 1.3.22

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this project are documented here. The project follows [Se
 
 ## [Unreleased]
 
+## [1.3.22] - 2026-09-23
+
+### Fixed
+
+- Reported `robots`/`googlebot` `noindex`-equivalent meta directives, including body metadata honored by Google Search, instead of silently treating index-blocked pages as clean.
+
+### Changed
+
+- Raised the minimum supported Undici 7.x dependency floor to 7.29.1 while preserving the package's Node.js `>=22.12.0` support contract.
+
 ## [1.3.21] - 2026-09-22
 
 ### Fixed

package/README.md

@@ -52,7 +52,7 @@ The npm package exposes these exact runtime tool names:
 | `html.local` | Validate a local HTML file. | Reads the selected file and submits its markup to the external W3C Nu HTML Checker at `validator.w3.org/nu/`. |
 | `html.url` | Validate the markup returned by a public URL. | Fetches the URL, then submits the returned markup to the external Nu checker. |
 | `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, headings, viewport metadata, image alt attributes, and Open Graph metadata. | Processes supplied HTML locally. |
+| `seo.metadata` | Audit titles, descriptions, canonical tags, robots noindex directives, headings, viewport metadata, image alt attributes, and Open Graph metadata. | Processes supplied HTML locally. |
 | `links.broken` | Check links extracted from supplied HTML. | Sends bounded HTTP requests to eligible public links. |
 | `schema.markup` | Parse JSON-LD blocks and report JSON syntax errors. | Processes supplied HTML locally. |
 | `report.validation` | Combine HTML, optional CSS, SEO, JSON-LD, and bounded link checks in a Markdown report. | Reads selected files, contacts the validators, and checks eligible public links found in the HTML. |
@@ -68,12 +68,12 @@ The hosted app exposes eight tools:
 | `audit_public_site` | Run a bounded sitemap-first audit of up to eight authorized, same-origin public pages. It respects `robots.txt`, returns compact page coverage and deduplicated findings, and does not run site-wide link checks. |
 | `validate_html` | Validate raw HTML markup already supplied in the conversation. |
 | `validate_css` | Parse supplied CSS for syntax errors inside the Worker. |
-| `audit_seo_metadata` | Audit supplied HTML for covered on-page SEO and accessibility signals. |
+| `audit_seo_metadata` | Audit supplied HTML for covered on-page SEO, robots noindex, and accessibility signals. |
 | `validate_schema_markup` | Check JSON-LD blocks in supplied HTML for JSON syntax errors. |
 | `check_broken_links` | Check up to 20 authorized public links extracted from supplied HTML. |
 | `generate_validation_report` | Combine the checks for supplied markup; `base_url` resolves relative links but does not fetch a page. |
 
-`audit_public_webpage` follows at most three validated redirects, accepts a bounded `text/html` response, and records the final URL. It does not crawl additional pages, execute JavaScript, authenticate, or fetch linked stylesheets and assets. `audit_public_site` first locks the final public origin, reads bounded same-origin `robots.txt` plus XML Sitemap, RSS 2.0, Atom 1.0, and plain-text sitemap representations, then audits at most eight eligible sitemap pages in one call. It never follows HTML links, subdomains, external sitemap entries, private/reserved destinations, custom ports, or cross-origin redirects; use `page_offset` when the response says more eligible pages remain. The fetched HTML is sent to `https://html5.validator.nu/`, the same external Nu HTML Checker used by `validate_html` and the report tool. CSS parsing, SEO analysis, and JSON-LD parsing run inside the DigestSEO Worker. Optional link checks make capped `HEAD` requests, with a bounded `GET` fallback where necessary, to eligible public HTTP(S) URLs; link redirects are reported but not followed. The site tool intentionally does not perform site-wide link checking. The hosted app does not retain tool inputs, fetched HTML, or results.
+`audit_public_webpage` follows at most three validated redirects, accepts a bounded `text/html` response, and records the final URL. It does not crawl additional pages, execute JavaScript, authenticate, or fetch linked stylesheets and assets. `audit_public_site` first locks the final public origin, then reads bounded `robots.txt` plus same-origin XML Sitemap, RSS 2.0, Atom 1.0, and plain-text sitemap representations before auditing at most eight eligible sitemap pages in one call. Robots discovery may follow up to five validated public redirects across authorities, as defined by the robots protocol; the resulting rules and relative Sitemap directives are still interpreted for the originally audited authority. Sitemap entries and audited pages remain same-origin, and private/reserved destinations, credentials, custom ports, service self-fetches, and HTTPS-to-HTTP redirect downgrades are rejected. The tool never follows HTML links or external sitemap entries; use `page_offset` when the response says more eligible pages remain. The fetched HTML is sent to `https://html5.validator.nu/`, the same external Nu HTML Checker used by `validate_html` and the report tool. CSS parsing, SEO analysis, and JSON-LD parsing run inside the DigestSEO Worker. Optional link checks make capped `HEAD` requests, with a bounded `GET` fallback where necessary, to eligible public HTTP(S) URLs; link redirects are reported but not followed. The site tool intentionally does not perform site-wide link checking. The hosted app does not retain tool inputs, fetched HTML, or results.
 
 ## Privacy Policy
 

package/dist/seo-auditor.js

@@ -170,6 +170,24 @@ export function auditSeoMetadataDetailed(htmlContent) {
             message: "Multiple usable canonical link relations are declared. Keep one unambiguous canonical target.",
         });
     }
+    // Google Search respects robots meta directives in both the head and body.
+    const indexBlockingRobotsMeta = $('meta[name]').filter((_, element) => {
+        const name = ($(element).attr("name") ?? "").trim().toLowerCase();
+        if (name !== "robots" && name !== "googlebot")
+            return false;
+        const content = $(element).attr("content") ?? "";
+        return content
+            .split(",")
+            .some((directive) => ["noindex", "none"].includes(directive.trim().toLowerCase()));
+    });
+    if (indexBlockingRobotsMeta.length > 0) {
+        add({
+            code: "seo.robots.noindex",
+            severity: "warning",
+            category: "SEO",
+            message: "A robots directive prevents Google from indexing this page. Confirm that noindex is intentional.",
+        });
+    }
     // --- Viewport Meta Tag (Mobile Responsiveness) ---
     const viewport = $('head > meta[name="viewport" i]');
     if (viewport.length === 0) {

package/dist/seo-auditor.js.map

@@ -1 +1 @@
-{"version":3,"file":"seo-auditor.js","sourceRoot":"","sources":["../src/seo-auditor.ts"],"names":[],"mappings":"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","sourcesContent":["import * as cheerio from \"cheerio\";\nimport {\n  assertPublicHttpUrl,\n  cancelResponseBody,\n  fetchPublicHttp,\n  getErrorMessage,\n  PublicUrlError,\n} from \"./network.js\";\nimport { PACKAGE_VERSION } from \"./version.js\";\n\nexport const MAX_AUDIT_ISSUES = 200;\nexport const MAX_LINKS_TO_CHECK = 25;\nconst LINK_CHECK_CONCURRENCY = 5;\nconst LINK_CHECK_TIMEOUT_MS = 5_000;\nconst LINK_CHECK_USER_AGENT = `mcp-web-validator/${PACKAGE_VERSION} (+https://digestseo.com/validator-mcp/)`;\n\nexport interface SEOIssue {\n  code: string;\n  severity: \"error\" | \"warning\" | \"info\";\n  category: \"SEO\" | \"Schema\" | \"BrokenLinks\" | \"Accessibility\";\n  message: string;\n  element?: string;\n}\n\nexport interface LinkStatus {\n  url: string;\n  status: number | string;\n  ok: boolean;\n  message?: string;\n}\n\nexport interface AuditCounts {\n  error: number;\n  warning: number;\n  info: number;\n}\n\nexport interface AuditDetails {\n  issues: SEOIssue[];\n  totalIssues: number;\n  truncated: boolean;\n  counts: AuditCounts;\n}\n\nfunction addIssue(issues: SEOIssue[], issue: SEOIssue): void {\n  if (issues.length < MAX_AUDIT_ISSUES) {\n    issues.push(issue);\n  }\n}\n\nfunction createIssueCollector(): {\n  issues: SEOIssue[];\n  add: (issue: SEOIssue) => void;\n  details: () => AuditDetails;\n} {\n  const issues: SEOIssue[] = [];\n  let totalIssues = 0;\n  const counts: AuditCounts = { error: 0, warning: 0, info: 0 };\n  return {\n    issues,\n    add(issue) {\n      totalIssues += 1;\n      counts[issue.severity] += 1;\n      addIssue(issues, issue);\n    },\n    details() {\n      return {\n        issues,\n        totalIssues,\n        truncated: totalIssues > issues.length,\n        counts: { ...counts },\n      };\n    },\n  };\n}\n\nfunction isJsonLdScriptType(type: string | undefined): boolean {\n  return type?.split(\";\", 1)[0].trim().toLowerCase() === \"application/ld+json\";\n}\n\nfunction hasJsonLdDocumentShape(value: unknown): boolean {\n  if (Array.isArray(value)) {\n    return value.every((entry) => typeof entry === \"object\" && entry !== null && !Array.isArray(entry));\n  }\n  return typeof value === \"object\" && value !== null;\n}\n\n/**\n * Audits technical SEO and accessibility basics on HTML content using Cheerio\n */\nexport function auditSeoMetadataDetailed(htmlContent: string): AuditDetails {\n  const $ = cheerio.load(htmlContent);\n  const collector = createIssueCollector();\n  const { add } = collector;\n\n  // --- Title Tag Audits ---\n  const titleTag = $(\"head > title\");\n  if (titleTag.length === 0) {\n    add({\n      code: \"seo.title.missing_or_empty\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <title> tag. Add a concise, descriptive title to help represent the page in search results.\",\n    });\n  } else {\n    const titleText = titleTag.text().trim();\n    if (titleText.length === 0) {\n      add({\n        code: \"seo.title.missing_or_empty\",\n        severity: \"error\",\n        category: \"SEO\",\n        message: \"The <title> tag is empty.\",\n      });\n    } else if (titleText.length < 30) {\n      add({\n        code: \"seo.title.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Title is ${titleText.length} characters. This is shorter than the audit's common editorial range; review whether it describes the page clearly.`,\n        element: `<title>${titleText}</title>`,\n      });\n    } else if (titleText.length > 60) {\n      add({\n        code: \"seo.title.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Title is ${titleText.length} characters. This is longer than the audit's common editorial range; Google title links may be shortened or rewritten depending on context and device.`,\n        element: `<title>${titleText}</title>`,\n      });\n    }\n  }\n\n  // --- Meta Description Audits ---\n  const metaDescription = $('head > meta[name=\"description\" i]');\n  if (metaDescription.length === 0) {\n    add({\n      code: \"seo.meta_description.missing_or_empty\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <meta name=\\\"description\\\">. Add a concise, accurate page summary; Google may use page content or this description to generate a snippet.\",\n    });\n  } else {\n    const descText = metaDescription.attr(\"content\")?.trim() || \"\";\n    if (descText.length === 0) {\n      add({\n        code: \"seo.meta_description.missing_or_empty\",\n        severity: \"error\",\n        category: \"SEO\",\n        message: \"Meta description content attribute is empty.\",\n      });\n    } else if (descText.length < 120) {\n      add({\n        code: \"seo.meta_description.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Meta description is ${descText.length} characters. This is shorter than the audit's common editorial range; review whether it provides a useful page summary.`,\n        element: `<meta name=\"description\" content=\"${descText}\">`,\n      });\n    } else if (descText.length > 160) {\n      add({\n        code: \"seo.meta_description.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Meta description is ${descText.length} characters. This is longer than the audit's common editorial range; displayed snippets may be shortened depending on the query and device.`,\n        element: `<meta name=\"description\" content=\"${descText}\">`,\n      });\n    }\n  }\n\n  // --- Canonical Link ---\n  const canonicalLinks = $(\"head > link[rel]\").filter((_, element) => {\n    const rel = $(element).attr(\"rel\") ?? \"\";\n    return rel\n      .trim()\n      .split(/[\\t\\n\\f\\r ]+/)\n      .some((token) => token.toLowerCase() === \"canonical\");\n  });\n  const nonEmptyCanonical = canonicalLinks.filter((_, element) => Boolean($(element).attr(\"href\")?.trim()));\n  const usableCanonical = nonEmptyCanonical.filter(\n    (_, element) => ![\"hreflang\", \"lang\", \"media\", \"type\"].some((attribute) => $(element).attr(attribute) !== undefined),\n  );\n  if (canonicalLinks.length === 0) {\n    add({\n      code: \"seo.canonical.missing\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: \"No rel=\\\"canonical\\\" preference is declared. This is optional unless the page needs an explicit canonicalization signal.\",\n    });\n  } else if (usableCanonical.length === 0) {\n    if (nonEmptyCanonical.length > 0) {\n      add({\n        code: \"seo.canonical.unusable\",\n        severity: \"warning\",\n        category: \"SEO\",\n        message: \"Canonical link is present but uses attributes Google ignores for canonicalization. Use a plain rel=\\\"canonical\\\" link in <head>.\",\n      });\n    } else {\n      add({\n        code: \"seo.canonical.missing\",\n        severity: \"warning\",\n        category: \"SEO\",\n        message: \"Canonical link is present but its href is empty. Provide a usable canonical target or remove the declaration.\",\n      });\n    }\n  } else if (usableCanonical.length > 1) {\n    add({\n      code: \"seo.canonical.multiple\",\n      severity: \"warning\",\n      category: \"SEO\",\n      message: \"Multiple usable canonical link relations are declared. Keep one unambiguous canonical target.\",\n    });\n  }\n\n  // --- Viewport Meta Tag (Mobile Responsiveness) ---\n  const viewport = $('head > meta[name=\"viewport\" i]');\n  if (viewport.length === 0) {\n    add({\n      code: \"seo.viewport.missing\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <meta name=\\\"viewport\\\"> tag. Review mobile rendering; this tag helps browsers size and scale the page on mobile devices.\",\n    });\n  } else if (viewport.filter((_, element) => Boolean($(element).attr(\"content\")?.trim())).length === 0) {\n    add({\n      code: \"seo.viewport.unusable\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Viewport meta tag is present but its content is empty. Provide viewport settings such as width=device-width.\",\n    });\n  }\n\n  // --- Heading Structure ---\n  const h1Tags = $(\"h1\");\n  if (h1Tags.length === 0) {\n    add({\n      code: \"seo.h1.missing\",\n      severity: \"warning\",\n      category: \"SEO\",\n      message: \"No <h1> heading found. Review whether the page has a clear main heading and a meaningful heading hierarchy.\",\n    });\n  } else if (h1Tags.length > 1) {\n    add({\n      code: \"seo.h1.multiple\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: `Found multiple (${h1Tags.length}) <h1> headings. Multiple H1s are not inherently an SEO error; ensure the heading hierarchy is meaningful and the main visual title is clear.`,\n    });\n  }\n\n  // --- Images Alt Tags (SEO + Accessibility) ---\n  $(\"img\").each((_, element) => {\n    const img = $(element);\n    const src = img.attr(\"src\") || \"unknown-source\";\n    const alt = img.attr(\"alt\");\n\n    if (alt === undefined) {\n      add({\n        code: \"accessibility.image_alt.missing\",\n        severity: \"error\",\n        category: \"Accessibility\",\n        message: \"Missing 'alt' attribute on image. This makes it inaccessible to screen readers.\",\n        element: `<img src=\"${src}\">`,\n      });\n    } else if (alt.trim() === \"\") {\n      // Empty alt is acceptable for purely decorative images, but worth warning\n      add({\n        code: \"accessibility.image_alt.empty\",\n        severity: \"info\",\n        category: \"Accessibility\",\n        message: \"Empty 'alt' attribute found. Ensure this image is purely decorative, otherwise add descriptive text.\",\n        element: `<img src=\"${src}\" alt=\"\">`,\n      });\n    }\n  });\n\n  // --- Open Graph / Social Tags ---\n  const ogTitle = $('head > meta[property=\"og:title\"]');\n  const ogImage = $('head > meta[property=\"og:image\"]');\n  if (ogTitle.length === 0 || ogImage.length === 0) {\n    add({\n      code: \"seo.open_graph.missing\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: \"Missing Open Graph social metadata (og:title / og:image). Add these to control preview cards on platforms like LinkedIn and X.\",\n    });\n  }\n\n  return collector.details();\n}\n\nexport function auditSeoMetadata(htmlContent: string): SEOIssue[] {\n  return auditSeoMetadataDetailed(htmlContent).issues;\n}\n\n/**\n * Parses and validates JSON-LD Schema markup\n */\nexport function validateSchemaMarkupDetailed(htmlContent: string): AuditDetails {\n  const $ = cheerio.load(htmlContent);\n  const collector = createIssueCollector();\n  const { add } = collector;\n  const blocks = $(\"script[type]\").filter((_, element) => isJsonLdScriptType($(element).attr(\"type\")));\n\n  blocks.each((index, element) => {\n    const scriptText = $(element).html() || \"\";\n    if (scriptText.trim() === \"\") {\n      add({\n        code: \"schema.jsonld.empty\",\n        severity: \"warning\",\n        category: \"Schema\",\n        message: `JSON-LD block #${index + 1} is empty.`,\n      });\n      return;\n    }\n\n    try {\n      const parsed = JSON.parse(scriptText) as unknown;\n      if (!hasJsonLdDocumentShape(parsed)) {\n        add({\n          code: \"schema.jsonld.invalid_document\",\n          severity: \"error\",\n          category: \"Schema\",\n          message: \"Invalid JSON-LD document shape: the top level must be an object or an array of objects.\",\n          element: `<script type=\"application/ld+json\">...</script>`,\n        });\n      }\n    } catch (error: unknown) {\n      add({\n        code: \"schema.jsonld.invalid_json\",\n        severity: \"error\",\n        category: \"Schema\",\n        message: `Invalid JSON-LD schema syntax: ${getErrorMessage(error)}`,\n        element: `<script type=\"application/ld+json\">...</script>`,\n      });\n    }\n  });\n\n  return collector.details();\n}\n\nexport function validateSchemaMarkup(htmlContent: string): SEOIssue[] {\n  return validateSchemaMarkupDetailed(htmlContent).issues;\n}\n\n/**\n * Extracts and tests links, treating 3xx responses as reachable redirects and 4xx/5xx as broken.\n */\nexport async function checkBrokenLinks(\n  htmlContent: string,\n  baseUrl?: string,\n  maxLinks = MAX_LINKS_TO_CHECK,\n): Promise<LinkStatus[]> {\n  if (!Number.isSafeInteger(maxLinks) || maxLinks <= 0) {\n    throw new Error(\"maxLinks must be a positive integer\");\n  }\n  const linkLimit = Math.min(maxLinks, MAX_LINKS_TO_CHECK);\n  const $ = cheerio.load(htmlContent);\n  const fallbackBaseUrl = baseUrl ? await assertPublicHttpUrl(baseUrl) : undefined;\n  let parsedBaseUrl = fallbackBaseUrl;\n  const documentBaseHref = $(\"base[href]\").first().attr(\"href\");\n  if (documentBaseHref !== undefined) {\n    let resolvedDocumentBase: URL | undefined;\n    try {\n      resolvedDocumentBase = fallbackBaseUrl\n        ? new URL(documentBaseHref, fallbackBaseUrl)\n        : new URL(documentBaseHref);\n    } catch {\n      parsedBaseUrl = undefined;\n    }\n    if (resolvedDocumentBase) {\n      try {\n        parsedBaseUrl = await assertPublicHttpUrl(resolvedDocumentBase);\n      } catch (error: unknown) {\n        if (!(error instanceof PublicUrlError)) {\n          throw error;\n        }\n        parsedBaseUrl = undefined;\n      }\n    }\n  }\n  const urls: string[] = [];\n  const seenUrls = new Set<string>();\n\n  $(\"a\").each((_, element) => {\n    if (urls.length >= linkLimit) {\n      return false;\n    }\n\n    const href = $(element).attr(\"href\")?.trim();\n    if (!href || href.startsWith(\"#\")) {\n      return;\n    }\n\n    let resolvedUrl: URL;\n    try {\n      resolvedUrl = parsedBaseUrl ? new URL(href, parsedBaseUrl) : new URL(href);\n    } catch {\n      // Relative links require a public base URL; unsupported or malformed links are skipped.\n      return;\n    }\n\n    if (resolvedUrl.protocol !== \"http:\" && resolvedUrl.protocol !== \"https:\") {\n      return;\n    }\n\n    resolvedUrl.hash = \"\";\n    const normalizedUrl = resolvedUrl.href;\n    if (!seenUrls.has(normalizedUrl)) {\n      seenUrls.add(normalizedUrl);\n      urls.push(normalizedUrl);\n    }\n  });\n\n  const results = new Array<LinkStatus>(urls.length);\n  let nextIndex = 0;\n\n  async function checkLink(url: string): Promise<LinkStatus> {\n    try {\n      const headResult = await fetchPublicHttp(url, {\n        method: \"HEAD\",\n        headers: { \"User-Agent\": LINK_CHECK_USER_AGENT },\n        timeoutMs: LINK_CHECK_TIMEOUT_MS,\n        maxRedirects: 0,\n      });\n      const headStatus = headResult.response.status;\n      const headFinalUrl = headResult.url.href;\n      await cancelResponseBody(headResult.response);\n\n      // Some sites reject or do not implement HEAD even when the linked resource is available.\n      if (headStatus === 405 || headStatus === 403 || headStatus === 501) {\n        let getResult = await fetchPublicHttp(url, {\n          method: \"GET\",\n          headers: {\n            Range: \"bytes=0-0\",\n            \"User-Agent\": LINK_CHECK_USER_AGENT,\n          },\n          timeoutMs: LINK_CHECK_TIMEOUT_MS,\n          maxRedirects: 0,\n        });\n        if (getResult.response.status === 416) {\n          await cancelResponseBody(getResult.response);\n          getResult = await fetchPublicHttp(url, {\n            method: \"GET\",\n            headers: { \"User-Agent\": LINK_CHECK_USER_AGENT },\n            timeoutMs: LINK_CHECK_TIMEOUT_MS,\n            maxRedirects: 0,\n          });\n        }\n\n        const status = getResult.response.status;\n        const ok = status >= 200 && status < 400;\n        const finalUrl = getResult.url.href;\n        await cancelResponseBody(getResult.response);\n        return {\n          url,\n          status,\n          ok,\n          message:\n            status >= 300 && status < 400\n              ? \"Redirect not followed\"\n              : finalUrl !== url\n                ? `Redirected to ${finalUrl}`\n                : undefined,\n        };\n      }\n\n      return {\n        url,\n        status: headStatus,\n        ok: headStatus >= 200 && headStatus < 400,\n        message:\n          headStatus >= 300 && headStatus < 400\n            ? \"Redirect not followed\"\n            : headFinalUrl !== url\n              ? `Redirected to ${headFinalUrl}`\n              : undefined,\n      };\n    } catch (error: unknown) {\n      return {\n        url,\n        status: error instanceof PublicUrlError ? \"blocked\" : \"failed\",\n        ok: false,\n        message: getErrorMessage(error),\n      };\n    }\n  }\n\n  async function worker(): Promise<void> {\n    while (true) {\n      const index = nextIndex;\n      nextIndex += 1;\n      if (index >= urls.length) {\n        return;\n      }\n      results[index] = await checkLink(urls[index]);\n    }\n  }\n\n  const workerCount = Math.min(LINK_CHECK_CONCURRENCY, urls.length);\n  await Promise.all(Array.from({ length: workerCount }, () => worker()));\n  return results;\n}\n"]}
+{"version":3,"file":"seo-auditor.js","sourceRoot":"","sources":["../src/seo-auditor.ts"],"names":[],"mappings":"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","sourcesContent":["import * as cheerio from \"cheerio\";\nimport {\n  assertPublicHttpUrl,\n  cancelResponseBody,\n  fetchPublicHttp,\n  getErrorMessage,\n  PublicUrlError,\n} from \"./network.js\";\nimport { PACKAGE_VERSION } from \"./version.js\";\n\nexport const MAX_AUDIT_ISSUES = 200;\nexport const MAX_LINKS_TO_CHECK = 25;\nconst LINK_CHECK_CONCURRENCY = 5;\nconst LINK_CHECK_TIMEOUT_MS = 5_000;\nconst LINK_CHECK_USER_AGENT = `mcp-web-validator/${PACKAGE_VERSION} (+https://digestseo.com/validator-mcp/)`;\n\nexport interface SEOIssue {\n  code: string;\n  severity: \"error\" | \"warning\" | \"info\";\n  category: \"SEO\" | \"Schema\" | \"BrokenLinks\" | \"Accessibility\";\n  message: string;\n  element?: string;\n}\n\nexport interface LinkStatus {\n  url: string;\n  status: number | string;\n  ok: boolean;\n  message?: string;\n}\n\nexport interface AuditCounts {\n  error: number;\n  warning: number;\n  info: number;\n}\n\nexport interface AuditDetails {\n  issues: SEOIssue[];\n  totalIssues: number;\n  truncated: boolean;\n  counts: AuditCounts;\n}\n\nfunction addIssue(issues: SEOIssue[], issue: SEOIssue): void {\n  if (issues.length < MAX_AUDIT_ISSUES) {\n    issues.push(issue);\n  }\n}\n\nfunction createIssueCollector(): {\n  issues: SEOIssue[];\n  add: (issue: SEOIssue) => void;\n  details: () => AuditDetails;\n} {\n  const issues: SEOIssue[] = [];\n  let totalIssues = 0;\n  const counts: AuditCounts = { error: 0, warning: 0, info: 0 };\n  return {\n    issues,\n    add(issue) {\n      totalIssues += 1;\n      counts[issue.severity] += 1;\n      addIssue(issues, issue);\n    },\n    details() {\n      return {\n        issues,\n        totalIssues,\n        truncated: totalIssues > issues.length,\n        counts: { ...counts },\n      };\n    },\n  };\n}\n\nfunction isJsonLdScriptType(type: string | undefined): boolean {\n  return type?.split(\";\", 1)[0].trim().toLowerCase() === \"application/ld+json\";\n}\n\nfunction hasJsonLdDocumentShape(value: unknown): boolean {\n  if (Array.isArray(value)) {\n    return value.every((entry) => typeof entry === \"object\" && entry !== null && !Array.isArray(entry));\n  }\n  return typeof value === \"object\" && value !== null;\n}\n\n/**\n * Audits technical SEO and accessibility basics on HTML content using Cheerio\n */\nexport function auditSeoMetadataDetailed(htmlContent: string): AuditDetails {\n  const $ = cheerio.load(htmlContent);\n  const collector = createIssueCollector();\n  const { add } = collector;\n\n  // --- Title Tag Audits ---\n  const titleTag = $(\"head > title\");\n  if (titleTag.length === 0) {\n    add({\n      code: \"seo.title.missing_or_empty\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <title> tag. Add a concise, descriptive title to help represent the page in search results.\",\n    });\n  } else {\n    const titleText = titleTag.text().trim();\n    if (titleText.length === 0) {\n      add({\n        code: \"seo.title.missing_or_empty\",\n        severity: \"error\",\n        category: \"SEO\",\n        message: \"The <title> tag is empty.\",\n      });\n    } else if (titleText.length < 30) {\n      add({\n        code: \"seo.title.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Title is ${titleText.length} characters. This is shorter than the audit's common editorial range; review whether it describes the page clearly.`,\n        element: `<title>${titleText}</title>`,\n      });\n    } else if (titleText.length > 60) {\n      add({\n        code: \"seo.title.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Title is ${titleText.length} characters. This is longer than the audit's common editorial range; Google title links may be shortened or rewritten depending on context and device.`,\n        element: `<title>${titleText}</title>`,\n      });\n    }\n  }\n\n  // --- Meta Description Audits ---\n  const metaDescription = $('head > meta[name=\"description\" i]');\n  if (metaDescription.length === 0) {\n    add({\n      code: \"seo.meta_description.missing_or_empty\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <meta name=\\\"description\\\">. Add a concise, accurate page summary; Google may use page content or this description to generate a snippet.\",\n    });\n  } else {\n    const descText = metaDescription.attr(\"content\")?.trim() || \"\";\n    if (descText.length === 0) {\n      add({\n        code: \"seo.meta_description.missing_or_empty\",\n        severity: \"error\",\n        category: \"SEO\",\n        message: \"Meta description content attribute is empty.\",\n      });\n    } else if (descText.length < 120) {\n      add({\n        code: \"seo.meta_description.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Meta description is ${descText.length} characters. This is shorter than the audit's common editorial range; review whether it provides a useful page summary.`,\n        element: `<meta name=\"description\" content=\"${descText}\">`,\n      });\n    } else if (descText.length > 160) {\n      add({\n        code: \"seo.meta_description.length\",\n        severity: \"info\",\n        category: \"SEO\",\n        message: `Meta description is ${descText.length} characters. This is longer than the audit's common editorial range; displayed snippets may be shortened depending on the query and device.`,\n        element: `<meta name=\"description\" content=\"${descText}\">`,\n      });\n    }\n  }\n\n  // --- Canonical Link ---\n  const canonicalLinks = $(\"head > link[rel]\").filter((_, element) => {\n    const rel = $(element).attr(\"rel\") ?? \"\";\n    return rel\n      .trim()\n      .split(/[\\t\\n\\f\\r ]+/)\n      .some((token) => token.toLowerCase() === \"canonical\");\n  });\n  const nonEmptyCanonical = canonicalLinks.filter((_, element) => Boolean($(element).attr(\"href\")?.trim()));\n  const usableCanonical = nonEmptyCanonical.filter(\n    (_, element) => ![\"hreflang\", \"lang\", \"media\", \"type\"].some((attribute) => $(element).attr(attribute) !== undefined),\n  );\n  if (canonicalLinks.length === 0) {\n    add({\n      code: \"seo.canonical.missing\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: \"No rel=\\\"canonical\\\" preference is declared. This is optional unless the page needs an explicit canonicalization signal.\",\n    });\n  } else if (usableCanonical.length === 0) {\n    if (nonEmptyCanonical.length > 0) {\n      add({\n        code: \"seo.canonical.unusable\",\n        severity: \"warning\",\n        category: \"SEO\",\n        message: \"Canonical link is present but uses attributes Google ignores for canonicalization. Use a plain rel=\\\"canonical\\\" link in <head>.\",\n      });\n    } else {\n      add({\n        code: \"seo.canonical.missing\",\n        severity: \"warning\",\n        category: \"SEO\",\n        message: \"Canonical link is present but its href is empty. Provide a usable canonical target or remove the declaration.\",\n      });\n    }\n  } else if (usableCanonical.length > 1) {\n    add({\n      code: \"seo.canonical.multiple\",\n      severity: \"warning\",\n      category: \"SEO\",\n      message: \"Multiple usable canonical link relations are declared. Keep one unambiguous canonical target.\",\n    });\n  }\n\n  // Google Search respects robots meta directives in both the head and body.\n  const indexBlockingRobotsMeta = $('meta[name]').filter((_, element) => {\n    const name = ($(element).attr(\"name\") ?? \"\").trim().toLowerCase();\n    if (name !== \"robots\" && name !== \"googlebot\") return false;\n    const content = $(element).attr(\"content\") ?? \"\";\n    return content\n      .split(\",\")\n      .some((directive) => [\"noindex\", \"none\"].includes(directive.trim().toLowerCase()));\n  });\n  if (indexBlockingRobotsMeta.length > 0) {\n    add({\n      code: \"seo.robots.noindex\",\n      severity: \"warning\",\n      category: \"SEO\",\n      message: \"A robots directive prevents Google from indexing this page. Confirm that noindex is intentional.\",\n    });\n  }\n\n  // --- Viewport Meta Tag (Mobile Responsiveness) ---\n  const viewport = $('head > meta[name=\"viewport\" i]');\n  if (viewport.length === 0) {\n    add({\n      code: \"seo.viewport.missing\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Missing <meta name=\\\"viewport\\\"> tag. Review mobile rendering; this tag helps browsers size and scale the page on mobile devices.\",\n    });\n  } else if (viewport.filter((_, element) => Boolean($(element).attr(\"content\")?.trim())).length === 0) {\n    add({\n      code: \"seo.viewport.unusable\",\n      severity: \"error\",\n      category: \"SEO\",\n      message: \"Viewport meta tag is present but its content is empty. Provide viewport settings such as width=device-width.\",\n    });\n  }\n\n  // --- Heading Structure ---\n  const h1Tags = $(\"h1\");\n  if (h1Tags.length === 0) {\n    add({\n      code: \"seo.h1.missing\",\n      severity: \"warning\",\n      category: \"SEO\",\n      message: \"No <h1> heading found. Review whether the page has a clear main heading and a meaningful heading hierarchy.\",\n    });\n  } else if (h1Tags.length > 1) {\n    add({\n      code: \"seo.h1.multiple\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: `Found multiple (${h1Tags.length}) <h1> headings. Multiple H1s are not inherently an SEO error; ensure the heading hierarchy is meaningful and the main visual title is clear.`,\n    });\n  }\n\n  // --- Images Alt Tags (SEO + Accessibility) ---\n  $(\"img\").each((_, element) => {\n    const img = $(element);\n    const src = img.attr(\"src\") || \"unknown-source\";\n    const alt = img.attr(\"alt\");\n\n    if (alt === undefined) {\n      add({\n        code: \"accessibility.image_alt.missing\",\n        severity: \"error\",\n        category: \"Accessibility\",\n        message: \"Missing 'alt' attribute on image. This makes it inaccessible to screen readers.\",\n        element: `<img src=\"${src}\">`,\n      });\n    } else if (alt.trim() === \"\") {\n      // Empty alt is acceptable for purely decorative images, but worth warning\n      add({\n        code: \"accessibility.image_alt.empty\",\n        severity: \"info\",\n        category: \"Accessibility\",\n        message: \"Empty 'alt' attribute found. Ensure this image is purely decorative, otherwise add descriptive text.\",\n        element: `<img src=\"${src}\" alt=\"\">`,\n      });\n    }\n  });\n\n  // --- Open Graph / Social Tags ---\n  const ogTitle = $('head > meta[property=\"og:title\"]');\n  const ogImage = $('head > meta[property=\"og:image\"]');\n  if (ogTitle.length === 0 || ogImage.length === 0) {\n    add({\n      code: \"seo.open_graph.missing\",\n      severity: \"info\",\n      category: \"SEO\",\n      message: \"Missing Open Graph social metadata (og:title / og:image). Add these to control preview cards on platforms like LinkedIn and X.\",\n    });\n  }\n\n  return collector.details();\n}\n\nexport function auditSeoMetadata(htmlContent: string): SEOIssue[] {\n  return auditSeoMetadataDetailed(htmlContent).issues;\n}\n\n/**\n * Parses and validates JSON-LD Schema markup\n */\nexport function validateSchemaMarkupDetailed(htmlContent: string): AuditDetails {\n  const $ = cheerio.load(htmlContent);\n  const collector = createIssueCollector();\n  const { add } = collector;\n  const blocks = $(\"script[type]\").filter((_, element) => isJsonLdScriptType($(element).attr(\"type\")));\n\n  blocks.each((index, element) => {\n    const scriptText = $(element).html() || \"\";\n    if (scriptText.trim() === \"\") {\n      add({\n        code: \"schema.jsonld.empty\",\n        severity: \"warning\",\n        category: \"Schema\",\n        message: `JSON-LD block #${index + 1} is empty.`,\n      });\n      return;\n    }\n\n    try {\n      const parsed = JSON.parse(scriptText) as unknown;\n      if (!hasJsonLdDocumentShape(parsed)) {\n        add({\n          code: \"schema.jsonld.invalid_document\",\n          severity: \"error\",\n          category: \"Schema\",\n          message: \"Invalid JSON-LD document shape: the top level must be an object or an array of objects.\",\n          element: `<script type=\"application/ld+json\">...</script>`,\n        });\n      }\n    } catch (error: unknown) {\n      add({\n        code: \"schema.jsonld.invalid_json\",\n        severity: \"error\",\n        category: \"Schema\",\n        message: `Invalid JSON-LD schema syntax: ${getErrorMessage(error)}`,\n        element: `<script type=\"application/ld+json\">...</script>`,\n      });\n    }\n  });\n\n  return collector.details();\n}\n\nexport function validateSchemaMarkup(htmlContent: string): SEOIssue[] {\n  return validateSchemaMarkupDetailed(htmlContent).issues;\n}\n\n/**\n * Extracts and tests links, treating 3xx responses as reachable redirects and 4xx/5xx as broken.\n */\nexport async function checkBrokenLinks(\n  htmlContent: string,\n  baseUrl?: string,\n  maxLinks = MAX_LINKS_TO_CHECK,\n): Promise<LinkStatus[]> {\n  if (!Number.isSafeInteger(maxLinks) || maxLinks <= 0) {\n    throw new Error(\"maxLinks must be a positive integer\");\n  }\n  const linkLimit = Math.min(maxLinks, MAX_LINKS_TO_CHECK);\n  const $ = cheerio.load(htmlContent);\n  const fallbackBaseUrl = baseUrl ? await assertPublicHttpUrl(baseUrl) : undefined;\n  let parsedBaseUrl = fallbackBaseUrl;\n  const documentBaseHref = $(\"base[href]\").first().attr(\"href\");\n  if (documentBaseHref !== undefined) {\n    let resolvedDocumentBase: URL | undefined;\n    try {\n      resolvedDocumentBase = fallbackBaseUrl\n        ? new URL(documentBaseHref, fallbackBaseUrl)\n        : new URL(documentBaseHref);\n    } catch {\n      parsedBaseUrl = undefined;\n    }\n    if (resolvedDocumentBase) {\n      try {\n        parsedBaseUrl = await assertPublicHttpUrl(resolvedDocumentBase);\n      } catch (error: unknown) {\n        if (!(error instanceof PublicUrlError)) {\n          throw error;\n        }\n        parsedBaseUrl = undefined;\n      }\n    }\n  }\n  const urls: string[] = [];\n  const seenUrls = new Set<string>();\n\n  $(\"a\").each((_, element) => {\n    if (urls.length >= linkLimit) {\n      return false;\n    }\n\n    const href = $(element).attr(\"href\")?.trim();\n    if (!href || href.startsWith(\"#\")) {\n      return;\n    }\n\n    let resolvedUrl: URL;\n    try {\n      resolvedUrl = parsedBaseUrl ? new URL(href, parsedBaseUrl) : new URL(href);\n    } catch {\n      // Relative links require a public base URL; unsupported or malformed links are skipped.\n      return;\n    }\n\n    if (resolvedUrl.protocol !== \"http:\" && resolvedUrl.protocol !== \"https:\") {\n      return;\n    }\n\n    resolvedUrl.hash = \"\";\n    const normalizedUrl = resolvedUrl.href;\n    if (!seenUrls.has(normalizedUrl)) {\n      seenUrls.add(normalizedUrl);\n      urls.push(normalizedUrl);\n    }\n  });\n\n  const results = new Array<LinkStatus>(urls.length);\n  let nextIndex = 0;\n\n  async function checkLink(url: string): Promise<LinkStatus> {\n    try {\n      const headResult = await fetchPublicHttp(url, {\n        method: \"HEAD\",\n        headers: { \"User-Agent\": LINK_CHECK_USER_AGENT },\n        timeoutMs: LINK_CHECK_TIMEOUT_MS,\n        maxRedirects: 0,\n      });\n      const headStatus = headResult.response.status;\n      const headFinalUrl = headResult.url.href;\n      await cancelResponseBody(headResult.response);\n\n      // Some sites reject or do not implement HEAD even when the linked resource is available.\n      if (headStatus === 405 || headStatus === 403 || headStatus === 501) {\n        let getResult = await fetchPublicHttp(url, {\n          method: \"GET\",\n          headers: {\n            Range: \"bytes=0-0\",\n            \"User-Agent\": LINK_CHECK_USER_AGENT,\n          },\n          timeoutMs: LINK_CHECK_TIMEOUT_MS,\n          maxRedirects: 0,\n        });\n        if (getResult.response.status === 416) {\n          await cancelResponseBody(getResult.response);\n          getResult = await fetchPublicHttp(url, {\n            method: \"GET\",\n            headers: { \"User-Agent\": LINK_CHECK_USER_AGENT },\n            timeoutMs: LINK_CHECK_TIMEOUT_MS,\n            maxRedirects: 0,\n          });\n        }\n\n        const status = getResult.response.status;\n        const ok = status >= 200 && status < 400;\n        const finalUrl = getResult.url.href;\n        await cancelResponseBody(getResult.response);\n        return {\n          url,\n          status,\n          ok,\n          message:\n            status >= 300 && status < 400\n              ? \"Redirect not followed\"\n              : finalUrl !== url\n                ? `Redirected to ${finalUrl}`\n                : undefined,\n        };\n      }\n\n      return {\n        url,\n        status: headStatus,\n        ok: headStatus >= 200 && headStatus < 400,\n        message:\n          headStatus >= 300 && headStatus < 400\n            ? \"Redirect not followed\"\n            : headFinalUrl !== url\n              ? `Redirected to ${headFinalUrl}`\n              : undefined,\n      };\n    } catch (error: unknown) {\n      return {\n        url,\n        status: error instanceof PublicUrlError ? \"blocked\" : \"failed\",\n        ok: false,\n        message: getErrorMessage(error),\n      };\n    }\n  }\n\n  async function worker(): Promise<void> {\n    while (true) {\n      const index = nextIndex;\n      nextIndex += 1;\n      if (index >= urls.length) {\n        return;\n      }\n      results[index] = await checkLink(urls[index]);\n    }\n  }\n\n  const workerCount = Math.min(LINK_CHECK_CONCURRENCY, urls.length);\n  await Promise.all(Array.from({ length: workerCount }, () => worker()));\n  return results;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-web-validator",
-  "version": "1.3.21",
+  "version": "1.3.22",
   "description": "W3C HTML/CSS Validator and Technical SEO Audit MCP Server for AI coding assistants.",
   "main": "dist/index.js",
   "bin": {
@@ -54,7 +54,7 @@
     "cheerio": "^1.0.0",
     "encoding-sniffer": "1.0.2",
     "puppeteer-core": "25.11.0",
-    "undici": "^7.29.0",
+    "undici": "^7.29.1",
     "zod": "^4.4.3"
   },
   "devDependencies": {