Supported SEO plugins ability reference

What SEO (any plugin) needs before these load

One of Yoast SEO, Rank Math, All in One SEO, SEOPress, The SEO Framework, Slim SEO or SmartCrawl must be active. With none, the calls return wppilot_seo_no_provider and list the supported plugins. With two active, they return wppilot_seo_provider_ambiguous and ask for provider, naming it as the plugin the front end actually uses, since a site mid-migration often has both installed.

SEO (any plugin) editions

free, pro

Agent skills shipped

yoast-integration, rank-math-integration, aioseo-integration, seopress-integration

One shape for every plugin

The fields are SEO title, meta description, focus keyword, canonical, robots index and follow, and Open Graph title and description. Not every plugin stores all of them: Slim SEO keeps no focus keyword, robots follow or Open Graph text, and The SEO Framework keeps no focus keyword. A read returns an empty string for a field the plugin does not have; a write that includes one fails that post with wppilot_seo_field_unsupported instead of pretending it saved.

The read is paginated and filterable by post type and status, and by three audit filters: missing_description, missing_title (no title override set) and duplicate_titles (posts whose effective title is the same, compared before template variables are expanded). A filtered read inspects at most 1,000 posts and reports truncated=true when there were more.

Writes, confirmation and undo

A write covers up to 100 posts. Without dry_run or confirm it is refused with wppilot_confirmation_required and a message saying how many posts it would overwrite in which plugin. dry_run=true returns each post's before and after; confirm=true writes through the plugin's own per-post writer, and results come back per post as updated, unchanged or error, with one failure never stopping the others.

Each written post gets its own ledger row. Rows for Yoast SEO, Rank Math, SEOPress, The SEO Framework, Slim SEO and SmartCrawl restore with wppilot/rollback-change. All in One SEO rows written by this bulk call are marked irreversible because it keeps post SEO in its own aioseo_posts table (the free plugin's single-post AIOSEO edit keeps its own before-image, but this call does not); to undo them, run the write again with the before values from the batch. A very large batch can also use up its share of the ledger, in which case the affected posts say no before-image was kept and suggest sending fewer per call.

Representative call sequence

This sequence describes the documented calls and checks to perform. It is not a recorded result from an installed WordPress site. Inspect returned errors and partial results, then verify the saved values and affected output before proceeding.

Find posts that share a title and give each a distinct SEO title.

1. 01 wppilot/seo-bulk-get-meta Called with duplicate_titles=true for the post type, returning the groups of posts whose effective titles match.
2. 02 wppilot/seo-bulk-update-meta Called with dry_run=true and an item per post carrying its own title, so each post's before and after can be read side by side.
3. 03 wppilot/seo-bulk-update-meta Repeated with confirm=true once approved. The per-post results show which were updated and which were unchanged.