WP Manifestindependent plugin directory
manifest / seo / seowmx-modern-web-guidance-plugin-wp-ai

Auditor Web Moderno

WordPress plugin that audits your pages with Google Chrome’s Modern Web Guidance and the Claude API, suggesting performance, accessibility, and CSS improvements. It only suggests; it never modifies your site.

★ 0stars

Install

Download source zip No release zip yet

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.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Modern 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

  1. Pick a page from your site and a focus area under Tools > Auditor web moderno.
  2. 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.
  3. It downloads the Modern Web Guidance guides that match the chosen focus.
  4. It sends everything to the Claude API along with WordPress context (active theme, parent theme, and active plugins).
  5. 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.com and api.anthropic.com

Installation

  1. Download the repository as a ZIP (or zip the mwg-auditor folder).

  2. In WordPress, go to Plugins > Add New > Upload Plugin, upload the ZIP, and activate it.

  3. 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.

  4. 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.