npm - mcp-web-validator - Versions diffs - 1.3.9 → 1.3.11 - Mend

mcp-web-validator 1.3.9 → 1.3.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -4,6 +4,21 @@ All notable changes to this project are documented here. The project follows [Se
 ## [Unreleased]
+## [1.3.11] - 2026-09-21
+### Fixed
+- Stopped treating an omitted `rel="canonical"` preference as a score-penalizing SEO warning while preserving a warning for canonical declarations with an empty target.
+- Aligned hosted site-audit `robots.txt` HTTP status handling with RFC 9309: 4xx responses are treated as unavailable so sitemap discovery can continue, while 5xx responses prevent crawl candidates from being audited.
+- Scoped page title, description, viewport and canonical metadata checks to the document head so body/SVG lookalikes cannot satisfy page-level SEO metadata requirements.
+## [1.3.10] - 2026-09-21
+### Fixed
+- Kept JSON-LD syntax narration aligned with accepted `application/ld+json` media-type casing and parameters so valid parameterized blocks are not reported as absent.
+- Retried link probes without a byte range when the bounded GET fallback receives HTTP 416, preventing reachable zero-length or otherwise range-unsatisfiable resources from being reported as broken.
 ## [1.3.9] - 2026-09-21
 ### Fixed

package/dist/presentation.js CHANGED Viewed

@@ -1,3 +1,4 @@
+import * as cheerio from "cheerio";
 function collapseWhitespace(value, maxLength = 240) {
     const collapsed = value.replace(/\s+/g, " ").trim();
     if (collapsed.length <= maxLength) {
@@ -155,8 +156,11 @@ export function seoAuditContent(issues, totalIssues, truncated) {
     });
 }
 function countJsonLdBlocks(htmlContent) {
-    const matches = htmlContent.match(/<script\b(?=[^>]*\btype\s*=\s*(?:"application\/ld\+json"|'application\/ld\+json'|application\/ld\+json\b))[^>]*>/gi);
-    return matches?.length ?? 0;
+    const $ = cheerio.load(htmlContent);
+    return $("script[type]").filter((_, element) => {
+        const type = $(element).attr("type");
+        return type?.split(";", 1)[0].trim().toLowerCase() === "application/ld+json";
+    }).length;
 }
 export function schemaValidationContent(issues, totalIssues, truncated, htmlContent) {
     const blockCount = countJsonLdBlocks(htmlContent);

package/dist/presentation.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"presentation.js","sourceRoot":"","sources":["../src/presentation.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ValidationReport } from \"./report.js\";\nimport type { LinkStatus, SEOIssue } from \"./seo-auditor.js\";\nimport type { CSSMessage, W3CMessage } from \"./w3c-validator.js\";\n\ntype ActionPriority = 0 \| 1 \| 2;\n\ninterface ActionItem {\n message: string;\n priority: ActionPriority;\n location?: string;\n}\n\ninterface ValidationReportResult extends ValidationReport {\n errors?: string[];\n}\n\nfunction collapseWhitespace(value: string, maxLength = 240): string {\n const collapsed = value.replace(/\\s+/g, \" \").trim();\n if (collapsed.length <= maxLength) {\n return collapsed;\n }\n return `${collapsed.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;\n}\n\n/** Escapes untrusted text while leaving the surrounding, controlled Markdown intact. /\nfunction markdownText(value: string, maxLength = 240): string {\n return collapseWhitespace(value, maxLength)\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/\\\\/g, \"\\\\\\\\\")\n .replace(/([`_[\\]{}()#+\\-.!\|~])/g, \"\\\\$1\");\n}\n\n/** Wraps untrusted identifiers and paths in a code span that cannot be closed by their content. /\nfunction markdownCode(value: string, maxLength = 240): string {\n const collapsed = collapseWhitespace(value, maxLength);\n const longestBacktickRun = Math.max(\n 0,\n ...Array.from(collapsed.matchAll(/`+/g), (match) => match[0].length),\n );\n const delimiter = \"`\".repeat(longestBacktickRun + 1);\n const content = collapsed.startsWith(\"`\") \|\| collapsed.endsWith(\"`\")\n ? ` ${collapsed} `\n : collapsed;\n return `${delimiter}${content}${delimiter}`;\n}\n\nfunction countLabel(count: number, singular: string, plural = `${singular}s`): string {\n return `${count} ${count === 1 ? singular : plural}`;\n}\n\nfunction priorityForSeverity(severity: string): ActionPriority {\n if (severity.toLowerCase() === \"error\") return 0;\n if (severity.toLowerCase() === \"warning\") return 1;\n return 2;\n}\n\nfunction formatLocation(line?: number, column?: number): string \| undefined {\n if (line === undefined && column === undefined) return undefined;\n if (line === undefined) return `column ${column}`;\n if (column === undefined) return `line ${line}`;\n return `line ${line}, column ${column}`;\n}\n\nfunction formatActions(items: ActionItem[]): string \| undefined {\n const prioritized = items\n .map((item, index) => ({ item, index }))\n .sort((left, right) => left.item.priority - right.item.priority \|\| left.index - right.index)\n .slice(0, 3)\n .map(({ item }) => {\n const label = item.priority === 0 ? \"Error\" : item.priority === 1 ? \"Warning\" : \"Check\";\n const location = item.location\n ? ` · ${markdownCode(item.location, 120)}`\n : \"\";\n return `- ${label}${location}: ${markdownText(item.message)}`;\n });\n\n return prioritized.length > 0 ? prioritized.join(\"\\n\") : undefined;\n}\n\nfunction toolContent(options: {\n title: string;\n status: string;\n outcome: string;\n nextStep: string;\n actions?: ActionItem[];\n note?: string;\n}): string {\n const sections = [\n `### ${options.title}: ${options.status}`,\n collapseWhitespace(options.outcome, 500),\n ];\n if (options.note) {\n sections.push(collapseWhitespace(options.note, 500));\n }\n const actions = formatActions(options.actions ?? []);\n if (actions) {\n sections.push(`Fix first\\n${actions}`);\n }\n sections.push(`Next step:* ${collapseWhitespace(options.nextStep, 400)}`);\n return sections.join(\"\\n\\n\");\n}\n\nexport function htmlValidationContent(messages: W3CMessage[], source?: string): string {\n const errorCount = messages.filter((message) => message.type.toLowerCase() === \"error\").length;\n const otherCount = messages.length - errorCount;\n const sourceText = source ? ` for ${markdownCode(source, 180)}` : \"\";\n if (messages.length === 0) {\n return toolContent({\n title: \"HTML validation\",\n status: \"clean\",\n outcome: `The W3C validator returned no HTML diagnostics${sourceText}.`,\n nextStep: \"Keep this result as a baseline and validate again after the next markup change.\",\n });\n }\n\n return toolContent({\n title: \"HTML validation\",\n status: \"attention needed\",\n outcome: `The W3C validator returned ${countLabel(errorCount, \"error\")} and ${countLabel(otherCount, \"other diagnostic\")}${sourceText}.`,\n actions: messages.map((message) => ({\n priority: priorityForSeverity(message.type),\n message: message.message,\n location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),\n })),\n nextStep: \"Fix the errors in order, then rerun HTML validation to confirm the markup is clean.\",\n });\n}\n\nexport function cssValidationContent(messages: CSSMessage[]): string {\n if (messages.length === 0) {\n return toolContent({\n title: \"CSS validation\",\n status: \"clean\",\n outcome: \"The W3C validator returned no CSS errors.\",\n nextStep: \"Validate again after the next stylesheet change.\",\n });\n }\n\n const compatibilityLimitations = messages.filter(\n (message) => message.compatibility === \"known-validator-limitation\",\n );\n const actionableErrors = messages.length - compatibilityLimitations.length;\n\n return toolContent({\n title: \"CSS validation\",\n status: actionableErrors > 0 ? \"attention needed\" : \"review suggested\",\n outcome: compatibilityLimitations.length > 0\n ? `The W3C validator returned ${countLabel(messages.length, \"CSS error\")}; ${countLabel(compatibilityLimitations.length, \"diagnostic\")} ${compatibilityLimitations.length === 1 ? \"matches\" : \"match\"} a known validator limitation.`\n : `The W3C validator returned ${countLabel(messages.length, \"CSS error\")}.`,\n actions: messages.map((message) => ({\n priority: message.compatibility === \"known-validator-limitation\" ? 2 : 0,\n message: message.context ? `${message.message} Context: ${message.context}` : message.message,\n location: formatLocation(message.line),\n })),\n nextStep: actionableErrors > 0\n ? \"Correct the actionable errors, then rerun CSS validation because one syntax issue can cause later diagnostics.\"\n : \"Review the marked @container diagnostic against current CSS specifications; do not treat it as invalid CSS by itself.\",\n note: compatibilityLimitations.length > 0\n ? \"Jigsaw currently does not recognize the standards-defined @container rule. The upstream diagnostic is preserved and marked as a known validator limitation.\"\n : undefined,\n });\n}\n\nexport function seoAuditContent(issues: SEOIssue[], totalIssues: number, truncated: boolean): string {\n const errors = issues.filter((issue) => issue.severity === \"error\").length;\n const warnings = issues.filter((issue) => issue.severity === \"warning\").length;\n const info = issues.filter((issue) => issue.severity === \"info\").length;\n if (totalIssues === 0) {\n return toolContent({\n title: \"SEO audit\",\n status: \"clean within this audit\",\n outcome: \"This focused rules-based audit found no SEO or accessibility issues in the supplied HTML.\",\n nextStep: \"Keep the metadata current and rerun the audit whenever the page template changes.\",\n note: \"This result does not replace a crawl, performance test, or Search Console review.\",\n });\n }\n\n return toolContent({\n title: \"SEO audit\",\n status: \"attention needed\",\n outcome: `The audit found ${countLabel(errors, \"error\")}, ${countLabel(warnings, \"warning\")}, and ${countLabel(info, \"suggestion\")}.`,\n actions: issues.map((issue) => ({\n priority: priorityForSeverity(issue.severity),\n message: issue.message,\n location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,\n })),\n nextStep: \"Address errors first, then warnings, and rerun the audit after updating the page.\",\n note: truncated\n ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`\n : undefined,\n });\n}\n\nfunction countJsonLdBlocks(htmlContent: string): number {\n const matches = htmlContent.match(\n /<script\\b(?=[^>]\\btype\\s=\\s(?:\"application\\/ld\\+json\"\|'application\\/ld\\+json'\|application\\/ld\\+json\\b))[^>]>/gi,\n );\n return matches?.length ?? 0;\n}\n\nexport function schemaValidationContent(\n issues: SEOIssue[],\n totalIssues: number,\n truncated: boolean,\n htmlContent: string,\n): string {\n const blockCount = countJsonLdBlocks(htmlContent);\n if (blockCount === 0) {\n return toolContent({\n title: \"JSON-LD syntax\",\n status: \"not present\",\n outcome: \"No JSON-LD script blocks were found, so there was no structured data to parse.\",\n nextStep: \"Add JSON-LD only when it accurately describes visible page content, then validate it again.\",\n });\n }\n if (totalIssues === 0) {\n return toolContent({\n title: \"JSON-LD syntax\",\n status: \"clean\",\n outcome: `${countLabel(blockCount, \"JSON-LD block\")} parsed without syntax errors.`,\n nextStep: \"Verify the properties against the relevant Schema.org type and search-engine requirements.\",\n note: \"This check covers JSON syntax only; it does not validate vocabulary semantics or rich-result eligibility.\",\n });\n }\n\n return toolContent({\n title: \"JSON-LD syntax\",\n status: \"attention needed\",\n outcome: `${countLabel(totalIssues, \"syntax issue\")} ${totalIssues === 1 ? \"was\" : \"were\"} found across ${countLabel(blockCount, \"JSON-LD block\")}.`,\n actions: issues.map((issue) => ({\n priority: priorityForSeverity(issue.severity),\n message: issue.message,\n })),\n nextStep: \"Repair the invalid or empty blocks, then rerun this syntax check before testing rich-result eligibility.\",\n note: truncated\n ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`\n : undefined,\n });\n}\n\nfunction linkPriority(link: LinkStatus): ActionPriority {\n if (isRedirect(link)) return 1;\n return 0;\n}\n\nfunction isRedirect(link: LinkStatus): boolean {\n return typeof link.status === \"number\" && link.status >= 300 && link.status < 400;\n}\n\nfunction linkActionMessage(link: LinkStatus): string {\n if (isRedirect(link)) {\n return `${link.status} redirect; destination was not followed`;\n }\n return `Link returned ${typeof link.status === \"number\" ? `HTTP ${link.status}` : link.status}${link.message ? ` — ${link.message}` : \"\"}`;\n}\n\nexport function linkCheckContent(links: LinkStatus[], baseUrl?: string): string {\n if (links.length === 0) {\n return toolContent({\n title: \"Link check\",\n status: \"nothing checked\",\n outcome: \"No eligible public HTTP(S) links were found, so no link requests were made.\",\n nextStep: baseUrl\n ? \"Confirm the HTML contains reachable anchor URLs, then run the check again.\"\n : \"If the page uses relative links, provide its public base URL and run the check again.\",\n });\n }\n\n const unreachable = links.filter((link) => !link.ok);\n const redirects = links.filter(isRedirect);\n if (unreachable.length === 0 && redirects.length === 0) {\n return toolContent({\n title: \"Link check\",\n status: \"clean\",\n outcome: links.length === 1\n ? \"The checked link returned a successful response.\"\n : `All ${links.length} checked links returned a successful response.`,\n nextStep: \"Recheck periodically because external link availability can change.\",\n });\n }\n\n const actions = [\n ...unreachable,\n ...redirects,\n ].map((link) => ({\n priority: linkPriority(link),\n location: link.url,\n message: linkActionMessage(link),\n }));\n\n const linkOutcome = [\n unreachable.length > 0\n ? `${countLabel(unreachable.length, \"link\")} ${unreachable.length === 1 ? \"is\" : \"are\"} broken or unreachable`\n : \"no checked links are broken or unreachable\",\n redirects.length > 0\n ? `${countLabel(redirects.length, \"redirect\")} ${redirects.length === 1 ? \"needs\" : \"need\"} review`\n : undefined,\n ].filter((item): item is string => item !== undefined).join(\"; \");\n\n return toolContent({\n title: \"Link check\",\n status: unreachable.length > 0 ? \"attention needed\" : \"review suggested\",\n outcome: `${linkOutcome} of ${links.length} checked. Redirect destinations are not followed.`,\n actions,\n nextStep: \"Update failed destinations and review redirects, then rerun the link check.\",\n });\n}\n\nfunction reportActionItems(reportData: ValidationReportResult): ActionItem[] {\n return [\n ...(reportData.errors ?? []).map((message) => ({\n priority: 0 as const,\n message,\n })),\n ...reportData.htmlMessages.map((message) => ({\n priority: priorityForSeverity(message.type),\n message: `HTML: ${message.message}`,\n location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),\n })),\n ...reportData.cssMessages.map((message) => ({\n priority: message.compatibility === \"known-validator-limitation\" ? 2 as const : 0 as const,\n message: `CSS: ${message.message}`,\n location: formatLocation(message.line),\n })),\n ...reportData.seoIssues.map((issue) => ({\n priority: priorityForSeverity(issue.severity),\n message: `${issue.category}: ${issue.message}`,\n location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,\n })),\n ...reportData.schemaIssues.map((issue) => ({\n priority: priorityForSeverity(issue.severity),\n message: `JSON-LD: ${issue.message}`,\n })),\n ...reportData.links\n .filter((link) => !link.ok \|\| isRedirect(link))\n .map((link) => ({\n priority: linkPriority(link),\n message: linkActionMessage(link),\n location: link.url,\n })),\n ];\n}\n\nexport function reportContent(reportData: ValidationReportResult): string {\n const { summary } = reportData;\n const actions = reportActionItems(reportData);\n const partial = reportData.failedChecks.length > 0;\n const compatibilityLimited = summary.cssCompatibilityLimitations > 0;\n const hasActionableFinding = actions.some((action) => action.priority < 2);\n const status = partial\n ? \"partial\"\n : compatibilityLimited\n ? \"compatibility-limited\"\n : actions.length === 0\n ? \"clean across completed checks\"\n : hasActionableFinding\n ? \"attention needed\"\n : \"review suggested\";\n const cssSummary = summary.cssScore === null\n ? reportData.failedChecks.includes(\"css\")\n ? \"CSS validation unavailable\"\n : compatibilityLimited\n ? `${countLabel(summary.cssErrors, \"CSS error\")}, including ${countLabel(summary.cssCompatibilityLimitations, \"known validator limitation\")}`\n : \"CSS not audited\"\n : countLabel(summary.cssErrors, \"CSS error\");\n const redirects = reportData.links.filter(isRedirect).length;\n const linkSummary = summary.linkScore === null\n ? reportData.failedChecks.includes(\"links\")\n ? \"link checking unavailable\"\n : \"no eligible links checked\"\n : `${summary.brokenLinks} broken or unreachable and ${countLabel(redirects, \"redirect\")} to review of ${countLabel(summary.linksChecked, \"link\")}`;\n const checkLabels = {\n input: \"input file\",\n html: \"HTML validation\",\n css: \"CSS validation\",\n seo: \"SEO analysis\",\n schema: \"JSON-LD analysis\",\n links: \"link checking\",\n } as const;\n const unavailableChecks = reportData.failedChecks\n .filter((check) => check !== \"input\")\n .map((check) => checkLabels[check]);\n return toolContent({\n title: \"Validation report\",\n status,\n outcome: partial\n ? `Partial validation report: ${unavailableChecks.join(\", \")} ${unavailableChecks.length === 1 ? \"was\" : \"were\"} unavailable; remaining checks completed. HTML has ${countLabel(summary.htmlErrors, \"error\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`\n : compatibilityLimited\n ? `The overall heuristic score is withheld because CSS validation includes ${countLabel(summary.cssCompatibilityLimitations, \"known validator limitation\")}. HTML has ${countLabel(summary.htmlErrors, \"error\")} and ${countLabel(summary.htmlWarnings, \"other diagnostic\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")} and ${countLabel(summary.seoWarnings, \"warning\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`\n : `The report's heuristic overall score is ${summary.overallScore}/100. HTML has ${countLabel(summary.htmlErrors, \"error\")} and ${countLabel(summary.htmlWarnings, \"other diagnostic\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")} and ${countLabel(summary.seoWarnings, \"warning\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`,\n actions,\n nextStep: partial\n ? \"Review the completed findings, then retry the unavailable checks.\"\n : compatibilityLimited\n ? \"Review actionable findings normally, and treat the marked @container diagnostic as an upstream validator limitation rather than proof of invalid CSS.\"\n : actions.length === 0\n ? \"Use the full Markdown report as the audit record and rerun it after meaningful page changes.\"\n : \"Work through these priorities, then regenerate the report to compare the heuristic score.\",\n note: partial\n ? \"No overall score is shown while one or more checks are unavailable.\"\n : compatibilityLimited\n ? \"CSS and overall scores are withheld while a known Jigsaw parser limitation is present; the original upstream diagnostic remains visible.\"\n : \"The score is a triage heuristic based on these checks, not a Lighthouse score or a search-ranking prediction.\",\n });\n}\n\nexport function screenshotCaptureContent(count: number, outputDirectory: string): string {\n return toolContent({\n title: \"Screenshot capture\",\n status: \"complete\",\n outcome: `Saved ${countLabel(count, \"PNG screenshot\")} to ${markdownCode(outputDirectory)}.`,\n nextStep: \"Open the PNG files and compare the rendered layouts at each requested viewport.\",\n });\n}\n\nexport function failureContent(title: string, error: string, nextStep: string): string {\n return toolContent({\n title,\n status: \"could not finish\",\n outcome: markdownText(error, 500),\n nextStep,\n });\n}\n"]}
1	+ {"version":3,"file":"presentation.js","sourceRoot":"","sources":["../src/presentation.ts"],"names":[],"mappings":"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","sourcesContent":["import * as cheerio from \"cheerio\";\nimport type { ValidationReport } from \"./report.js\";\nimport type { LinkStatus, SEOIssue } from \"./seo-auditor.js\";\nimport type { CSSMessage, W3CMessage } from \"./w3c-validator.js\";\n\ntype ActionPriority = 0 \| 1 \| 2;\n\ninterface ActionItem {\n message: string;\n priority: ActionPriority;\n location?: string;\n}\n\ninterface ValidationReportResult extends ValidationReport {\n errors?: string[];\n}\n\nfunction collapseWhitespace(value: string, maxLength = 240): string {\n const collapsed = value.replace(/\\s+/g, \" \").trim();\n if (collapsed.length <= maxLength) {\n return collapsed;\n }\n return `${collapsed.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;\n}\n\n/** Escapes untrusted text while leaving the surrounding, controlled Markdown intact. /\nfunction markdownText(value: string, maxLength = 240): string {\n return collapseWhitespace(value, maxLength)\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/\\\\/g, \"\\\\\\\\\")\n .replace(/([`_[\\]{}()#+\\-.!\|~])/g, \"\\\\$1\");\n}\n\n/** Wraps untrusted identifiers and paths in a code span that cannot be closed by their content. /\nfunction markdownCode(value: string, maxLength = 240): string {\n const collapsed = collapseWhitespace(value, maxLength);\n const longestBacktickRun = Math.max(\n 0,\n ...Array.from(collapsed.matchAll(/`+/g), (match) => match[0].length),\n );\n const delimiter = \"`\".repeat(longestBacktickRun + 1);\n const content = collapsed.startsWith(\"`\") \|\| collapsed.endsWith(\"`\")\n ? ` ${collapsed} `\n : collapsed;\n return `${delimiter}${content}${delimiter}`;\n}\n\nfunction countLabel(count: number, singular: string, plural = `${singular}s`): string {\n return `${count} ${count === 1 ? singular : plural}`;\n}\n\nfunction priorityForSeverity(severity: string): ActionPriority {\n if (severity.toLowerCase() === \"error\") return 0;\n if (severity.toLowerCase() === \"warning\") return 1;\n return 2;\n}\n\nfunction formatLocation(line?: number, column?: number): string \| undefined {\n if (line === undefined && column === undefined) return undefined;\n if (line === undefined) return `column ${column}`;\n if (column === undefined) return `line ${line}`;\n return `line ${line}, column ${column}`;\n}\n\nfunction formatActions(items: ActionItem[]): string \| undefined {\n const prioritized = items\n .map((item, index) => ({ item, index }))\n .sort((left, right) => left.item.priority - right.item.priority \|\| left.index - right.index)\n .slice(0, 3)\n .map(({ item }) => {\n const label = item.priority === 0 ? \"Error\" : item.priority === 1 ? \"Warning\" : \"Check\";\n const location = item.location\n ? ` · ${markdownCode(item.location, 120)}`\n : \"\";\n return `- ${label}${location}: ${markdownText(item.message)}`;\n });\n\n return prioritized.length > 0 ? prioritized.join(\"\\n\") : undefined;\n}\n\nfunction toolContent(options: {\n title: string;\n status: string;\n outcome: string;\n nextStep: string;\n actions?: ActionItem[];\n note?: string;\n}): string {\n const sections = [\n `### ${options.title}: ${options.status}`,\n collapseWhitespace(options.outcome, 500),\n ];\n if (options.note) {\n sections.push(collapseWhitespace(options.note, 500));\n }\n const actions = formatActions(options.actions ?? []);\n if (actions) {\n sections.push(`Fix first\\n${actions}`);\n }\n sections.push(`Next step:* ${collapseWhitespace(options.nextStep, 400)}`);\n return sections.join(\"\\n\\n\");\n}\n\nexport function htmlValidationContent(messages: W3CMessage[], source?: string): string {\n const errorCount = messages.filter((message) => message.type.toLowerCase() === \"error\").length;\n const otherCount = messages.length - errorCount;\n const sourceText = source ? ` for ${markdownCode(source, 180)}` : \"\";\n if (messages.length === 0) {\n return toolContent({\n title: \"HTML validation\",\n status: \"clean\",\n outcome: `The W3C validator returned no HTML diagnostics${sourceText}.`,\n nextStep: \"Keep this result as a baseline and validate again after the next markup change.\",\n });\n }\n\n return toolContent({\n title: \"HTML validation\",\n status: \"attention needed\",\n outcome: `The W3C validator returned ${countLabel(errorCount, \"error\")} and ${countLabel(otherCount, \"other diagnostic\")}${sourceText}.`,\n actions: messages.map((message) => ({\n priority: priorityForSeverity(message.type),\n message: message.message,\n location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),\n })),\n nextStep: \"Fix the errors in order, then rerun HTML validation to confirm the markup is clean.\",\n });\n}\n\nexport function cssValidationContent(messages: CSSMessage[]): string {\n if (messages.length === 0) {\n return toolContent({\n title: \"CSS validation\",\n status: \"clean\",\n outcome: \"The W3C validator returned no CSS errors.\",\n nextStep: \"Validate again after the next stylesheet change.\",\n });\n }\n\n const compatibilityLimitations = messages.filter(\n (message) => message.compatibility === \"known-validator-limitation\",\n );\n const actionableErrors = messages.length - compatibilityLimitations.length;\n\n return toolContent({\n title: \"CSS validation\",\n status: actionableErrors > 0 ? \"attention needed\" : \"review suggested\",\n outcome: compatibilityLimitations.length > 0\n ? `The W3C validator returned ${countLabel(messages.length, \"CSS error\")}; ${countLabel(compatibilityLimitations.length, \"diagnostic\")} ${compatibilityLimitations.length === 1 ? \"matches\" : \"match\"} a known validator limitation.`\n : `The W3C validator returned ${countLabel(messages.length, \"CSS error\")}.`,\n actions: messages.map((message) => ({\n priority: message.compatibility === \"known-validator-limitation\" ? 2 : 0,\n message: message.context ? `${message.message} Context: ${message.context}` : message.message,\n location: formatLocation(message.line),\n })),\n nextStep: actionableErrors > 0\n ? \"Correct the actionable errors, then rerun CSS validation because one syntax issue can cause later diagnostics.\"\n : \"Review the marked @container diagnostic against current CSS specifications; do not treat it as invalid CSS by itself.\",\n note: compatibilityLimitations.length > 0\n ? \"Jigsaw currently does not recognize the standards-defined @container rule. The upstream diagnostic is preserved and marked as a known validator limitation.\"\n : undefined,\n });\n}\n\nexport function seoAuditContent(issues: SEOIssue[], totalIssues: number, truncated: boolean): string {\n const errors = issues.filter((issue) => issue.severity === \"error\").length;\n const warnings = issues.filter((issue) => issue.severity === \"warning\").length;\n const info = issues.filter((issue) => issue.severity === \"info\").length;\n if (totalIssues === 0) {\n return toolContent({\n title: \"SEO audit\",\n status: \"clean within this audit\",\n outcome: \"This focused rules-based audit found no SEO or accessibility issues in the supplied HTML.\",\n nextStep: \"Keep the metadata current and rerun the audit whenever the page template changes.\",\n note: \"This result does not replace a crawl, performance test, or Search Console review.\",\n });\n }\n\n return toolContent({\n title: \"SEO audit\",\n status: \"attention needed\",\n outcome: `The audit found ${countLabel(errors, \"error\")}, ${countLabel(warnings, \"warning\")}, and ${countLabel(info, \"suggestion\")}.`,\n actions: issues.map((issue) => ({\n priority: priorityForSeverity(issue.severity),\n message: issue.message,\n location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,\n })),\n nextStep: \"Address errors first, then warnings, and rerun the audit after updating the page.\",\n note: truncated\n ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`\n : undefined,\n });\n}\n\nfunction countJsonLdBlocks(htmlContent: string): number {\n const $ = cheerio.load(htmlContent);\n return $(\"script[type]\").filter((_, element) => {\n const type = $(element).attr(\"type\");\n return type?.split(\";\", 1)[0].trim().toLowerCase() === \"application/ld+json\";\n }).length;\n}\n\nexport function schemaValidationContent(\n issues: SEOIssue[],\n totalIssues: number,\n truncated: boolean,\n htmlContent: string,\n): string {\n const blockCount = countJsonLdBlocks(htmlContent);\n if (blockCount === 0) {\n return toolContent({\n title: \"JSON-LD syntax\",\n status: \"not present\",\n outcome: \"No JSON-LD script blocks were found, so there was no structured data to parse.\",\n nextStep: \"Add JSON-LD only when it accurately describes visible page content, then validate it again.\",\n });\n }\n if (totalIssues === 0) {\n return toolContent({\n title: \"JSON-LD syntax\",\n status: \"clean\",\n outcome: `${countLabel(blockCount, \"JSON-LD block\")} parsed without syntax errors.`,\n nextStep: \"Verify the properties against the relevant Schema.org type and search-engine requirements.\",\n note: \"This check covers JSON syntax only; it does not validate vocabulary semantics or rich-result eligibility.\",\n });\n }\n\n return toolContent({\n title: \"JSON-LD syntax\",\n status: \"attention needed\",\n outcome: `${countLabel(totalIssues, \"syntax issue\")} ${totalIssues === 1 ? \"was\" : \"were\"} found across ${countLabel(blockCount, \"JSON-LD block\")}.`,\n actions: issues.map((issue) => ({\n priority: priorityForSeverity(issue.severity),\n message: issue.message,\n })),\n nextStep: \"Repair the invalid or empty blocks, then rerun this syntax check before testing rich-result eligibility.\",\n note: truncated\n ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`\n : undefined,\n });\n}\n\nfunction linkPriority(link: LinkStatus): ActionPriority {\n if (isRedirect(link)) return 1;\n return 0;\n}\n\nfunction isRedirect(link: LinkStatus): boolean {\n return typeof link.status === \"number\" && link.status >= 300 && link.status < 400;\n}\n\nfunction linkActionMessage(link: LinkStatus): string {\n if (isRedirect(link)) {\n return `${link.status} redirect; destination was not followed`;\n }\n return `Link returned ${typeof link.status === \"number\" ? `HTTP ${link.status}` : link.status}${link.message ? ` — ${link.message}` : \"\"}`;\n}\n\nexport function linkCheckContent(links: LinkStatus[], baseUrl?: string): string {\n if (links.length === 0) {\n return toolContent({\n title: \"Link check\",\n status: \"nothing checked\",\n outcome: \"No eligible public HTTP(S) links were found, so no link requests were made.\",\n nextStep: baseUrl\n ? \"Confirm the HTML contains reachable anchor URLs, then run the check again.\"\n : \"If the page uses relative links, provide its public base URL and run the check again.\",\n });\n }\n\n const unreachable = links.filter((link) => !link.ok);\n const redirects = links.filter(isRedirect);\n if (unreachable.length === 0 && redirects.length === 0) {\n return toolContent({\n title: \"Link check\",\n status: \"clean\",\n outcome: links.length === 1\n ? \"The checked link returned a successful response.\"\n : `All ${links.length} checked links returned a successful response.`,\n nextStep: \"Recheck periodically because external link availability can change.\",\n });\n }\n\n const actions = [\n ...unreachable,\n ...redirects,\n ].map((link) => ({\n priority: linkPriority(link),\n location: link.url,\n message: linkActionMessage(link),\n }));\n\n const linkOutcome = [\n unreachable.length > 0\n ? `${countLabel(unreachable.length, \"link\")} ${unreachable.length === 1 ? \"is\" : \"are\"} broken or unreachable`\n : \"no checked links are broken or unreachable\",\n redirects.length > 0\n ? `${countLabel(redirects.length, \"redirect\")} ${redirects.length === 1 ? \"needs\" : \"need\"} review`\n : undefined,\n ].filter((item): item is string => item !== undefined).join(\"; \");\n\n return toolContent({\n title: \"Link check\",\n status: unreachable.length > 0 ? \"attention needed\" : \"review suggested\",\n outcome: `${linkOutcome} of ${links.length} checked. Redirect destinations are not followed.`,\n actions,\n nextStep: \"Update failed destinations and review redirects, then rerun the link check.\",\n });\n}\n\nfunction reportActionItems(reportData: ValidationReportResult): ActionItem[] {\n return [\n ...(reportData.errors ?? []).map((message) => ({\n priority: 0 as const,\n message,\n })),\n ...reportData.htmlMessages.map((message) => ({\n priority: priorityForSeverity(message.type),\n message: `HTML: ${message.message}`,\n location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),\n })),\n ...reportData.cssMessages.map((message) => ({\n priority: message.compatibility === \"known-validator-limitation\" ? 2 as const : 0 as const,\n message: `CSS: ${message.message}`,\n location: formatLocation(message.line),\n })),\n ...reportData.seoIssues.map((issue) => ({\n priority: priorityForSeverity(issue.severity),\n message: `${issue.category}: ${issue.message}`,\n location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,\n })),\n ...reportData.schemaIssues.map((issue) => ({\n priority: priorityForSeverity(issue.severity),\n message: `JSON-LD: ${issue.message}`,\n })),\n ...reportData.links\n .filter((link) => !link.ok \|\| isRedirect(link))\n .map((link) => ({\n priority: linkPriority(link),\n message: linkActionMessage(link),\n location: link.url,\n })),\n ];\n}\n\nexport function reportContent(reportData: ValidationReportResult): string {\n const { summary } = reportData;\n const actions = reportActionItems(reportData);\n const partial = reportData.failedChecks.length > 0;\n const compatibilityLimited = summary.cssCompatibilityLimitations > 0;\n const hasActionableFinding = actions.some((action) => action.priority < 2);\n const status = partial\n ? \"partial\"\n : compatibilityLimited\n ? \"compatibility-limited\"\n : actions.length === 0\n ? \"clean across completed checks\"\n : hasActionableFinding\n ? \"attention needed\"\n : \"review suggested\";\n const cssSummary = summary.cssScore === null\n ? reportData.failedChecks.includes(\"css\")\n ? \"CSS validation unavailable\"\n : compatibilityLimited\n ? `${countLabel(summary.cssErrors, \"CSS error\")}, including ${countLabel(summary.cssCompatibilityLimitations, \"known validator limitation\")}`\n : \"CSS not audited\"\n : countLabel(summary.cssErrors, \"CSS error\");\n const redirects = reportData.links.filter(isRedirect).length;\n const linkSummary = summary.linkScore === null\n ? reportData.failedChecks.includes(\"links\")\n ? \"link checking unavailable\"\n : \"no eligible links checked\"\n : `${summary.brokenLinks} broken or unreachable and ${countLabel(redirects, \"redirect\")} to review of ${countLabel(summary.linksChecked, \"link\")}`;\n const checkLabels = {\n input: \"input file\",\n html: \"HTML validation\",\n css: \"CSS validation\",\n seo: \"SEO analysis\",\n schema: \"JSON-LD analysis\",\n links: \"link checking\",\n } as const;\n const unavailableChecks = reportData.failedChecks\n .filter((check) => check !== \"input\")\n .map((check) => checkLabels[check]);\n return toolContent({\n title: \"Validation report\",\n status,\n outcome: partial\n ? `Partial validation report: ${unavailableChecks.join(\", \")} ${unavailableChecks.length === 1 ? \"was\" : \"were\"} unavailable; remaining checks completed. HTML has ${countLabel(summary.htmlErrors, \"error\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`\n : compatibilityLimited\n ? `The overall heuristic score is withheld because CSS validation includes ${countLabel(summary.cssCompatibilityLimitations, \"known validator limitation\")}. HTML has ${countLabel(summary.htmlErrors, \"error\")} and ${countLabel(summary.htmlWarnings, \"other diagnostic\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")} and ${countLabel(summary.seoWarnings, \"warning\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`\n : `The report's heuristic overall score is ${summary.overallScore}/100. HTML has ${countLabel(summary.htmlErrors, \"error\")} and ${countLabel(summary.htmlWarnings, \"other diagnostic\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")} and ${countLabel(summary.seoWarnings, \"warning\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`,\n actions,\n nextStep: partial\n ? \"Review the completed findings, then retry the unavailable checks.\"\n : compatibilityLimited\n ? \"Review actionable findings normally, and treat the marked @container diagnostic as an upstream validator limitation rather than proof of invalid CSS.\"\n : actions.length === 0\n ? \"Use the full Markdown report as the audit record and rerun it after meaningful page changes.\"\n : \"Work through these priorities, then regenerate the report to compare the heuristic score.\",\n note: partial\n ? \"No overall score is shown while one or more checks are unavailable.\"\n : compatibilityLimited\n ? \"CSS and overall scores are withheld while a known Jigsaw parser limitation is present; the original upstream diagnostic remains visible.\"\n : \"The score is a triage heuristic based on these checks, not a Lighthouse score or a search-ranking prediction.\",\n });\n}\n\nexport function screenshotCaptureContent(count: number, outputDirectory: string): string {\n return toolContent({\n title: \"Screenshot capture\",\n status: \"complete\",\n outcome: `Saved ${countLabel(count, \"PNG screenshot\")} to ${markdownCode(outputDirectory)}.`,\n nextStep: \"Open the PNG files and compare the rendered layouts at each requested viewport.\",\n });\n}\n\nexport function failureContent(title: string, error: string, nextStep: string): string {\n return toolContent({\n title,\n status: \"could not finish\",\n outcome: markdownText(error, 500),\n nextStep,\n });\n}\n"]}

package/dist/seo-auditor.js CHANGED Viewed

@@ -40,7 +40,7 @@ export function auditSeoMetadataDetailed(htmlContent) {
     const collector = createIssueCollector();
     const { add } = collector;
     // --- Title Tag Audits ---
-    const titleTag = $("title");
+    const titleTag = $("head > title");
     if (titleTag.length === 0) {
         add({
             code: "seo.title.missing_or_empty",
@@ -79,7 +79,7 @@ export function auditSeoMetadataDetailed(htmlContent) {
         }
     }
     // --- Meta Description Audits ---
-    const metaDescription = $('meta[name="description" i]');
+    const metaDescription = $('head > meta[name="description" i]');
     if (metaDescription.length === 0) {
         add({
             code: "seo.meta_description.missing_or_empty",
@@ -118,24 +118,32 @@ export function auditSeoMetadataDetailed(htmlContent) {
         }
     }
     // --- Canonical Link ---
-    const canonical = $("link[rel]").filter((_, element) => {
+    const canonicalLinks = $("head > link[rel]").filter((_, element) => {
         const rel = $(element).attr("rel") ?? "";
-        const hasCanonicalToken = rel
+        return rel
             .trim()
             .split(/[\t\n\f\r ]+/)
             .some((token) => token.toLowerCase() === "canonical");
-        return hasCanonicalToken && Boolean($(element).attr("href")?.trim());
     });
-    if (canonical.length === 0) {
+    const usableCanonical = canonicalLinks.filter((_, element) => Boolean($(element).attr("href")?.trim()));
+    if (canonicalLinks.length === 0) {
+        add({
+            code: "seo.canonical.missing",
+            severity: "info",
+            category: "SEO",
+            message: "No rel=\"canonical\" preference is declared. This is optional unless the page needs an explicit canonicalization signal.",
+        });
+    }
+    else if (usableCanonical.length === 0) {
         add({
             code: "seo.canonical.missing",
             severity: "warning",
             category: "SEO",
-            message: "Missing or empty canonical link target. Add a non-empty href to <link rel=\"canonical\"> when this page needs an explicit canonical signal.",
+            message: "Canonical link is present but its href is empty. Provide a usable canonical target or remove the declaration.",
         });
     }
     // --- Viewport Meta Tag (Mobile Responsiveness) ---
-    const viewport = $('meta[name="viewport" i]');
+    const viewport = $('head > meta[name="viewport" i]');
     if (viewport.length === 0) {
         add({
             code: "seo.viewport.missing",
@@ -306,7 +314,7 @@ export async function checkBrokenLinks(htmlContent, baseUrl, maxLinks = MAX_LINK
             await cancelResponseBody(headResult.response);
             // Some sites reject or do not implement HEAD even when the linked resource is available.
             if (headStatus === 405 || headStatus === 403 || headStatus === 501) {
-                const getResult = await fetchPublicHttp(url, {
+                let getResult = await fetchPublicHttp(url, {
                     method: "GET",
                     headers: {
                         Range: "bytes=0-0",
@@ -315,6 +323,15 @@ export async function checkBrokenLinks(htmlContent, baseUrl, maxLinks = MAX_LINK
                     timeoutMs: LINK_CHECK_TIMEOUT_MS,
                     maxRedirects: 0,
                 });
+                if (getResult.response.status === 416) {
+                    await cancelResponseBody(getResult.response);
+                    getResult = await fetchPublicHttp(url, {
+                        method: "GET",
+                        headers: { "User-Agent": LINK_CHECK_USER_AGENT },
+                        timeoutMs: LINK_CHECK_TIMEOUT_MS,
+                        maxRedirects: 0,
+                    });
+                }
                 const status = getResult.response.status;
                 const ok = status >= 200 && status < 400;
                 const finalUrl = getResult.url.href;

package/dist/seo-auditor.js.map CHANGED Viewed

	@@ -1 +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 AuditDetails {\n issues: SEOIssue[];\n totalIssues: number;\n truncated: boolean;\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 return {\n issues,\n add(issue) {\n totalIssues += 1;\n addIssue(issues, issue);\n },\n details() {\n return {\n issues,\n totalIssues,\n truncated: totalIssues > issues.length,\n };\n },\n };\n}\n\nfunction isJsonLdScriptType(type: string \| undefined): boolean {\n return type?.split(\";\", 1)[0].trim().toLowerCase() === \"application/ld+json\";\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 = $(\"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: \"warning\",\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: \"warning\",\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 = $('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: \"warning\",\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: \"warning\",\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 canonical = $(\"link[rel]\").filter((_, element) => {\n const rel = $(element).attr(\"rel\") ?? \"\";\n const hasCanonicalToken = rel\n .trim()\n .split(/[\\t\\n\\f\\r ]+/)\n .some((token) => token.toLowerCase() === \"canonical\");\n return hasCanonicalToken && Boolean($(element).attr(\"href\")?.trim());\n });\n if (canonical.length === 0) {\n add({\n code: \"seo.canonical.missing\",\n severity: \"warning\",\n category: \"SEO\",\n message: \"Missing or empty canonical link target. Add a non-empty href to <link rel=\\\"canonical\\\"> when this page needs an explicit canonical signal.\",\n });\n }\n\n // --- Viewport Meta Tag (Mobile Responsiveness) ---\n const viewport = $('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 }\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 = $('meta[property=\"og:title\"]');\n const ogImage = $('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 JSON.parse(scriptText);\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 let parsedBaseUrl = baseUrl ? await assertPublicHttpUrl(baseUrl) : undefined;\n if (!parsedBaseUrl) {\n const documentBaseHref = $(\"base[href]\").first().attr(\"href\")?.trim();\n if (documentBaseHref) {\n try {\n parsedBaseUrl = await assertPublicHttpUrl(documentBaseHref);\n } catch (error: unknown) {\n if (!(error instanceof PublicUrlError)) {\n throw error;\n }\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 const 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 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"]}
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 AuditDetails {\n issues: SEOIssue[];\n totalIssues: number;\n truncated: boolean;\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 return {\n issues,\n add(issue) {\n totalIssues += 1;\n addIssue(issues, issue);\n },\n details() {\n return {\n issues,\n totalIssues,\n truncated: totalIssues > issues.length,\n };\n },\n };\n}\n\nfunction isJsonLdScriptType(type: string \| undefined): boolean {\n return type?.split(\";\", 1)[0].trim().toLowerCase() === \"application/ld+json\";\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: \"warning\",\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: \"warning\",\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: \"warning\",\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: \"warning\",\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 usableCanonical = canonicalLinks.filter((_, element) => Boolean($(element).attr(\"href\")?.trim()));\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 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\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 }\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 = $('meta[property=\"og:title\"]');\n const ogImage = $('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 JSON.parse(scriptText);\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 let parsedBaseUrl = baseUrl ? await assertPublicHttpUrl(baseUrl) : undefined;\n if (!parsedBaseUrl) {\n const documentBaseHref = $(\"base[href]\").first().attr(\"href\")?.trim();\n if (documentBaseHref) {\n try {\n parsedBaseUrl = await assertPublicHttpUrl(documentBaseHref);\n } catch (error: unknown) {\n if (!(error instanceof PublicUrlError)) {\n throw error;\n }\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 CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "mcp-web-validator",
-  "version": "1.3.9",
+  "version": "1.3.11",
   "description": "W3C HTML/CSS Validator and Technical SEO Audit MCP Server for AI coding assistants.",
   "main": "dist/index.js",
   "bin": {