Guide

Schema SEO Abilities

@prc/schema-seo registers two WordPress Abilities for AI SEO suggestions and deterministic reading-score analysis.

Ability index

AbilityPermissionSide effects
prc-schema-seo/suggestedit_postsRead-only AI suggestions
prc-schema-seo/reading-scoreedit_postsRead-only computation (no AI)

Both set show_in_rest: true and MCP public tool meta. Optional site_id runs against a multisite blog (defaults to the content site; returns plugin_inactive_on_site when inactive).

prc-schema-seo/suggest

FieldValue
LabelSuggest SEO Metadata
Categorydata-retrieval
Sourceincludes/ai-experiment/class-seo-ai-ability.php

Generates AI suggestions for SEO title, meta description, and social sharing text from post content.

Reference

Input

Typed options, defaults, and constraints in one scannable reference.
3 fields
post_id number required
Post to analyze.
fields array
Which fields to generate.
Defaulttitle, description, og_title, og_description Valuestitle, description, og_title, og_description
site_id number
Optional multisite blog ID.
Reference

Output

Typed options, defaults, and constraints in one scannable reference.
2 fields
suggestions object
Suggested title, description, og_title, og_description.
error string
Error message when generation fails.

prc-schema-seo/reading-score

FieldValue
LabelAnalyze Reading Level
Categorydata-analysis
Sourceincludes/class-reading-score.php
Idempotenttrue

Calculates Flesch-Kincaid Reading Ease and Grade Level for a post or arbitrary text. Accepts either post_id or raw text (text wins). For post_id, analyzes post content only (excerpt excluded) so scores match the editor Reading Score panel. word_count uses the Gutenberg @wordpress/wordcount algorithm.

Reference

Input

Typed options, defaults, and constraints in one scannable reference.
3 fields
post_id number
Post ID to analyze when text is omitted.
text string
Raw text; takes precedence over post_id.
site_id number
Optional multisite blog ID.

Output includes reading_ease, grade_level, grade_label, ease_label, word_count, and related sentence/syllable counts from the ability schema.

Was this helpful?