Website Audit Agent — Automated Health Scoring
Overview
The Website Audit Agent is an internal AI-powered tool that performs comprehensive, automated health checks across all managed client websites. Invoked from a terminal using a simple natural-language command, the agent runs a full diagnostic sweep, executes routine cleanup tasks, and generates a structured health report — without requiring manual login to any platform.
The agent was built and demoed internally in January 2026. It is designed to run on a recurring schedule (e.g., every Sunday night) across all client sites, ensuring issues are caught and resolved proactively rather than reactively.
Origin: Discussed and demoed during the [1]. Mark built and ran the agent live, showing results for Flint Audio and Crazy Lenny's.
How It Works
Invocation
The agent is triggered from a terminal with a plain-language command:
run the full audit on [client-site]
The agent then:
1. Looks up stored credentials for the target site
2. Generates a checklist of audit tasks
3. Executes each task sequentially in the background
4. Produces a structured report and saves it to a designated folder
The operator does not need to monitor the process — it runs autonomously and can handle multiple sites in sequence.
Audit Scope
The agent covers the following areas:
| Category | What It Checks |
|---|---|
| Site Profile | Client name, site type, purpose, target audience (auto-inferred) |
| Database Health | Size, auto-load data, fragmentation, orphaned metadata, plugin log bloat |
| Performance | Page speed scores, caching configuration (WP Rocket), CDN (Cloudflare) |
| WordPress Config | WP Engine settings, plugin health, security plugin conflicts |
| SEO | SEO plugin configuration, 404 errors, top pages, keyword signals |
| Google Analytics 4 | Tracking verification, session counts, traffic by device and source |
| Google Tag Manager | Tag inventory, trigger status, event firing validation |
| Gravity Forms | Form submission counts, 30-day activity |
| Google Search Console | Top pages, crawl signals |
| Conversion Events | Validates that form submits, clicks, and custom events are flowing correctly |
Cleanup Actions
In addition to reporting, the agent performs active remediation during the audit:
- Deletes orphaned metadata and plugin log entries (e.g., SEO Press 404 logs)
- Clears database fragmentation
- Applies caching and performance optimizations where configured
Output
The agent produces a structured markdown/text health report including:
- Site profile summary
- Database size and cleanup log
- Health score with flagged issues
- GA4 traffic summary
- GTM tag and trigger inventory
- Gravity Forms activity
- SEO recommendations
Reports are saved to a local folder and can be reviewed asynchronously.
Real-World Results
During the January 2026 demo, the agent was used to diagnose and fix Crazy Lenny's website after a persistent performance issue:
- Before: PageSpeed performance score of 51
- After: Score improved to 90 following agent-guided fixes
- Accessibility improved from 80 → 86
- All identified 404 errors were resolved
The agent also audited Flint Audio, identifying and cleaning over 1,000 orphaned SEO Press log entries and misconfigured database entries.
Scheduling & Automation
The agent is designed to run on a cron-style schedule. Recommended cadence:
- Full audit sweep: Every Sunday night across all client sites
- Ad hoc audits: On demand via terminal command after deployments or reported issues
Because the agent uses stored API credentials, it accesses platforms (WP Engine, GA4, GTM, Search Console, Cloudflare) through the back door — no manual login required.
Strategic Value
This tool represents a meaningful operational advantage:
- Proactive maintenance: Issues are caught weekly before clients notice them
- Consistent QA: Every site gets the same thorough check regardless of who manages it
- Time leverage: The agent runs in the background while the operator works on other tasks
- Audit trail: Reports create a running record of site health over time
- Upsell signal: Health reports can surface billable fix opportunities or justify retainer value
The same agentic framework used here is being extended to other internal workflows. See also: [2] and [3].
Related Tools & Integrations
- X-Ray — SEO opportunity analysis tool used alongside the audit agent
- WP Rocket — Caching layer audited and configured by the agent
- WP Engine — Hosting platform; agent checks server-level configuration
- Cloudflare — CDN configuration reviewed in audit
- GA4 / GTM / Search Console — All queried via API during audit
- Gravity Forms — Form submission health included in report
Notes & Limitations
- Reports are currently internal-only and not formatted for client delivery
- Icon rendering in AI-built React UIs can drift from brand guidelines if a style module isn't explicitly provided upfront
- The agent requires pre-configured credential storage for each site; new sites must be onboarded before they can be audited
- Front-end visual issues identified in reports should be routed to the dev team; the agent handles backend and configuration concerns