Text Stats

Analyze any text document for readability, word count, keyword density, and more. Perfect for content optimization, SEO analysis, or writing improvement.

Usage

Full analysis

python3 {baseDir}/scripts/text_stats.py analyze document.txt
python3 {baseDir}/scripts/text_stats.py analyze document.md

Word count only

python3 {baseDir}/scripts/text_stats.py wc document.txt

Keyword density

python3 {baseDir}/scripts/text_stats.py keywords document.txt --top 20

Reading time

python3 {baseDir}/scripts/text_stats.py time document.txt

Output Example

📊 Text Analysis: article.md
━━━━━━━━━━━━━━━━━━━━━━━━━━
Words:          2,847
Characters:     16,203
Sentences:      142
Paragraphs:     38
Avg words/sent: 20.0
Reading time:   ~11 min (at 250 wpm)

Readability:
  Flesch-Kincaid Grade: 8.2 (8th grade)
  Flesch Reading Ease:  62.1 (Standard)
  Gunning Fog Index:    10.4

Top Keywords:
  AI (47x, 1.65%)
  agent (31x, 1.09%)
  data (28x, 0.98%)

Features

• 📏 Word, character, sentence, paragraph counts
• ⏱️ Estimated reading time
• 📖 Readability scores (Flesch-Kincaid, Gunning Fog, Flesch Reading Ease)
• 🔑 Keyword frequency and density
• 🇨🇳 CJK character counting (Chinese characters = words)
• 🪶 Zero dependencies — Python stdlib only

Dependencies

None! Uses only Python standard library.