MAHMOUD ABDELNABY
Content · CLI SCRIPT · 2

Bilingual Arabic-English Copywriting Cadence & Punchiness Meter

Make your copy impossible to stop reading. Measure sentence rhythm and eliminate bloated filler words in Arabic and English.

Problem it addresses

Build an open-source copywriting rhythm and cadence analyzer in Python (cadence_meter.py): 1) Analyzes sentence word-length variance (calculating cadence score and visual rhythm wave), 2) Detects configured passive or filler phrases in Arabic and English, 3) Suggests direct, punchy alternatives, 4) Outputs an interactive HTML visual report highlighting monotonous paragraphs.

Who it is for

BOTH operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

What is inside

Key files listed in the README repository architecture:

  • data/arabic_filler_phrases.json
  • data/english_weak_words.json
  • examples/saudi-fintech-ceo-case.md
  • LICENSE
  • playbooks/linkedin-carousel-adapter.md
  • README.md
  • reports/sample_rhythm_report.html
  • src/cadence_meter.py
  • templates/interview-transcript-intake.md
  • templates/pillar-article-framework.md
  • tests/test_cadence.py
  • tests/test_meter.py

How to evaluate and use it

  1. Read the README first and confirm that the documented problem matches your use case.
  2. Inspect the listed files to find the data, tools, templates, and tests relevant to your task.
  3. Follow the repository’s Quick Start and check prerequisites before running commands.
  4. Compare outputs with documented examples and review limitations before using them in a decision or client workflow.

Quick Start from the README: python -m unittest discover -s tests · python src/cadence_meter.py --help

Scope and limitations

  • Syllable & Word Length Ratios: Measures reading cadence in Arabic and English, calculating syllables-per-word and sentence punchiness.
  • Arabic Morphological Complexity: Distinguishes between heavy classical agglutinative words and punchy modern colloquial advertising copy.
  • CTA Readability Scoring: Flags wordy, passive CTAs and recommends concise, action-oriented regional verbs.

This page summarizes the available documentation; it does not establish performance or business results. Verify data and prerequisites before use.

Related repositories