Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/seowmx/seowmx-modern-web-guidance-plugin-wp-ai/archive/refs/heads/main.zipModern Web Auditor
A WordPress plugin that audits your site's pages using the Modern Web Guidance guides and the Claude API, and suggests concrete improvements for performance, accessibility, CSS, HTML, and forms.
It only suggests: it never modifies your site. You decide what to apply.
Status: prototype (v0.2.0). Try it on a staging site first.
The admin interface and the reports are currently in Spanish. Leer en español.
What it does
- Pick a page from your site and a focus area under Tools > Auditor web moderno.
- The plugin fetches the page as an anonymous visitor would see it and extracts its technical data: images, scripts, stylesheets, inline styles, resource hints, and an excerpt of the HTML.
- It downloads the Modern Web Guidance guides that match the chosen focus.
- It sends everything to the Claude API along with WordPress context (active theme, parent theme, and active plugins).
- It displays a report where each finding includes severity, evidence, a recommendation, where to apply it (child theme, a plugin's settings, the Customizer), and code when needed.
The report can be copied as Markdown to hand off to a coding agent such as Claude Code.
Focus areas
| Focus | Guides used |
|---|---|
| Performance (Core Web Vitals) | performance, optimize-image-priority, optimize-preload-priority, optimize-script-priority, identify-heavy-scripts |
| Accessibility | accessibility |
| CSS and responsive design | css, css-layout, responsive-design, reduce-style-repetition |
| HTML and semantics | html |
| Forms | forms |
| General review | performance, optimize-image-priority, html, css, accessibility |
You can add or change focus areas with the mwga_focus_map filter.
Requirements
- WordPress 6.2 or later
- PHP 7.4 or later, with the DOM extension
- A Claude API key
- Outbound access from your server to
raw.githubusercontent.comandapi.anthropic.com
Installation
-
Download the repository as a ZIP (or zip the
mwg-auditorfolder). -
In WordPress, go to Plugins > Add New > Upload Plugin, upload the ZIP, and activate it.
-
Add your API key to
wp-config.php(recommended):define( 'MWGA_API_KEY', 'your-key' );You can also paste it in the plugin settings, but it will then be stored in the database.
-
If your site is password-protected at the hosting level (common on staging sites), add the credentials:
define( 'MWGA_BASIC_USER', 'username' ); define( 'MWGA_BASIC_PASS', 'password' );
Optional configuration
| Constant or filter | Purpose | Default |
|---|---|---|
MWGA_API_KEY |
Claude API key | — |
MWGA_BASIC_USER / MWGA_BASIC_PASS |
Access to password-protected sites (sent over HTTPS only) | — |
MWGA_GUIDES_REF |
Branch, tag, or commit of the guides repository to pin | main |
mwga_daily_limit (filter) |
Maximum audits per day | 30 |
mwga_focus_map (filter) |
Add or change focus areas and their guides | — |
The Claude model can be changed in the plugin settings.
Security
- Only administrators (
manage_options) can use it, and every action verifies a nonce. - It only audits pages on the site's own domain. Redirects are checked hop by hop and blocked if they leave the site.
- Credentials for password-protected sites are never sent over plain HTTP or to other domains.
- Reports are rendered without interpreting HTML, so nothing the AI generates can run in the admin screen.
- Prompt injection: a page can contain third-party text that tries to manipulate the AI. To reduce this risk, visitor comments are not sent, the prompt treats page content as data rather than instructions, and a filter flags any suggested code that contains dangerous patterns (
eval, shell commands, encoded content, user or role changes, file writes, external domains). - One audit at a time per user, plus a daily limit, to prevent unexpected API costs.
Always review suggested code before using it, and test it on a staging site. The filter catches known patterns, not every possible one.
Privacy
Sent to Anthropic: the public HTML of the audited page (without visitor comments), the names of the active theme and plugins, and the WordPress version. No passwords or user data are sent. The page is fetched without a session, as an anonymous visitor.
Limitations
- It doesn't run JavaScript or measure real browser metrics: it complements Lighthouse or PageSpeed Insights rather than replacing them.
- Each audit uses credits from your Claude API account.
- On hosts that cut off long requests, an audit may time out; use a specific focus instead of the general review.
Structure
mwg-auditor/
├── mwg-auditor.php Main plugin file
├── uninstall.php Cleanup when the plugin is deleted
├── includes/
│ ├── class-admin.php Admin screen, settings, and AJAX actions
│ ├── class-page-analyzer.php Page fetching and analysis
│ ├── class-guides.php Guide downloading and caching
│ ├── class-claude-client.php Claude API communication
│ └── class-report-guard.php Dangerous code detection
└── assets/
├── admin.css
└── admin.js
Credits and license
- Plugin: GPL-2.0-or-later.
- Guides: Modern Web Guidance by Google Chrome, licensed under Apache 2.0. The plugin doesn't bundle copies of the guides; it downloads them at runtime and caches them temporarily.