Canonical Conflict & SEO URL Detector

Official

Audits HTML & HTTP header canonicals (RFC 8288), verifies self-referencing URLs, unpacks XML sitemaps, uncovers JS hydration mismatches, and actively probes canonical targets for 404s, redirect loops, and noindex contradictions.

byBrowserMesh

•SEO & Auditing👑 free•

#Technical SEO#XML Sitemap#Audit & QA

4.8(0 reviews)

1installs

About Canonical Conflict & SEO URL Detector

Core Capabilities

Dual-Layer Canonical Auditing

Simultaneously inspects HTML document <head> declarations and RFC 8288 HTTP Link response headers to prevent conflicting signals and search indexation drops.

2026 JS Hydration & DOM Linter

Compares static server HTML against client-rendered DOM states to detect hydration mismatches and flags invalid elements prematurely closing <head>.

XML Sitemap Auto-Ingestion

Ingests direct XML sitemaps (.xml, .xml.gz, /sitemap), uncompresses gzip archives, expands recursive sitemap indexes, and audits child URLs up to user limits.

Active Target Reachability Prober

Actively verifies canonical targets for HTTP 404/5xx dead ends, traces 301/302 redirect chains up to 5 hops, detects circular loops, and catches noindex traps.

Calibrated 0–100 Health Scoring

Applies severity-weighted deductions across 14 failure modes with critical safety caps (max -60) and strict score ceilings (max 70 for errors, max 89 for warnings).

Triple-Engine Auto-Escalation

Executes ultra-fast HTTP audits (~300ms) with automatic stealth Playwright browser escalation for Cloudflare challenges, SPAs, and anti-bot protected sites.

Usage Examples

Templates & workflows

3 Templates

Single URL & Landing Page Audit

Audit primary landing pages and marketing URLs to verify self-referencing canonical tags, OpenGraph alignment, and target reachability.

Input Configurationjson

{
  "urls": "https://www.browsermesh.in/, https://startten.com/, https://befhue.com/",
  "limit": -1,
  "timeout": 30,
  "scrapeMode": "auto",
  "concurrency": 8,
  "checkSocialTags": true,
  "maxSitemapPages": 50,
  "probeCanonicalTarget": true
}

Deep XML Sitemap Domain Sweep

Automatically unpack XML sitemaps and recursively audit catalog, product, and blog pages for canonical conflicts, 404 targets, and uncanonicalized URLs.

Input Configurationjson

{
  "urls": "https://www.saravanabhavan.com/sitemap.xml, https://mistral.ai/sitemap.xml",
  "limit": -1,
  "timeout": 30,
  "scrapeMode": "auto",
  "concurrency": 8,
  "checkSocialTags": true,
  "maxSitemapPages": 50,
  "probeCanonicalTarget": true
}

High-Speed Technical SEO Batch

Lightning-fast pure HTTP canonical audit across hundreds of URLs to detect missing canonicals, protocol downgrades, and redirect hops.

Input Configurationjson

{
  "urls": "https://example.com/page-1, https://example.com/page-2, https://example.com/page-3",
  "limit": -1,
  "timeout": 20,
  "scrapeMode": "http",
  "concurrency": 15,
  "checkSocialTags": false,
  "maxSitemapPages": 20,
  "probeCanonicalTarget": true
}

README

Canonical Conflict & SEO URL Detector

An enterprise-grade, high-performance Canonical Conflict, Dual-Layer Link Header & HTML Tag Validator, and Technical SEO URL Auditor for BrowserMesh.

Audits web pages for canonical tag configuration, cross-references HTML <head> declarations against RFC 8288 HTTP Link: rel="canonical" headers, uncovers client-side JavaScript hydration mismatches, auto-expands XML sitemaps, and actively probes canonical destinations for HTTP 404s, redirect loops, and noindex traps.

The definitive modern alternative to Screaming Frog SEO Spider (£209/yr), Sitebulb, Ahrefs Site Audit, and brittle custom Python scrapers.

🎯 Target Audience & Industry Solutions

Technical SEO Directors & Webmasters: Protect revenue-critical landing pages from accidental de-indexing, ranking dilution, and Google Search Console "Duplicate, Google chose different canonical than user" overrides.
E-Commerce & Marketplace Engineers (Shopify, Magento, WooCommerce): Detect canonical traps caused by faceted navigation, sorting queries (?sort=price_asc), tracking parameters (?fbclid=..., ?utm_source=...), and pagination series (?page=2).
Full-Stack & Headless CMS Developers (Next.js, Nuxt, Remix, React 19): Audit server-rendered HTML canonicals against client-hydrated DOM states to prevent Hydration Canonical Mismatches penalized under Google's 2026 JavaScript SEO guidelines.
DevOps & Cloudflare Edge Engineers: Eliminate severe canonical conflicts where Edge CDN workers inject HTTP Link headers that contradict CMS-generated HTML canonical tags.
Enterprise Auditing & Digital Agencies: Audit entire domains via XML Sitemap auto-ingestion with bounded concurrency and real-time streaming output.

🚀 Key Features

1. Dual-Layer Canonical Declaration Auditing

Inspects canonical configurations across both network layers:

HTML Document Head (<link rel="canonical" href="...">): Parses <head> declarations, resolves relative paths, checks for multiple tags, and detects placement in <body>.
HTTP Response Headers (RFC 8288 / RFC 5988 Link: <...>; rel="canonical"): Parses edge CDN and API gateway link headers, extracting destinations even for non-HTML assets (PDFs, downloadable whitepapers).
Conflict Resolution: Immediately flags critical contradictions if the HTML tag and HTTP header specify different canonical targets (which causes search engines to ignore all canonicals).

2. 2026 JavaScript Hydration & DOM Linter

Hydration Invariance: Detects when raw static server HTML canonicals differ from client-rendered DOM canonicals.
Premature <head> Closure Detection: Flags when non-metadata elements (<img>, <iframe>, misplaced <div>) before <link rel="canonical"> force the browser or Googlebot parser to close <head> early and relegate canonical tags into <body>.

3. XML Sitemap Auto-Ingestion & Verification

Dual Input Modes: Accepts individual webpage URLs, multi-line URL batches, or direct XML Sitemap URLs (.xml, .xml.gz, /sitemap).
Recursive Sitemap Expansion: Automatically uncompresses gzip payloads, unpacks <sitemapindex> hierarchies, and audits child URLs up to the user-specified page limit.
Sitemap Self-Canonical Verification: Ensures all sitemap URLs are properly self-referencing.

4. Active Target Reachability Prober

Dead Canonical Trap Detection: Performs lightweight HTTP verification to ensure canonical destinations return HTTP 200 OK, not 404 Not Found, 410 Gone, or 500 Server Error.
Redirect Chain & Loop Detection: Traces redirect hops (301, 302, 307, 308) up to 5 levels, capturing the final destination URL and detecting circular loops (Page A <-> Page B).
Contradictory noindex Traps: Detects if the canonical destination contains a <meta name="robots" content="noindex"> tag or X-Robots-Tag: noindex header.

5. Social & Structured URL Cross-Check

Cross-references canonical URLs against OpenGraph meta[property="og:url"] and Twitter Card meta[name="twitter:url"].
Prevents fragmented social engagement and incorrect social link sharing previews.

6. Calibrated 0–100 Health Scoring Engine

Evaluates pages across 14 failure modes with severity-weighted deductions.
Enforces critical safety caps (max 60 deduction) and warning safety caps (max 30 deduction).
Ceilings ensure pages with active critical errors cannot receive scores above 70 (capped at 'Needs Improvement'), and pages with warning issues cannot receive scores above 89 (capped at 'Good', strictly reserving 'Excellent' for 100% clean setups).

📋 22-Field Output Contract

Every yielded record strictly adheres to these 22 structured fields:

Field Name	Type	Description
`url`	`string`	The webpage URL tested.
`domain`	`string`	Clean root domain (e.g. `browsermesh.in`).
`statusCode`	`number`	HTTP status code of the page (200, 301, 404, etc.).
`status`	`string`	Overall health: `'healthy'`, `'has_warnings'`, `'has_errors'`, `'error'`.
`hasCanonical`	`boolean`	`true` if at least one canonical tag or header was detected.
`canonicalUrl`	`string \| null`	Winning primary resolved canonical URL.
`isSelfReferencing`	`boolean`	`true` if the canonical URL matches the page URL.
`htmlCanonical`	`string \| null`	Raw canonical URL from HTML `<link rel="canonical">`.
`headerCanonical`	`string \| null`	Raw canonical URL from HTTP `Link: rel="canonical"` header.
`multipleCanonicalsFound`	`boolean`	`true` if multiple `<link>` tags exist or HTML disagrees with header.
`allCanonicalTags`	`string[]`	Array of all declared canonical URL strings found on the page.
`canonicalSource`	`string`	Where canonical was declared: `'html'`, `'header'`, `'both'`, `'none'`.
`ogUrl`	`string \| null`	OpenGraph `og:url` value (or `null`).
`isOgUrlAligned`	`boolean \| null`	`true` if `og:url` matches canonical URL (`null` if no `og:url`).
`targetStatusCode`	`number`	HTTP status of canonical destination (200, 301, 404; 0 if skipped).
`targetFinalUrl`	`string \| null`	Final destination URL if canonical target redirects (or `null`).
`targetIsRedirect`	`boolean`	`true` if canonical target redirects (301, 302, 307, 308).
`targetIsNoindex`	`boolean`	`true` if canonical target has `noindex` header or meta tag.
`hasCanonicalConflict`	`boolean`	`true` if any critical conflict or warning was triggered.
`audit`	`object`	Objective 0–100 Health Score, grade, issues list, and metric counts.
`summary`	`string`	Human-readable audit summary string for the page or site-level summary record.
`error`	`string \| null`	Clean human-readable error message on failure, or `null` on success.

⚙️ Configuration Parameters (`schema.ts`)

Parameter	Type	Default	Description
`urls`	`string`	(Required)	Webpage URLs, domains, or direct XML Sitemap URLs (e.g. `https://example.com/sitemap.xml`).
`scrapeMode`	`select`	`'auto'`	Execution engine: `'auto'` (Fast HTTP with stealth browser fallback & JS check), `'http'`, or `'browser'`.
`probeCanonicalTarget`	`boolean`	`true`	Actively probes canonical target to verify 200 OK status, redirect hops, loops, and noindex traps.
`checkSocialTags`	`boolean`	`true`	Cross-checks search canonical against OpenGraph `og:url` and Twitter URL.
`maxSitemapPages`	`number`	`50`	Maximum child URLs to extract and audit if an XML sitemap URL is supplied (-1 for unlimited, default 50).
`concurrency`	`number`	`8`	Number of URLs to audit in parallel (1–20).
`timeout`	`number`	`30`	Maximum network timeout in seconds per URL probe (5–60).
`limit`	`number`	`-1`	Maximum total records to output (-1 for all).

🏆 Scoring & Diagnostic Issue Taxonomy

Issue Code	Severity	Deduction	Description
`canonical_target_404`	Critical	-20 pts	Canonical destination returns HTTP 404/410 broken status.
`canonical_target_5xx`	Critical	-20 pts	Canonical destination returns HTTP 500/502/503 server error.
`canonical_target_noindex`	Critical	-20 pts	Canonical destination contains a `noindex` meta tag or header.
`multiple_conflicting_canonicals`	Critical	-20 pts	Multiple conflicting canonical tags or HTML head disagrees with HTTP header.
`canonical_loop`	Critical	-20 pts	Circular canonical loop (Page A $\leftrightarrow$ Page B).
`hydration_canonical_mismatch`	Critical	-15 pts	Static server HTML canonical differs from client JS hydrated canonical.
`canonical_in_body_or_premature_head`	Critical	-15 pts	Canonical tag inside `<body>` or pushed out of `<head>` by invalid elements.
`canonical_target_disallowed`	Critical	-15 pts	Canonical destination is blocked by `robots.txt` disallow rules.
`canonical_target_redirect`	Warning	-10 pts	Canonical destination returns HTTP 301/302 redirect hop.
`protocol_downgrade_http`	Warning	-10 pts	Secure HTTPS page canonicalizes to insecure HTTP URL.
`cross_subdomain_mismatch`	Warning	-10 pts	Canonical points across different subdomains or staging environments.
`canonical_chain`	Warning	-10 pts	Multi-hop canonical chain (Page A $\to$ Page B $\to$ Page C).
`paginated_canonical_to_root`	Warning	-10 pts	Paginated page (`?page=2`) canonicalizes to root page 1.
`missing_canonical`	Warning	-5 pts	Webpage declares no canonical tag or HTTP Link header.
`relative_canonical_url`	Warning	-5 pts	Canonical href is relative instead of absolute.
`canonical_has_fragment`	Warning	-5 pts	Canonical URL includes an anchor fragment (`#...`).
`trailing_slash_mismatch`	Warning	-5 pts	Inconsistent trailing slash between page and canonical target.
`sitemap_not_found_fallback`	Warning	-10 pts	XML sitemap not found; auto-fell back to root website & internal routes.
`site_canonical_warnings_detected`	Warning	0 pts	Site audit detected warning-level issues across one or more pages.
`site_canonical_errors_detected`	Critical	0 pts	Site audit detected critical canonical conflicts across pages.
`og_url_mismatch`	Info	0 pts	OpenGraph `og:url` differs from canonical URL.
`self_referencing_canonical`	Info	0 pts	Valid self-referencing canonical tag verified.
`canonicalized_clean_url`	Info	0 pts	Parameter or tracking query consolidated to clean canonical master URL.
`site_audit_summary`	Info	0 pts	Site-wide audit roll-up summary completed.

🛠️ Architecture

Built on BrowserMesh's modular split-file TypeScript ESM architecture:

index.ts: Plugin entry point, metadata declaration, and lifecycle hooks.
scraper.ts: AsyncGenerator streaming runner, sitemap expansion, multi-engine executor, and active target prober.
parser.ts: RFC 8288 link header parser, Cheerio HTML DOM extractor, premature head closure linter, and 0–100 scoring engine.
config.ts: Scoring weights, deduction caps, Chrome User-Agent, and 22 output contract fields.
schema.ts: Input parameters definition conforming to PluginSchema.

Zero Runtime Dependencies: Uses native Node.js APIs (fetch, zlib, URL, crypto) and host Cheerio with needOwnDependencies: false.

How does this automation workflow operate?

This workflow executes natively within your local or peer BrowserMesh node using real Chromium browser automation. It navigates dynamically rendered single-page applications, executes interaction logic, avoids cloud proxy fees, and extracts clean structured datasets directly to your local machine with complete security and privacy.

Why run this workflow with BrowserMesh instead of traditional cloud scrapers?

Unlike legacy cloud scraping APIs that impose expensive per-request markups and risk IP bans, BrowserMesh routes execution through authentic residential environments. You pay zero cloud data transfer fees, experience full anti-bot stealth emulation, and retain 100% ownership of your extracted datasets without vendor lock-in.

Install & Info

Current Versionv1.0.0

AuthorBrowserMesh

Released18 days ago

Total Installs1

Total Views64

Jobs Executed8

Compatibility

Windows

Web

Linux

Android

Resources & Links

BrowserMesh Docs

Sample Output

Live Execution Preview

2 records · 22 nested fields · real execution preview

url

domain

statusCode

status

hasCanonical

canonicalUrl

isSelfReferencing

htmlCanonical

headerCanonical

multipleCanonicalsFound

allCanonicalTags

canonicalSource

ogUrl

isOgUrlAligned

targetStatusCode

targetFinalUrl

targetIsRedirect

targetIsNoindex

hasCanonicalConflict

audit

summary

error

www.browsermesh.in/

browsermesh.in

200

healthy

true

www.browsermesh.in/

true

www.browsermesh.in/

—

false

#1	https://www.browsermesh.in/

html

www.browsermesh.in/

true

200

—

false

score	100
grade	Excellent
issues	[]
notices	[{"type":"self_referencing_canonical","severity":"info","message":"Valid self-referencing canonical tag detected.","recommendation":"Maintain self-referencing canonicals to preserve indexation signals."}]
metrics	{"criticalIssuesCount":0,"warningIssuesCount":0,"infoIssuesCount":1}

Healthy (Score: 100/100, Excellent). Valid self-referencing canonical tag verified with 0 conflicts.

—

www.browsermesh.in/?utm_source=twitter&campaign=spring

browsermesh.in

200

healthy

true

www.browsermesh.in/

false

www.browsermesh.in/

—

false

#1	https://www.browsermesh.in/

html

www.browsermesh.in/

true

200

—

false

score	100
grade	Excellent
issues	[{"type":"canonicalized_clean_url","severity":"info","message":"Tracking or parameter query consolidated to clean canonical URL.","recommendation":"Valid SEO canonicalization consolidating query parameter crawl equity."}]
metrics	{"criticalIssuesCount":0,"warningIssuesCount":0,"infoIssuesCount":1}

Healthy (Score: 100/100, Excellent). Tracking or parameter query consolidated to clean canonical URL.

—

2 records

22 fields (nested)

Sample preview

Input Parameters

Parameter	Type	Required	Description
keyword	string	Yes	Search term or product keyword
marketplace	string	Yes	Amazon marketplace domain (e.g., amazon.com)
maxPages	number	No	Max pages to process (default: 1)
sortBy	select	No	Sort by: price_asc, price_desc, rating
minRating	number	No	Minimum product rating (1-5)

Cross-Verification Ecosystem

Recommended Automation & SEO Tools

Combine complementary browser automation and auditing workflows to verify site health, infrastructure, and search engine crawlability with 100% local execution.

Free Utility

Broken Link Checker & 404 Analyzer

Scan websites and XML sitemaps to detect 404 dead links, broken anchors, and redirect loops with zero cloud markups.

Audit with this tool

Infrastructure

Website Hosting & CDN Detector

Discover who hosts any website. Detect cloud infrastructure, CDN edge networks, IP geo, and DNS routing instantly.

Audit with this tool

SEO Tool

Technical SEO & Visual Site Auditor

Audit on-page SEO factors, meta tags, heading structures, Core Web Vitals, and SERP snippet previews with local privacy.

Audit with this tool

Support & Resources

Need help getting started?

Explore our comprehensive guides or reach out directly to our engineering support team.

DocumentationGuides & API reference

Contact Support24/7 Engineer help

Core Capabilities

Dual-Layer Canonical Auditing

Simultaneously inspects HTML document <head> declarations and RFC 8288 HTTP Link response headers to prevent conflicting signals and search indexation drops.

2026 JS Hydration & DOM Linter

Compares static server HTML against client-rendered DOM states to detect hydration mismatches and flags invalid elements prematurely closing <head>.

XML Sitemap Auto-Ingestion

Ingests direct XML sitemaps (.xml, .xml.gz, /sitemap), uncompresses gzip archives, expands recursive sitemap indexes, and audits child URLs up to user limits.

Active Target Reachability Prober

Actively verifies canonical targets for HTTP 404/5xx dead ends, traces 301/302 redirect chains up to 5 hops, detects circular loops, and catches noindex traps.

Calibrated 0–100 Health Scoring

Applies severity-weighted deductions across 14 failure modes with critical safety caps (max -60) and strict score ceilings (max 70 for errors, max 89 for warnings).

Triple-Engine Auto-Escalation

Executes ultra-fast HTTP audits (~300ms) with automatic stealth Playwright browser escalation for Cloudflare challenges, SPAs, and anti-bot protected sites.

{ "urls": "https://www.browsermesh.in/, https://startten.com/, https://befhue.com/", "limit": -1, "timeout": 30, "scrapeMode": "auto", "concurrency": 8, "checkSocialTags": true, "maxSitemapPages": 50, "probeCanonicalTarget": true }

{ "urls": "https://www.saravanabhavan.com/sitemap.xml, https://mistral.ai/sitemap.xml", "limit": -1, "timeout": 30, "scrapeMode": "auto", "concurrency": 8, "checkSocialTags": true, "maxSitemapPages": 50, "probeCanonicalTarget": true }

{ "urls": "https://example.com/page-1, https://example.com/page-2, https://example.com/page-3", "limit": -1, "timeout": 20, "scrapeMode": "http", "concurrency": 15, "checkSocialTags": false, "maxSitemapPages": 20, "probeCanonicalTarget": true }

README

Canonical Conflict & SEO URL Detector

An enterprise-grade, high-performance Canonical Conflict, Dual-Layer Link Header & HTML Tag Validator, and Technical SEO URL Auditor for BrowserMesh.

The definitive modern alternative to Screaming Frog SEO Spider (£209/yr), Sitebulb, Ahrefs Site Audit, and brittle custom Python scrapers.

🎯 Target Audience & Industry Solutions

Technical SEO Directors & Webmasters: Protect revenue-critical landing pages from accidental de-indexing, ranking dilution, and Google Search Console "Duplicate, Google chose different canonical than user" overrides.
E-Commerce & Marketplace Engineers (Shopify, Magento, WooCommerce): Detect canonical traps caused by faceted navigation, sorting queries (?sort=price_asc), tracking parameters (?fbclid=..., ?utm_source=...), and pagination series (?page=2).
Full-Stack & Headless CMS Developers (Next.js, Nuxt, Remix, React 19): Audit server-rendered HTML canonicals against client-hydrated DOM states to prevent Hydration Canonical Mismatches penalized under Google's 2026 JavaScript SEO guidelines.
DevOps & Cloudflare Edge Engineers: Eliminate severe canonical conflicts where Edge CDN workers inject HTTP Link headers that contradict CMS-generated HTML canonical tags.
Enterprise Auditing & Digital Agencies: Audit entire domains via XML Sitemap auto-ingestion with bounded concurrency and real-time streaming output.

🚀 Key Features

1. Dual-Layer Canonical Declaration Auditing

Inspects canonical configurations across both network layers:

HTML Document Head (<link rel="canonical" href="...">): Parses <head> declarations, resolves relative paths, checks for multiple tags, and detects placement in <body>.
HTTP Response Headers (RFC 8288 / RFC 5988 Link: <...>; rel="canonical"): Parses edge CDN and API gateway link headers, extracting destinations even for non-HTML assets (PDFs, downloadable whitepapers).
Conflict Resolution: Immediately flags critical contradictions if the HTML tag and HTTP header specify different canonical targets (which causes search engines to ignore all canonicals).

2. 2026 JavaScript Hydration & DOM Linter

Hydration Invariance: Detects when raw static server HTML canonicals differ from client-rendered DOM canonicals.
Premature <head> Closure Detection: Flags when non-metadata elements (<img>, <iframe>, misplaced <div>) before <link rel="canonical"> force the browser or Googlebot parser to close <head> early and relegate canonical tags into <body>.

3. XML Sitemap Auto-Ingestion & Verification

Dual Input Modes: Accepts individual webpage URLs, multi-line URL batches, or direct XML Sitemap URLs (.xml, .xml.gz, /sitemap).
Recursive Sitemap Expansion: Automatically uncompresses gzip payloads, unpacks <sitemapindex> hierarchies, and audits child URLs up to the user-specified page limit.
Sitemap Self-Canonical Verification: Ensures all sitemap URLs are properly self-referencing.

4. Active Target Reachability Prober

Dead Canonical Trap Detection: Performs lightweight HTTP verification to ensure canonical destinations return HTTP 200 OK, not 404 Not Found, 410 Gone, or 500 Server Error.
Redirect Chain & Loop Detection: Traces redirect hops (301, 302, 307, 308) up to 5 levels, capturing the final destination URL and detecting circular loops (Page A <-> Page B).
Contradictory noindex Traps: Detects if the canonical destination contains a <meta name="robots" content="noindex"> tag or X-Robots-Tag: noindex header.

5. Social & Structured URL Cross-Check

Cross-references canonical URLs against OpenGraph meta[property="og:url"] and Twitter Card meta[name="twitter:url"].
Prevents fragmented social engagement and incorrect social link sharing previews.

6. Calibrated 0–100 Health Scoring Engine

Evaluates pages across 14 failure modes with severity-weighted deductions.
Enforces critical safety caps (max 60 deduction) and warning safety caps (max 30 deduction).
Ceilings ensure pages with active critical errors cannot receive scores above 70 (capped at 'Needs Improvement'), and pages with warning issues cannot receive scores above 89 (capped at 'Good', strictly reserving 'Excellent' for 100% clean setups).

📋 22-Field Output Contract

Every yielded record strictly adheres to these 22 structured fields:

Field Name	Type	Description
`url`	`string`	The webpage URL tested.
`domain`	`string`	Clean root domain (e.g. `browsermesh.in`).
`statusCode`	`number`	HTTP status code of the page (200, 301, 404, etc.).
`status`	`string`	Overall health: `'healthy'`, `'has_warnings'`, `'has_errors'`, `'error'`.
`hasCanonical`	`boolean`	`true` if at least one canonical tag or header was detected.
`canonicalUrl`	`string \| null`	Winning primary resolved canonical URL.
`isSelfReferencing`	`boolean`	`true` if the canonical URL matches the page URL.
`htmlCanonical`	`string \| null`	Raw canonical URL from HTML `<link rel="canonical">`.
`headerCanonical`	`string \| null`	Raw canonical URL from HTTP `Link: rel="canonical"` header.
`multipleCanonicalsFound`	`boolean`	`true` if multiple `<link>` tags exist or HTML disagrees with header.
`allCanonicalTags`	`string[]`	Array of all declared canonical URL strings found on the page.
`canonicalSource`	`string`	Where canonical was declared: `'html'`, `'header'`, `'both'`, `'none'`.
`ogUrl`	`string \| null`	OpenGraph `og:url` value (or `null`).
`isOgUrlAligned`	`boolean \| null`	`true` if `og:url` matches canonical URL (`null` if no `og:url`).
`targetStatusCode`	`number`	HTTP status of canonical destination (200, 301, 404; 0 if skipped).
`targetFinalUrl`	`string \| null`	Final destination URL if canonical target redirects (or `null`).
`targetIsRedirect`	`boolean`	`true` if canonical target redirects (301, 302, 307, 308).
`targetIsNoindex`	`boolean`	`true` if canonical target has `noindex` header or meta tag.
`hasCanonicalConflict`	`boolean`	`true` if any critical conflict or warning was triggered.
`audit`	`object`	Objective 0–100 Health Score, grade, issues list, and metric counts.
`summary`	`string`	Human-readable audit summary string for the page or site-level summary record.
`error`	`string \| null`	Clean human-readable error message on failure, or `null` on success.

⚙️ Configuration Parameters (`schema.ts`)

Parameter	Type	Default	Description
`urls`	`string`	(Required)	Webpage URLs, domains, or direct XML Sitemap URLs (e.g. `https://example.com/sitemap.xml`).
`scrapeMode`	`select`	`'auto'`	Execution engine: `'auto'` (Fast HTTP with stealth browser fallback & JS check), `'http'`, or `'browser'`.
`probeCanonicalTarget`	`boolean`	`true`	Actively probes canonical target to verify 200 OK status, redirect hops, loops, and noindex traps.
`checkSocialTags`	`boolean`	`true`	Cross-checks search canonical against OpenGraph `og:url` and Twitter URL.
`maxSitemapPages`	`number`	`50`	Maximum child URLs to extract and audit if an XML sitemap URL is supplied (-1 for unlimited, default 50).
`concurrency`	`number`	`8`	Number of URLs to audit in parallel (1–20).
`timeout`	`number`	`30`	Maximum network timeout in seconds per URL probe (5–60).
`limit`	`number`	`-1`	Maximum total records to output (-1 for all).

🏆 Scoring & Diagnostic Issue Taxonomy

Issue Code	Severity	Deduction	Description
`canonical_target_404`	Critical	-20 pts	Canonical destination returns HTTP 404/410 broken status.
`canonical_target_5xx`	Critical	-20 pts	Canonical destination returns HTTP 500/502/503 server error.
`canonical_target_noindex`	Critical	-20 pts	Canonical destination contains a `noindex` meta tag or header.
`multiple_conflicting_canonicals`	Critical	-20 pts	Multiple conflicting canonical tags or HTML head disagrees with HTTP header.
`canonical_loop`	Critical	-20 pts	Circular canonical loop (Page A $\leftrightarrow$ Page B).
`hydration_canonical_mismatch`	Critical	-15 pts	Static server HTML canonical differs from client JS hydrated canonical.
`canonical_in_body_or_premature_head`	Critical	-15 pts	Canonical tag inside `<body>` or pushed out of `<head>` by invalid elements.
`canonical_target_disallowed`	Critical	-15 pts	Canonical destination is blocked by `robots.txt` disallow rules.
`canonical_target_redirect`	Warning	-10 pts	Canonical destination returns HTTP 301/302 redirect hop.
`protocol_downgrade_http`	Warning	-10 pts	Secure HTTPS page canonicalizes to insecure HTTP URL.
`cross_subdomain_mismatch`	Warning	-10 pts	Canonical points across different subdomains or staging environments.
`canonical_chain`	Warning	-10 pts	Multi-hop canonical chain (Page A $\to$ Page B $\to$ Page C).
`paginated_canonical_to_root`	Warning	-10 pts	Paginated page (`?page=2`) canonicalizes to root page 1.
`missing_canonical`	Warning	-5 pts	Webpage declares no canonical tag or HTTP Link header.
`relative_canonical_url`	Warning	-5 pts	Canonical href is relative instead of absolute.
`canonical_has_fragment`	Warning	-5 pts	Canonical URL includes an anchor fragment (`#...`).
`trailing_slash_mismatch`	Warning	-5 pts	Inconsistent trailing slash between page and canonical target.
`sitemap_not_found_fallback`	Warning	-10 pts	XML sitemap not found; auto-fell back to root website & internal routes.
`site_canonical_warnings_detected`	Warning	0 pts	Site audit detected warning-level issues across one or more pages.
`site_canonical_errors_detected`	Critical	0 pts	Site audit detected critical canonical conflicts across pages.
`og_url_mismatch`	Info	0 pts	OpenGraph `og:url` differs from canonical URL.
`self_referencing_canonical`	Info	0 pts	Valid self-referencing canonical tag verified.
`canonicalized_clean_url`	Info	0 pts	Parameter or tracking query consolidated to clean canonical master URL.
`site_audit_summary`	Info	0 pts	Site-wide audit roll-up summary completed.

🛠️ Architecture

Built on BrowserMesh's modular split-file TypeScript ESM architecture:

index.ts: Plugin entry point, metadata declaration, and lifecycle hooks.
scraper.ts: AsyncGenerator streaming runner, sitemap expansion, multi-engine executor, and active target prober.
parser.ts: RFC 8288 link header parser, Cheerio HTML DOM extractor, premature head closure linter, and 0–100 scoring engine.
config.ts: Scoring weights, deduction caps, Chrome User-Agent, and 22 output contract fields.
schema.ts: Input parameters definition conforming to PluginSchema.

Zero Runtime Dependencies: Uses native Node.js APIs (fetch, zlib, URL, crypto) and host Cheerio with needOwnDependencies: false.

Parameter

Type

Required

Description

keyword

string

Yes

Search term or product keyword

marketplace

string

Yes

Amazon marketplace domain (e.g., amazon.com)

maxPages

number

Max pages to process (default: 1)

sortBy

select

Sort by: price_asc, price_desc, rating

minRating

number

Minimum product rating (1-5)

Canonical Conflict & SEO URL Detector

About Canonical Conflict & SEO URL Detector

Core Capabilities

Dual-Layer Canonical Auditing

2026 JS Hydration & DOM Linter

XML Sitemap Auto-Ingestion

Active Target Reachability Prober

Calibrated 0–100 Health Scoring

Triple-Engine Auto-Escalation

Usage Examples

Single URL & Landing Page Audit

Deep XML Sitemap Domain Sweep

High-Speed Technical SEO Batch

README

🎯 Target Audience & Industry Solutions

🚀 Key Features

1. Dual-Layer Canonical Declaration Auditing

2. 2026 JavaScript Hydration & DOM Linter

3. XML Sitemap Auto-Ingestion & Verification

4. Active Target Reachability Prober

5. Social & Structured URL Cross-Check

6. Calibrated 0–100 Health Scoring Engine

📋 22-Field Output Contract

⚙️ Configuration Parameters (schema.ts)

🏆 Scoring & Diagnostic Issue Taxonomy

🛠️ Architecture

How does this automation workflow operate?

Why run this workflow with BrowserMesh instead of traditional cloud scrapers?

Install & Info

Compatibility

Resources & Links

Live Execution Preview

Input Parameters

Recommended Automation & SEO Tools

Broken Link Checker & 404 Analyzer

Website Hosting & CDN Detector

Technical SEO & Visual Site Auditor

Need help getting started?

Canonical Conflict & SEO URL Detector

About Canonical Conflict & SEO URL Detector

Core Capabilities

Dual-Layer Canonical Auditing

2026 JS Hydration & DOM Linter

XML Sitemap Auto-Ingestion

Active Target Reachability Prober

Calibrated 0–100 Health Scoring

Triple-Engine Auto-Escalation

Usage Examples

Single URL & Landing Page Audit

Deep XML Sitemap Domain Sweep

High-Speed Technical SEO Batch

README

🎯 Target Audience & Industry Solutions

🚀 Key Features

1. Dual-Layer Canonical Declaration Auditing

2. 2026 JavaScript Hydration & DOM Linter

3. XML Sitemap Auto-Ingestion & Verification

4. Active Target Reachability Prober

5. Social & Structured URL Cross-Check

6. Calibrated 0–100 Health Scoring Engine

📋 22-Field Output Contract

⚙️ Configuration Parameters (schema.ts)

🏆 Scoring & Diagnostic Issue Taxonomy

🛠️ Architecture

How does this automation workflow operate?

Why run this workflow with BrowserMesh instead of traditional cloud scrapers?

Install & Info

Compatibility

Resources & Links

Live Execution Preview

Input Parameters

Recommended Automation & SEO Tools

Broken Link Checker & 404 Analyzer

Website Hosting & CDN Detector

Technical SEO & Visual Site Auditor

Need help getting started?

⚙️ Configuration Parameters (`schema.ts`)

⚙️ Configuration Parameters (`schema.ts`)