seo/get-seo-score-summary reports how the site’s published posts distribute across Yoast’s SEO score bands: good, needs improvement, bad, and not analysed.
The not-analysed band is usually the largest and the most interesting.
At a glance
| Ability | seo/get-seo-score-summary |
| Toolset | Yoast SEO — toolset/yoast-seo |
| Group | Yoast SEO › Content Analysis |
| Requires | Yoast SEO, active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
Yoast scores a post when somebody opens it in the editor and the analysis runs. A post published before Yoast was installed, or imported, or never reopened, has no score at all.
On most established sites that is the majority of the content. A summary showing “60% good” across the scored posts can be describing a tenth of the site.
So the not-analysed count is what the summary is actually for. It tells you whether the other three numbers mean anything.
The bands are Yoast’s own thresholds rather than anything universal. They are a consistent internal measure — useful for tracking a site against itself over time, and not comparable to any other tool’s score.
Published posts only. Drafts are not being judged by anybody yet.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
post_type | string | No | Restrict to one post type. |
What comes back
| Name | Type | What it is |
|---|---|---|
bands | object | How many posts fall in each band. |
total | integer | How many published posts were counted. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
How is our SEO doing overall?
It resolves to one call:
{
"ability": "seo/get-seo-score-summary",
"parameters": {}
}Worth knowing
- The not-analysed band tells you how much the other three are worth.
- A post is only scored once the editor has analysed it.
- The bands are Yoast’s thresholds, not a universal measure.
- Published posts only.
Related abilities
- List Low Scoring Content — the posts behind the bad band
- Get Content SEO Issues — what to actually do
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category