Use case · Site-wide SEO audit
Audit your whole site's SEO in one sentence.
Counts and samples for every category that matters: missing focus keyword, bad-length meta description, no featured image, alts to fix. Auto-detects RankMath, Yoast, or no SEO plugin.
The problem you actually have
RankMath and Yoast both have audit dashboards, but they show one post at a time. There’s no built-in “scan all 380 posts and tell me which 12 are missing meta descriptions, which 7 have descriptions outside the 70-160 char band, which 28 images need alts, which 4 posts don’t have a featured image.”
You can build a query in WP-CLI to get this. You can install yet another plugin. Or you can ask the agent: “audit the SEO across the whole site.” and have a punch list in the next chat turn — with one-click follow-ups to fix each category.
It’s the difference between knowing you have an SEO debt problem and having a list of exactly which 51 things to fix this morning.
How the assistant solves it
You type the request in plain English inside wp-admin. The agent picks wp_seo_audit (plus wp_set_seo_meta, wp_set_image_alt_bulk as needed) and walks the steps below.
- You ask: “audit the SEO across all posts and pages.”
- The assistant calls
wp_seo_audit. It auto-detects RankMath / Yoast / The SEO Framework / none and queries the right meta keys. - It returns counts and sample IDs (up to 50 per category): missing focus keyword (12 + sample), missing meta description (8), bad meta description length (7 with the actual lengths), missing meta title (3), missing featured image (4), images without alt (28).
- It presents a punch list as a markdown table.
- You pick categories to fix: “start with the 8 missing meta descriptions, write the description for each post based on the first 200 words.”
- The assistant chains
wp_search_poststo read each post, generates descriptions, presents for review, and applies them viawp_set_seo_meta(which writes to RankMath or Yoast meta keys depending on what’s active).
Before vs after
| Without the assistant | With the assistant | |
|---|---|---|
| Time to know your debt | 30+ minutes navigating RankMath/Yoast dashboards post-by-post | 5 seconds, one chat turn |
| Coverage | You audit the 20 most recent posts and call it good | Every published post and page, with sample IDs to drill into |
| Action plan | Build it yourself in a spreadsheet | Returned as part of the audit response, ready to act on |
| SEO plugin agnostic | Manual switch in your head between RankMath and Yoast docs | Auto-detected, right meta keys queried |
Where it stops
- Audits readability of structured meta only — focus keyword presence, meta description length, featured image presence, alt tag presence. Does not assess content quality, semantic relevance to keyword, or competitor coverage. That’s the LLM’s job in conversation, not the tool’s.
- For sites without RankMath/Yoast/The SEO Framework, the audit falls back to checking
_animam_seo_*meta keys (which the plugin writes to as a stash). Less complete than with a real SEO plugin. - Auto-detect works on the standard plugin constants. If you fork RankMath or run a private build, you may need to set the seo plugin manually in plugin settings.
FAQ
How is this different from running RankMath's audit?
RankMath’s audit is post-by-post; this gives you whole-site counts in seconds, plus samples to drill into, plus follow-up tools to actually fix the issues from the same chat. RankMath stays useful for the per-post detail view.
Does it also score readability and Flesch-Kincaid stuff?
No — that’s scope-creep into RankMath territory. The audit focuses on structural metadata. The agent in chat can advise on content quality if you ask, but it’s not embedded in the tool itself.
Plan?
Admin (€29/mo) or Bundle (€39/mo).
Know your SEO debt before lunch.
Free plan, no card. Or read the full admin assistant page.