royal-mcp__wp_audit_seo_bulk
[Royal MCP Pro] Generic on-page SEO audit across a post type — checks the basics (title/description length, noindex, H1 count, word count, images + alt-text, featured image). Uses the active SEO plugin as the source of title + meta description when one is detected (Yoast, Rank Math, SEOPress, AIOSEO, or SEObolt); falls back to WordPress-native fields (post_title, post_excerpt) otherwise. Does not surface plugin-native scores (e.g. SEObolt geo_score, Yoast readability). Returns per-page findings + optional aggregated rollup (issues by type, worst offenders). Publish-only by default; pass include_drafts=true for pre-publish workflow audits. The content is read as stored and nothing in it is run (no shortcodes, blocks or embeds), so text and images a shortcode or dynamic block adds when the page is served are not counted; such pages are marked content_made_when_served. Title and description text is sent back up to 300 characters with its full length. A call stops after about 20 seconds or about 1 MB of findings… Through Royally: read-only, runs straight away.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "royal-mcp__wp_audit_seo_bulk"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rollup | No | Include the aggregated rollup summary alongside per-page results. Default: true. | |
| site_id | No | Site to run this tool on: 8ef2e52b-bd07-4671-a363-ebe8b480b65c (https://demo.royalplugins.com) | |
| paginate | No | Pagination controls. Defaults: page 1, per_page 100 (max 500). | |
| post_ids | No | Optional. When provided, audit ONLY these post IDs (must be of post_type; a list of 1 to 500 whole numbers, anything else is refused). Results come in ID order, paged by paginate. Skips the pagination sweep of every post — useful for targeted re-audit after a fix, or for auditing a specific customer complaint. | |
| snapshot | No | Accepted for compatibility; no backup is taken. The audit only reads, so it needs none — sitevault_snapshot reports status "skipped". To back up before a bulk write, call sv_create_backup first. | |
| post_type | No | Post type to audit (must be a registered CPT slug). Default: "post". | |
| include_drafts | No | Include draft/pending/private/future posts alongside published ones. Default: false (publish-only). Agents auditing an SEO surface typically care about what customers actually see, so drafts are opt-in. | |
| verify_rendered_h1 | No | When the theme renders the post title outside the content, load the served page to count its visible H1s instead of reporting h1_unverifiable_theme_title. This loads up to 10 published pages per call the way a visitor gets them, which runs the site's normal page code (theme, plugins, shortcodes) for those pages; each load counts against the per-page limit the page tools share. Adds h1_rendered_count. Default: true; pass false to only read stored data. | |
| count_decorative_alts | No | How to treat alt="" (HTML5 decorative-image marker). Default: true — counts decorative images in images_missing_alt + flags "N_images_missing_alt" issue (strict SEO parity, matches agency-audit convention). Set false to only count images with NO alt attribute at all — separates decoration from missing metadata. images_no_alt + images_decorative_alt are always returned separately regardless of this setting. |