v1.1.3 — field-tested on 30 sites

Fixes from field tests on about 30 real sites.

• Advice follows the cache that answered: Cloudflare, WP Super Cache, W3 Total Cache, LiteSpeed or Kinsta
• Consent managers (iubenda, Cookiebot, OneTrust…) are never counted as render-blocking or suggested for defer: they must load first for GDPR compliance
• Bot challenges (AWS WAF, Cloudflare) and non-HTML addresses (PDF, images) stop the audit with a clear message
• Search and filter pages missing the cache are reported as expected
• Clear errors for timeouts, unknown domains, refused connections, redirect loops
• 32 tests

v1.1.0 — works on any site

• Works on any site; on WordPress it does more (plugin files, cache plugins, WordPress-specific fixes)
• Recognises Fastly, CloudFront, Akamai, Vercel, Netlify (Cache-Status), Varnish, Sucuri, Drupal and managed WordPress hosts (WordPress VIP, Kinsta, WP Engine, Hostinger)
• Stops with a clear message when a site blocks automated requests
• Field-tested on 12 well-known sites: 6 fixes for edge cases found there

v1.0.0 — test the cache the way real visitors reach it

• Recognises the site's cookie banner (iubenda, Cookiebot, Complianz, CookieYes, OneTrust, Borlabs, CookieLawInfo, Cookie Notice) and sends the cookie a visitor has after accepting it
• Cache on phones, including Vary: User-Agent fragmentation
• Checks a few pages from the sitemap too (--pages=N)
• Missing pages: soft 404s and 404s cached for hours
• Cloudflare DYNAMIC is no longer read as a cache miss
• All checks available to AI agents through the MCP server

v0.2.0 — HTML report

• New --html option: saves a self-contained HTML report (no external files, light and dark mode, failures first) to send to a client or attach to a ticket
• --html=report.html picks the file name
• Page content is always escaped in the report
• "1 warning" instead of "1 warnings"

v0.1.0 — first release

First public release.

• 8 outside-in checks: server response, page cache (also for visitors with cookies and UTM parameters), compression, viewport position, main image priority, render-blocking files, reCAPTCHA, plugin files
• Detects Cloudflare, LiteSpeed, nginx/FastCGI, Automattic, WP Super Cache, W3 Total Cache and WP Rocket caches
• --json output and exit codes for CI
• Zero dependencies, Node.js 20+

Try it: npx github:andrea-sofia-dev/wp-doctor your-site.com