List Posts by SEO Score is a WordPress ability from SiteSEO – SEO Simplified — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →List Posts by SEO Score
Read-onlyList posts with their cached SEO content-analysis score.
Requires the SiteSEO plugin on WordPress 6.9+ for the Abilities API (abilities are registered only when the wp_register_ability() function exists). Each ability is additionally gated by the caller holding the matching WordPress capability — edit_posts for the post abilities, or manage_options for settings, audit, and sitemap abilities.
What it does
This ability returns posts along with their cached SiteSEO content-analysis score, scoped by post_type and status and paged with limit and offset. It's built for finding the worst- or best-performing content on the site at a glance, so an AI assistant can immediately point to which posts most need SEO work without inspecting each one individually.
See it in action
You ask your AI assistant
"List my published posts with their current SEO score so I know which ones need work."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| post_type | array | No | Restrict results to specific post types. |
| status | array | No | Restrict results to specific post statuses. Defaults to ["publish"]. |
| limit | integer | No | Maximum number of posts to return (1-100). Defaults to 20. |
| offset | integer | No | Pagination offset. Defaults to 0. |
Returns
An object with a 'posts' array (each with id, post_title, post_type, status, permalink, and seo_score) and a 'total' count.
Permission
The current user must have the WordPress 'edit_posts' capability.
More SiteSEO – SEO Simplified abilities
Get Homepage SEO Audit
Get an SEO snapshot of the homepage, including title, meta description, robots flags, social meta and cached score.
Get Post SEO Data
Retrieve the SEO snapshot for a single post: title, meta description, focus keyphrase, robots flags, canonical URL and social meta.
Get Site SEO Audit
Get a site-wide SEO health snapshot covering the homepage, sitemap status, custom robots rules, and public post types.
Get Sitemap Status
Check whether the SiteSEO XML sitemap is enabled and get its index URL.
Get SiteSEO Settings
Read the full SiteSEO settings tree.
List Posts Missing SEO Data
Find posts where the title, meta description, or focus keyphrase hasn't been set.