analyze_readability
Analyze a website URL for content readability using Flesch Reading Ease.
Extracts plain text from HTML and computes readability metrics including
Flesch Reading Ease score, Flesch-Kincaid grade level, reading time,
and word/sentence statistics.
Grade Scale (web-optimized):
- A (60-100): Easy, 6th-8th grade — ideal for web content
- B (50-59): Fairly easy, some high school
- C (30-49): Standard, college level
- D (10-29): Difficult, graduate level
- F (0-9): Very difficult, professional/academic
Results are cached for fast subsequent lookups.
Rate limited to 1 request per minute per domain.
Args:
url: The website URL to analyze (e.g., "https://example.com").
Returns:
Readability analysis with:
- url: The analyzed URL
- score: Flesch Reading Ease score (0-100, higher = easier)
- grade: Letter grade (A-F)
- flesch_kincaid_grade_level: US school grade level equivalent
- reading_time_minutes: Estimated reading time in minutes
- word_count: Total word count
- sentence_count: Total sentence count
- difficult_words: Count of difficult/uncommon words
- cached: Whether result was from cache
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "analyze_readability"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||