uTPro.Feature.SEOAudit 2.1.0

uTPro SEO Audit for Umbraco

Documentation: https://docs.utpro.dev/uTPro.Feature.SEOAudit/

Site-wide SEO & content audit for Umbraco 16, 17 and 18. Crawls every Content and Media URL, checks for broken links/images/resources, and audits each page — producing a composite SEO score, a health score, prioritised issues, per-page details and CSV export, all in a dedicated backoffice section.

What it adds

Installing this package extends the SEO Audit section (created by uTPro.Feature.UrlViewer or by this package when installed standalone) with:

Architecture

T4VN.Seo.Core  (engine, no Umbraco)
      ▲                  ▲
      │                  │
uTPro.Feature.UrlViewer  uTPro.Feature.SEOAudit
(URL Viewer tab +        (this package — site crawler
 shared UI + section)     + node audit tab)

Both packages share the same T4VN.Seo.Core engine and SeoScorer — the single source of truth for the SEO score. Install order and combination are flexible; each package works independently.

Site Audit

A recurring background job (auto-discovered by uTPro Job Monitor) crawls every Content and Media URL and, optionally, URLs in sitemap.xml.

• Broken links, images & resources — <a>, <img>, stylesheets, scripts, fonts checked for a valid status code.
• Health score per run + Overview of totals (pages, links, images, resources, broken, orphaned, duplicate).
• Composite SEO score per page and Avg SEO Score across the run.
• AI-readiness sub-score per page (robots.txt AI-bot rules, llms.txt, JSON-LD quality, authorship dates, FAQ/breadcrumb schema, external citations) with an Avg AI Readiness card on the run overview, its own column in the pages grid and the CSV export.
• Issues grouped by category with severity, type and priority.
• Orphaned pages (no internal link) and duplicate content (identical HTML hash) detection.
• Incremental scans — unchanged pages (ETag / Last-Modified) are skipped; previous result is carried forward.
• Respects robots.txt (disallow rules + Sitemap: discovery); supports include/exclude URL patterns.
• Core Web Vitals (optional) via the Google PageSpeed Insights API — no local browser needed.
• CSV export of any run.
• Extensible checks — implement IUrlScanIssue and register in DI; it appears automatically in the Issues view.

Per-page audit (via modal detail)

• SEO — title (+ length), meta description (+ length), canonical, H1/H2/H3, noindex, nofollow, lang.
• Social — Open Graph, Twitter Card, pixel detection, social-profile links.
• Technical SEO — charset, gzip/br, browser caching, HTTPS, schema.org, viewport, favicon.
• Content — word/paragraph count, Flesch readability, keyword density, thin-content flag.
• Accessibility — aria counts, skip-to-content, heading structure, lang, inputs without label.
• Carbon — CO₂e estimate with A–F rating.
• Core Web Vitals (optional) — Lighthouse score, LCP, CLS, FCP, TBT, Speed Index + real-user field data.

Built-in issue checks

HTTP errors, server errors, broken links, broken resources, missing/too-long meta description, missing H1, missing H2, nofollow, noindex, canonicalised URLs, orphaned pages, thin content, duplicate content, images missing alt text, high carbon intensity, spam/hack keywords, cloaking, JavaScript errors, poor Core Web Vitals.

Per-node SEO Audit tab

Adds a SEO Audit tab inside every Content and Media editor. Shown only for users with Settings access, and only when the node has a public routable URL (template-less nodes are automatically excluded). Opening a node auto-audits its URL(s) in the background and shows a footer warning when an issue is found.

Security

Backoffice-secured under /umbraco/management/api/v1/utpro/url-scan, requires Settings-section access. Crawl fetches run behind the same SSRF guard as the URL Viewer (RFC-1918 / localhost / .local blocked, re-checked on every redirect hop). SkipNodesWithoutTemplate = true (default) prevents template-less nodes (folders, navigation-link containers, etc.) from being scanned — they have no routable URL and would produce only false-positive 404s.

Installation

dotnet add package uTPro.Feature.SEOAudit

Tip: install uTPro.Feature.UrlViewer as well to get the manual URL Viewer fetch tool in the same section.

Configuration

Bind under uTPro:Feature:SEOAudit in appsettings.json (all keys optional — defaults shown):

{
  "uTPro": {
    "Feature": {
      "SEOAudit": {
        "Enabled": true,
        "Period": "24:00:00",
        "Delay": "00:05:00",
        "MaxConcurrency": 4,
        "ThrottleDelayMs": 150,
        "SkipCloakingCheck": true,
        "AllowInternalHosts": false,
        "AllowInvalidCertificates": false,
        "RedirectWarningThreshold": 3,
        "MaxRunHistory": 20,
        "SkipNodesWithoutTemplate": true,
        "CheckLinks": true,
        "CheckExternalLinks": true,
        "CheckImages": true,
        "LinkCheckTimeoutSeconds": 15,
        "MaxLinkChecksPerRun": 5000,
        "UseIncrementalScan": true,
        "UseSitemapDiscovery": true,
        "RespectRobotsTxt": true,
        "ExcludePatterns": [],
        "IncludePatterns": [],
        "CollectCoreWebVitals": false,
        "PageSpeedApiKey": "",
        "PageSpeedStrategy": "mobile"
      }
    }
  }
}

Extensibility

Register a custom issue check in DI:

services.AddScoped<IUrlScanIssue, MyCustomIssue>();

IUrlScanIssue exposes Alias, Name, Description, Category, Severity, Type, Priority and bool Matches(ScanResultRow row). It appears automatically in the Issues view.

License

Free to use (including commercially) under a proprietary End User License Agreement.