Get SEO scores is a WordPress ability from Rank Math SEO — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Get SEO scores
Read-onlyReturn SEO scores and grades for posts, optionally filtered by score band, missing focus keyword, or unscored status.
Requires the Rank Math SEO plugin on WordPress 6.9+ for the Abilities API. AI Visibility abilities require the 'manage_options' capability; Link Genius abilities require 'rank_math_link_builder'; Post SEO abilities require 'rank_math_onpage_general'; Schema abilities require 'rank_math_onpage_snippet'; SEO Analysis abilities require 'rank_math_site_analysis'; Analytics abilities require 'rank_math_analytics'; Content Analysis abilities require 'rank_math_onpage_analysis'. Some outputs (broken-link audit data in get-link-report, extra schema types in get-post-schema) are only populated when Rank Math PRO is active.
What it does
This ability lists posts along with their Rank Math SEO score, grade (good/ok/bad/na), and focus keyword, letting an AI assistant surface which posts need SEO attention without knowing post IDs in advance. By default it returns the most recently modified posts (up to number_of_posts, default 10, maximum 100), optionally restricted to a specific post_type. Passing seo_filter narrows the result to one specific bucket: bad (score ≤ 50), good (score 51-80), great (score > 80), empty-fk (no focus keyword set), or unscored (never analyzed) — the three score-based filters additionally exclude noindexed posts and require a focus keyword to be set, and are ordered worst-score-first. The ability's own description instructs the caller to ask the user which posts they want to review before running it, rather than guessing a filter. Requires the 'rank_math_onpage_analysis' capability.
See it in action
You ask your AI assistant
"Show me the 10 posts with the worst SEO scores that need improvement."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| number_of_posts | integer | No | Number of recently modified posts to retrieve. Defaults to 10, maximum 100. |
| post_type | string | No | Post type to filter by (e.g. "post", "page"). Defaults to all public post types. |
| seo_filter | string | No | Which posts to review: "bad" (score ≤ 50), "good" (score 51-80), "great" (score > 80), "empty-fk" (no focus keyword set), or "unscored" (never analyzed). If omitted, returns the most recently modified posts. |
Returns
An array of post objects, each with post_id, title, keyword (focus keyword or null), score (0-100 or null), grade (good/ok/bad/na), label (human-readable grade), and last_updated (Unix timestamp of the post's last modification).
Permission
Requires the 'rank_math_onpage_analysis' capability.
More Rank Math SEO abilities
Analyze post content
Gather a post's raw content, metadata, and list of on-page SEO tests so an AI agent can run Rank Math's full on-page analysis itself.
Audit site SEO
Run Rank Math's site-wide SEO audit and get back a structured score with per-test findings and fix hints.
Create AI Visibility brand
Add a new brand to AI Visibility monitoring and automatically kick off its first analysis.
Fix site SEO
Apply an automatic fix for a single failing Rank Math SEO audit test.
Get AI Visibility brand insights
Pull the full AI Visibility analysis for a single brand — score, rank, sentiment, mentions, citations, competitor breakdown, and raw per-query AI responses.
Get AI Visibility brand queries
List the search queries being monitored for a brand's AI Visibility tracking, including which are enabled or auto-generated baselines.