# 📋 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.

### Example Prompts

- "Run a full audit of my site and show me the top 3 things to fix"
- "How has my site score changed over the last month?"
- "Check only the accessibility dimension — I just fixed my alt text"
- "Audit my site's SEO and schema markup coverage"
- "What's my AI visibility score and how do I improve it?"
- "Show me all the commercial signals on my homepage — CTAs, trust badges, contact forms"
- "Do I have a privacy policy page and is my cookie consent set up properly?"
- "Check my web standards — sitemap, robots.txt, Open Graph tags, favicon"

### WP-CLI

```bash
# 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_
