DEV3 AI SEO Assistant for Yoast & Rank Math

WordPress plugin: it drafts SEO titles, descriptions, focus keywords, schema, internal links and FAQ blocks with the Google Gemini API, then writes each accepted field into Yoast SEO, Rank Math, SEOPress or All in One SEO, with history and undo. Free download: sign in and click Download ZIP. Add your own Google AI Studio (Gemini) API key to switch on the AI features; the documentation says which features work without one.

How it works

We built DEV3 AI SEO Assistant as a PHP plugin with a React admin app and a block editor sidebar. The AI writes suggestions; a small adapter layer decides where and how they are stored.

Key design decisions

• One adapter per SEO plugin. Yoast SEO, Rank Math, SEOPress, All in One SEO and a native fallback share one interface: six fields (SEO title, meta description, focus keyword, social title, social description, schema type). Each adapter maps them to its plugin's real storage: _yoast_wpseo_* meta, rank_math_* meta, or AIOSEO's own table through its documented model.
• Plugin rules, not just keys. Yoast splits schema into page type and article type, so an article type clears the page type to win. Rank Math takes a comma-separated keyword list, deduplicated and capped at its free limit of 5. AIOSEO stores keyphrases as JSON, so the adapter edits only the focus entry.
• Editor store sync. When a value is applied while the post is open, the sidebar also dispatches it into the yoast-seo/editor or rank-math data store, so the next "Update" saves the same value instead of the stale one held in the browser.
• Drafts, conflict checks and undo. Every suggestion is a field-level draft. Apply refuses with a 409 if the live value changed since the draft was made; every apply writes a history row with the adapter it used, so undo writes back to the same plugin even after the site switches.
• Schema merged, not duplicated. Extra JSON-LD pieces (FAQPage, HowTo, Product and more) are added to Yoast's and Rank Math's own graphs. A FAQPage piece is dropped when the post already contains the SEO plugin's native FAQ block.
• Useful with AI off. Checks, a 0–100 score, rules-based titles and descriptions, word-match link suggestions and the site audit all work without an API key.

Architecture

The Google Gemini API (gemini-2.5-flash by default) returns structured JSON with up to 3 options per field, cached per content hash. Internal links come from a background embeddings index of published posts (gemini-embedding-001), and the AI's anchor phrase must already exist in the source paragraph, which is checked on the server. Bulk runs of up to 2,000 posts go through background jobs into a review queue with diffs, inline edit and "apply all pending of this run". The API client, settings, usage logs and job runner come from a shared core used across DEV3's plugins.

What's in the download

• The installable plugin zip: upload it through Plugins → Add New → Upload Plugin.
• Full HTML documentation (installation, settings, hooks, FAQ).

Requirements

• WordPress 6.0 or newer and PHP 7.4 or newer
• Recommended: Yoast SEO or Rank Math (free or premium). SEOPress and All in One SEO are also supported; with no SEO plugin, DEV3 prints the title, meta description and Open Graph tags itself
• The block editor for the DEV3 AI SEO sidebar. Classic-editor sites use the post screen inside the plugin's admin
• Optional: a Google Gemini API key. Without one, checks, scores, reports and rules-based suggestions still work

Learn more

• How we built it: the AI SEO Assistant case study
• Engineering write-up on the DEV3 blog
• Also free in the DEV3 AI Content, SEO & Site Tools Plugins Bundle with every other Content, SEO & Site Tools plugin.