wordpress_analyze_readability

Analyze content readability including Flesch Reading Ease score, sentence length, and paragraph structure.

Parameters

1 parameter, 1 required.

Example call

The smallest valid call, with the required parameters only:

{
  "name": "wordpress_analyze_readability",
  "arguments": {
    "page_id": 123
  }
}

Response

{
  "success": true,
  "score": 61,
  "grade": "Plain English",
  "metrics": {
    "avg_sentence_length": 18.4,
    "avg_paragraph_length": 3.2,
    "passive_voice_pct": 9
  },
  "recommendations": [
    "Shorten long sentences (aim for 12-18 words)",
    "Break up long paragraphs (2-4 sentences each)"
  ]
}

What it changes

Nothing. It only reads, so there is nothing to approve and nothing to undo.

How long it takes

A typical call takes about 2.1 seconds. 19 in 20 finish within 3.3 seconds. Measured on real sites over the last week, so it includes the site's own hosting.

Availability

Works on any WordPress site, whichever page builder it uses. Available since Respira 1.0.0.

Full Example

Prompt: "Analyze readability on page 42"

Response:

{
  "success": true,
  "score": 42,
  "grade": "Difficult",
  "metrics": {
    "avg_sentence_length": 28.6,
    "avg_paragraph_length": 6.7,
    "passive_voice_pct": 21
  },
  "recommendations": [
    "Rewrite long sentences into shorter, active-voice sentences",
    "Add headings and bullet lists to improve scanning",
    "Move key claims into the first 1-2 sentences of each section"
  ]
}

Notes

• Read-only tool - doesn’t modify content
• Best results come from iterating: analyze → edit → analyze again

Example Prompts

• "Analyze readability on my homepage"
• "Check readability on page 42"
• "Is my services page too complex?"

Related Tools

• wordpress_analyze_seo - SEO analysis often correlates with readability
• wordpress_analyze_aeo - AEO improves when content is structured and clear