title-score

Heuristic 0-100 scorer for YouTube titles, modeled after vidIQ's title score. The exact vidIQ algorithm is proprietary; this is a transparent approximation with tunable weights.

How to score

Run the script. It accepts a single title as an arg, or multiple titles via stdin (one per line).

scripts/score.py "Your Title Here"
scripts/score.py --json "Your Title Here"
printf "Title one\nTitle two\nTitle three\n" | scripts/score.py -

Output shows the final score, chars/words, and the per-factor sub-scores (length, word_count, number, power, sentiment, caps, punct, stopword, specificity, cliche).

When the user asks to score titles

1. Run the script for each title.
2. Report each title's score plus a one-line "what's helping / what's hurting" based on which sub-scores are notably high or low.
3. If the user wants to improve a title, suggest concrete edits targeted at the weakest sub-scores (e.g., low power → add a curiosity/emotion word; low length → expand to 50-60 chars; low specificity → add a proper noun).