SEO Autopilot for WordPress

AI-assisted SEO for WordPress — the WordPress port of laravel-seo-autopilot, extracted from the production stack at stanfield.com.

What it does:

1. Find — pulls 30 days of GA4 page metrics and flags underperformers (high bounce, low engagement).
2. Suggest — sends each page's metrics to Claude, which returns an improved <title>, meta description, and Open Graph tags.
3. Review — suggestions land inactive in the admin. Nothing changes on your site until you click Activate.
4. Serve — approved overrides render via core hooks (pre_get_document_title + wp_head), with your theme's tags as the fallback.
5. Measure — captures before/after GA4 + Google Search Console metrics for every live override.
6. Write (optional) — an AI blog author picks a topic from your Search Console data (prioritizing high-impression/low-CTR and "striking distance" queries, deduped against your existing posts, with topic-cluster interlinking), writes a fully structured post (Key Takeaways, Quick Answer, callouts, pull quotes, FAQ), and saves it as a scheduled post — WordPress's native review window. Edit it, reschedule it, or let it go live.

No build step, no composer, no React — plain PHP using WordPress core APIs (wp_remote_post, WP-Cron, wp_insert_post, dbDelta). The Google APIs are called over REST with a service-account JWT signed via OpenSSL, so no Google SDK is bundled.

Requirements

• WordPress 6.0+, PHP 8.0+ (with OpenSSL, standard)
• An Anthropic API key
• A GA4 property + Google Cloud service account with viewer access
• Optional: the same service account added to Google Search Console

Installation

1. Download the latest release zip (or clone into wp-content/plugins/wp-seo-autopilot).
2. Activate SEO Autopilot in wp-admin → Plugins.
3. Open SEO Autopilot → Settings:
   • Paste your Anthropic API key.
   • Enter your GA4 property ID and paste the service account JSON key.
   • (Optional) Enter your Search Console property (sc-domain:example.com).
   • Fill in your brand name, site description, and keyword focus — these steer the AI copy.
4. On the Suggestions page, click Generate suggestions now.

Google setup

Create a service account in Google Cloud (no roles needed), download its JSON key, then:

• GA4: Admin → Property Access Management → add the service account email as Viewer.
• Search Console (optional): Settings → Users and permissions → add the same email.

How overrides render

Approved overrides are applied at render time through pre_get_document_title (title) and wp_head (meta description + OG tags). Your theme and permalinks are untouched — deactivate an override and the original tags return instantly.

Using Yoast / Rank Math / AIOSEO? They print their own description/OG tags, so you'd get duplicates. Either keep SEO Autopilot's overrides off for pages those plugins manage, or disable their meta output on the affected pages. (Native integration is on the roadmap.)

The blog writer

Enable it in Settings, set your audience ("busy homeowners", "K-12 special education teachers", …) and tone, then click Write blog draft now — or enable scheduled runs for a weekly cadence. Drafts are created as scheduled posts with a configurable review window (default 48h): you get an email with the edit link, and the post publishes itself only if you let it. Set the window to 0 to always require manual publishing.

The generated HTML uses semantic classes you can style once in your theme: .key-takeaways, .quick-answer, .callout (-tip, -example, -note), .pull-quote.

Refresh mode rewrites your oldest published post (older than 180 days) with current research and structure, keeping the topic and URL — one click on the Suggestions page.

Automation

Enable scheduled runs in Settings to get, via WP-Cron: monthly suggestion generation, weekly metric refresh, and (if the blog writer is on) a weekly draft. All runs also work on demand from the Suggestions page.

Data & privacy

• Page paths and aggregate metrics are sent to the Anthropic API to generate copy; no visitor-level data is ever sent.
• Google credentials are stored in your WordPress options table; the access token is cached in a transient for 55 minutes.
• Uninstalling the plugin drops its table and options completely.

Roadmap

• Yoast / Rank Math awareness (suppress duplicate tags automatically)
• Inline editing of suggestions
• Gutenberg sidebar panel for per-post suggestions

License

GPL v2 or later — see LICENSE.