Site Auditor
📋 Site Auditor ⭐ Premium
> Comprehensive audit of your website's commercial performance across 8 dimensions: UX, accessibility, GDPR, web standards, SEO, AI visibility, content quality, and commercial viability. Scores 0–100 and identifies your top 3 roadblocks.
| Field | Value |
|---|---|
| Slug | site-auditor |
| Version | 1.0.0 |
| Category | Audit |
| Author | Agentic Community |
| License | Premium — requires an active Agent Builder license |
Premium Agent
Site Auditor is the premium agent in the Agent Builder ecosystem. It is the only agent that can score and evaluate all 20 SEO & AI metrics in a single master audit. While the 6 free agents each own one metric, Site Auditor has visibility across all 20 and produces a composite score with per-metric breakdowns and prioritised fix lists. Requires an active Agent Builder license to run.
Tools
| Tool | Description |
|---|---|
run_full_audit | Run the complete 8-dimension site audit. Returns scores for all dimensions, the overall score (0–100), a letter grade, individual check results with pass/fail/warning status, and the top 3 prioritised roadblocks. Takes 30–90 seconds for larger sites. |
audit_dimension | Run the audit for a single dimension only. Useful for re-checking a specific area after making fixes without running the full scan. |
get_audit_history | Retrieve stored audit history (up to 12 past reports). Returns date, overall score, grade, and per-dimension scores for each entry. Used to show score trends over time. |
save_audit_result | Save an audit result to the history store. Pass the full audit result object returned by run_full_audit. Keeps the last 12 results and rotates older ones out. |
get_site_overview | Get high-level site metadata: WordPress version, active theme, active plugins list, permalink structure, homepage URL, site title, tagline, total published post count, total page count, and whether search is discouraged. |
get_content_stats | Analyse all published posts and pages: total count, average word count, count of thin posts (under 300 words), freshness breakdown (posts by age: 0-3 months, 3-6 months, 6-12 months, 12+ months), most recent publish date, publishing cadence (average days between posts over the last 6 months), posts without featured images, posts without categories or tags. |
get_seo_stats | Scan all published posts and pages for SEO issues. Returns: count of pages missing title tags, count missing meta descriptions, count with duplicate titles, count with duplicate meta descriptions, count with no H1, count with multiple H1s, count with no internal links (orphaned), count of images missing alt text (site-wide total), and a list of pages with noindex set. |
get_accessibility_stats | Analyse accessibility issues across all published pages: total images missing alt text, count of alt attributes that are empty vs missing, heading hierarchy violations (pages with no H1, pages with multiple H1s, pages where H3 appears without H2), count of pages with generic link text ("click here", "read more", "here"), form elements without labels (based on post content scan). |
get_privacy_compliance_status | Check GDPR/privacy compliance signals: whether a privacy policy page exists and is linked, whether a terms of service page exists, whether the site is served over HTTPS, which known third-party script domains are detected in theme/plugin assets (Google Analytics, Facebook Pixel, Hotjar, Google Tag Manager, etc.), whether a cookie consent plugin is active, and whether consent-related text patterns appear in the privacy policy content. |
get_web_standards_status | Check web standards compliance: robots.txt presence and content, sitemap.xml presence and post coverage percentage, favicon presence, Open Graph meta tag coverage across pages, canonical tag coverage, mobile viewport meta tag on all pages, whether images use srcset for responsive sizing, and mixed-content (HTTP resources on HTTPS pages) indicators. |
get_ai_visibility_status | Check AI search visibility: which AI bots (GPTBot, ClaudeBot, ChatGPT-User, Google-Extended, PerplexityBot) are allowed or blocked in robots.txt, whether an llms.txt file exists, schema markup types present site-wide (Organization, Article, FAQPage, BreadcrumbList), FAQ-formatted content patterns in posts, and content freshness signal (most recent post date). |
get_commercial_signals | Check commercial conversion signals: presence of contact forms (CF7, Gravity Forms, WPForms, native), presence of email signup forms (Mailchimp, ConvertKit, Mailerlite, etc.), phone number presence on homepage and contact page, physical address presence, count of pages with no clear CTA text patterns ("contact us", "get started", "buy now", "book a call", "sign up", "get a quote"), count of testimonial/review elements detected, whether WooCommerce or Easy Digital Downloads is active. |
post_admin_notice | Store an admin notice to be shown in the WordPress dashboard. Used by scheduled audits to alert the site owner about score changes. |
Tool Details
run_full_audit
Run the complete 8-dimension site audit. Returns scores for all dimensions, the overall score (0–100), a letter grade, individual check results with pass/fail/warning status, and the top 3 prioritised roadblocks. Takes 30–90 seconds for larger sites.
No parameters required.
audit_dimension
Run the audit for a single dimension only. Useful for re-checking a specific area after making fixes without running the full scan.
| Parameter | Type | Required | Description |
|---|---|---|---|
dimension | string | Yes | The dimension to audit. |
get_audit_history
Retrieve stored audit history (up to 12 past reports). Returns date, overall score, grade, and per-dimension scores for each entry. Used to show score trends over time.
No parameters required.
save_audit_result
Save an audit result to the history store. Pass the full audit result object returned by run_full_audit. Keeps the last 12 results and rotates older ones out.
| Parameter | Type | Required | Description |
|---|---|---|---|
result | object | Yes | The full audit result object from run_full_audit. |
get_site_overview
Get high-level site metadata: WordPress version, active theme, active plugins list, permalink structure, homepage URL, site title, tagline, total published post count, total page count, and whether search is discouraged.
No parameters required.
get_content_stats
Analyse all published posts and pages: total count, average word count, count of thin posts (under 300 words), freshness breakdown (posts by age: 0-3 months, 3-6 months, 6-12 months, 12+ months), most recent publish date, publishing cadence (average days between posts over the last 6 months), posts without featured images, posts without categories or tags.
No parameters required.
get_seo_stats
Scan all published posts and pages for SEO issues. Returns: count of pages missing title tags, count missing meta descriptions, count with duplicate titles, count with duplicate meta descriptions, count with no H1, count with multiple H1s, count with no internal links (orphaned), count of images missing alt text (site-wide total), and a list of pages with noindex set.
No parameters required.
get_accessibility_stats
Analyse accessibility issues across all published pages: total images missing alt text, count of alt attributes that are empty vs missing, heading hierarchy violations (pages with no H1, pages with multiple H1s, pages where H3 appears without H2), count of pages with generic link text ("click here", "read more", "here"), form elements without labels (based on post content scan).
No parameters required.
get_privacy_compliance_status
Check GDPR/privacy compliance signals: whether a privacy policy page exists and is linked, whether a terms of service page exists, whether the site is served over HTTPS, which known third-party script domains are detected in theme/plugin assets (Google Analytics, Facebook Pixel, Hotjar, Google Tag Manager, etc.), whether a cookie consent plugin is active, and whether consent-related text patterns appear in the privacy policy content.
No parameters required.
get_web_standards_status
Check web standards compliance: robots.txt presence and content, sitemap.xml presence and post coverage percentage, favicon presence, Open Graph meta tag coverage across pages, canonical tag coverage, mobile viewport meta tag on all pages, whether images use srcset for responsive sizing, and mixed-content (HTTP resources on HTTPS pages) indicators.
No parameters required.
get_ai_visibility_status
Check AI search visibility: which AI bots (GPTBot, ClaudeBot, ChatGPT-User, Google-Extended, PerplexityBot) are allowed or blocked in robots.txt, whether an llms.txt file exists, schema markup types present site-wide (Organization, Article, FAQPage, BreadcrumbList), FAQ-formatted content patterns in posts, and content freshness signal (most recent post date).
No parameters required.
get_commercial_signals
Check commercial conversion signals: presence of contact forms (CF7, Gravity Forms, WPForms, native), presence of email signup forms (Mailchimp, ConvertKit, Mailerlite, etc.), phone number presence on homepage and contact page, physical address presence, count of pages with no clear CTA text patterns ("contact us", "get started", "buy now", "book a call", "sign up", "get a quote"), count of testimonial/review elements detected, whether WooCommerce or Easy Digital Downloads is active.
No parameters required.
post_admin_notice
Store an admin notice to be shown in the WordPress dashboard. Used by scheduled audits to alert the site owner about score changes.
| Parameter | Type | Required | Description |
|---|---|---|---|
message | string | Yes | The notice message. Plain text or basic HTML. |
type | string | Yes | Notice severity. Use success for improvements, warning for drops, info for stable. |
Usage
Chat
When you open a chat with Site Auditor, you'll see:
> 📋 Site Auditor
I run a comprehensive audit of your website's commercial performance across 8 dimensions and tell you exactly what to fix first.
- What I audit:
- 🎯 User Experience — navigation, mobile, Core Web Vitals, CTAs
- ♿ Accessibility — alt text, contrast, ARIA, keyboard navigation
- 🔐 GDPR & Privacy — cookie consent, privacy policy, trackers
- 🌐 Web Standards — HTML, sitemap, Open Graph, mobile viewport
- 🔍 SEO Health — titles, meta, schema, internal linking, indexability
- 📡 AI Visibility — AI crawler access, structured data, content extractability
- 📝 Content Quality — freshness, depth, readability, media richness
- 💰 Commercial Viability — CTAs, trust signals, contact info, lead capture
Hit 📋 Run Full Audit to get your score and Top 3 Roadblocks.
Suggested Prompts
- 📋 Run Full Audit
- 📊 View Last Report
- 🔍 Audit Accessibility Only
- 📈 Show Score History
WP-CLI
# Interactive prompt
wp agent prompt site-auditor "Your message here"
# View agent info
wp agent info site-auditor
# List available tools
wp agent tools site-auditor
_Generated by Assistant Trainer — Agent Builder for WordPress_