seo-crawl-audit 0.9.0 → 0.10.1

package/README.md

@@ -16,6 +16,13 @@ The report is a self-contained HTML file: open it locally, share it as an
 artifact, or publish the same file on GitHub Pages. Charts and filters work
 without a server.
 
+### Local web UI
+
+![SEO Crawl Audit local scan interface](https://raw.githubusercontent.com/MelnixDev/seo-crawl-audit/main/docs/images/report-local-ui.png)
+
+Run `seo-audit serve` to start scans from a loopback-only browser interface,
+follow progress, and open the generated local report.
+
 ### Overview and local history
 
 ![SEO Crawl Audit summary cards and local scan history](https://raw.githubusercontent.com/MelnixDev/seo-crawl-audit/main/docs/images/report-overview.png)
@@ -23,6 +30,13 @@ without a server.
 The overview keeps scan coverage, issue counts, and locally stored trends in
 one place.
 
+### Site metrics
+
+![SEO Crawl Audit site metrics and crawl coverage](https://raw.githubusercontent.com/MelnixDev/seo-crawl-audit/main/docs/images/report-metrics.png)
+
+Site metrics separate measured crawl data from external provider values, with
+the source and connection state shown for every indicator.
+
 ### Interactive issue analytics
 
 ![SEO Crawl Audit interactive issue statistics](https://raw.githubusercontent.com/MelnixDev/seo-crawl-audit/main/docs/images/report-analytics.png)
@@ -53,6 +67,9 @@ attention, with evidence and remediation kept alongside each issue.
   and local report branding;
 - interactive issue statistics for severity, frequent checks, ownership, and
   regression lifecycle, with chart-to-table filtering;
+- a dedicated Site Metrics view with crawl-derived measurements, a clearly
+  labelled Google `site:` estimate, and optional public RDAP domain data;
+- a loopback-only browser interface for starting and stopping local scans;
 - safe environment-based authentication for private `doctor`, `scan`,
   `check`, Action, and production-versus-preview workflows;
 - configuration, suppressions with expiry, severity overrides, and budgets;
@@ -127,6 +144,24 @@ seo-audit doctor --offline
 
 [Read the project diagnostics guide](https://github.com/MelnixDev/seo-crawl-audit/blob/main/docs/doctor.md).
 
+Start the local browser interface:
+
+```bash
+seo-audit serve
+seo-audit serve https://example.com/
+seo-audit serve --port 4180
+seo-audit serve --no-open
+```
+
+Pass a URL to prefill the scan target and avoid accidentally reusing a value
+restored by the browser. The command opens the interface in the default browser. Use `--no-open` in CI,
+remote shells, or when you prefer to open the printed URL manually. It binds
+only to `127.0.0.1`, runs the same core crawler, and keeps snapshots,
+checkpoints, and reports in the current directory. Best-effort Google `site:`
+and public RDAP data use an explicit checkbox in the interface; every estimate
+is labelled and kept separate from authoritative Search Console data.
+[Read the Site Metrics guide](https://github.com/MelnixDev/seo-crawl-audit/blob/main/docs/site-metrics.md).
+
 For project-scoped Codex, Claude Code, or OpenCode integration, run:
 
 ```bash
@@ -161,6 +196,16 @@ seo-audit check https://quotes.toscrape.com/ \
   --report quotes-changes.html
 ```
 
+For a JavaScript-rendered site, install the optional adapter and Chromium:
+
+```bash
+npm install --save-dev playwright
+npx playwright install chromium
+seo-audit scan https://example.com/ --render playwright
+```
+
+HTTP remains the default. A Playwright scan never silently falls back to HTTP.
+
 ## Commands
 
 ### `seo-audit init [url]`
@@ -567,7 +612,7 @@ Use `--delay 0` only for local or explicitly controlled fixtures.
 
 ## Current scope
 
-- server-rendered HTML; JavaScript rendering is not included;
+- fast HTTP crawling by default, with separate opt-in Playwright rendering;
 - same-origin crawl discovery;
 - sitemap and internal-link seeding;
 - non-HTML responses are recorded but not parsed for page metadata;