Indice Coleman-Liau
Tre frasi brevi su un gatto seduto su un tappeto danno −2,975, circa il grado −3: primi anni della scuola elementare. Incolli un testo inglese e vedrà il grado Coleman-Liau con le lettere e le frasi ogni 100 parole che lo spiegano. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
L’indice Coleman–Liau stima l’anno scolastico degli Stati Uniti di cui un lettore tipico avrebbe bisogno per comprendere un brano. A differenza dei punteggi basati sulle sillabe come Flesch–Kincaid, questa formula usa soltanto lettere, parole e frasi: conteggi che un computer ottiene senza un dizionario di pronuncia. Incolli prosa inglese e questo calcolatore restituisce l’indice, i due tassi che lo alimentano (lettere per 100 parole e frasi per 100 parole), un grado arrotondato e una fascia scolastica grossolana. Usi il punteggio come segnale trasparente di complessità di superficie, non come affermazione su lessico raro o conoscenza del tema.
Che cosa misura l’indice Coleman-Liau e come funziona la formula
Meri Coleman e T. L. Liau hanno pubblicato questo indice perché le macchine potessero valutare la leggibilità senza indovinare le sillabe dall’ortografia. L’identità pubblica è CLI uguale a 0.0588 volte L meno 0.296 volte S meno 15.8.
L è il numero medio di lettere ogni cento parole. S è il numero medio di frasi ogni cento parole. Qui le lettere sono caratteri alfabetici dalla A alla Z in maiuscolo o minuscolo; cifre, punteggiatura, segni di valuta e spazi bianchi non si aggiungono al conteggio delle lettere.
Le parole sono token alfabetici, e una contrazione con apostrofo come don't conta come una sola parola anziché due frammenti. Le frasi sono unità chiuse da un punto, un punto interrogativo o un punto esclamativo. Se il brano non ha marca terminale, l’intero testo trimmato è trattato come una frase così entrambi i tassi restano definiti.
Parole più lunghe alzano L e spingono il grado verso l’alto. Interruzioni di frase più frequenti alzano S e tirano il grado verso il basso. Il risultato è già una stima di livello: un punteggio vicino a otto significa all’incirca l’ottavo anno, non una scala astratta di facilità da zero a cento.
Punteggi negativi o molto bassi corrispondono a materiale della scuola elementare iniziale; quelli a metà della decina stanno al livello universitario; valori ancora più alti sono etichettati graduate. Questa pagina è in concreto il calcolatore dell’indice Coleman-Liau, non una suite di leggibilità multi-metrica né uno stimatore di grado scolastico basato sulle sillabe.
Contratto di ingresso, conteggi verificabili ed errori di validazione
I brani senza parole alfabetiche, ad esempio solo cifre o punteggiatura, falliscono anch’essi perché L e S resterebbero indefiniti. Ingressi estremamente lunghi oltre il tetto di caratteri documentato vengono rifiutati anziché valutati in parte. Un breve brano da primo lettore, con parole corte e pause frequenti, si colloca vicino ai gradi bassi della scuola elementare.
La prosa accademica con token latini lunghi e pochi punti tende verso high school, college o graduate. La validazione fallita non viene addebitata. Fissi i campi arrotondati nei test così un successivo cambio di formulazione nel messaggio non nasconda una vera regressione della formula.
Dove un calcolatore Coleman-Liau dimostra il proprio valore
I team editoriali usano un calcolatore dell’indice Coleman-Liau quando la guida di stile nomina già quella formula, anziché un punteggio generico di leggibilità o un grado Flesch–Kincaid basato sulle sillabe. I programmi di linguaggio chiaro nella pubblica amministrazione, nella sanità e nella finanza citano spesso Coleman–Liau perché è economico da ricalcolare su ogni bozza e non dipende da un lessico di pronuncia che varierebbe secondo il dialetto.
I flussi di pubblicazione possono bloccare bozze di blog che superano un grado scelto senza pagare a token una riscrittura generativa quando serve solo un punteggio strutturale. Tratti l’euristica come approssimata fuori dall’inglese, non la usi come misura di esattezza fattuale, e ottiene un segnale di grado riproducibile per plugin LMS, dashboard editoriali e worker di bordo senza erigere un’infrastruttura linguistica propria.
Casi d'uso
Obiettivo editoriale di grado
Incolli una bozza e confermi che l’indice Coleman-Liau resti vicino all’anno che la Sua guida di stile nomina prima di pubblicare o stampare.
Controlli di politica del linguaggio chiaro
Valuti avvisi pubblici e articoli di aiuto così i team segnalano le bozze che superano la fascia media o superiore consentita.
Domande frequenti
Come si calcola l’indice Coleman-Liau?
Il risultato è un grado scolastico statunitense approssimativo.
In che cosa Coleman-Liau differisce da Flesch-Kincaid o Gunning Fog?
Coleman-Liau non conta mai le sillabe. Usa soltanto lettere, parole e frasi, per questo un computer può valutarlo senza un dizionario di pronuncia. Flesch-Kincaid e Gunning Fog dipendono da euristiche di sillaba o di parola complessa e rispondono a un’altra ricerca.
Il grado è esatto per ogni lettore?
No. È una stima strutturale approssimativa a partire dai tassi di lettere e di frasi. Non modella lessico raro, conoscenze pregresse né morfologia non inglese. Lo usi come segnale trasparente accanto alla revisione umana.
Che cosa significa un punteggio Coleman-Liau negativo?
Che il testo è molto semplice, da primi anni di scuola elementare. Tre frasi brevi su un gatto seduto su un tappeto danno −2,975, circa il grado −3, perché le parole sono corte e i punti arrivano spesso.
Come abbasso il grado del mio testo?
Usi parole più corte e divida le frasi lunghe. Le parole lunghe aumentano le lettere ogni 100 parole e spingono il grado verso l'alto, mentre punti più frequenti aumentano le frasi ogni 100 parole e lo abbassano.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/str/coleman-liau \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"The cat sat on the mat. It was a sunny day. Birds sang in the trees."}'const res = await fetch("https://api.kit.forhosting.com/str/coleman-liau", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "The cat sat on the mat. It was a sunny day. Birds sang in the trees."
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/str/coleman-liau",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "The cat sat on the mat. It was a sunny day. Birds sang in the trees."
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/coleman-liau", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"The cat sat on the mat. It was a sunny day. Birds sang in the trees."}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"The cat sat on the mat. It was a sunny day. Birds sang in the trees."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/coleman-liau", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"text": "The cat sat on the mat. It was a sunny day. Birds sang in the trees."
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "str.coleman_liau",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Il testo vuoto e le stringhe senza parole alfabetiche falliscono con invalid_input e non vengono addebitati.
Contratto di ingresso, conteggi verificabili ed errori di validazione
Invii per POST un corpo JSON con un campo stringa obbligatorio chiamato text: il brano inglese da valutare. Gli alias passage, content, body e input_text sono accettati per collegare moduli più vecchi. Il valore deve essere una stringa non vuota dopo il trim degli spazi; oggetti, array e stringhe vuote falliscono con invalid_input indicando il campo text. In caso di successo il corpo include letter_count, word_count e sentence_count per verificare i tre ingredienti; letters_per_100_words e sentences_per_100_words come L e S arrotondati per client stabili; coleman_liau_index come il punteggio continuo arrotondato; grade_level uguale a tale indice; grade_level_rounded come il grado intero più vicino; grade_band come tappa scolastica in snake_case, ad esempio elementary, middle_school, high_school, college o graduate; le stringhe formula e method che documentano l’identità; e un breve messaggio leggibile che riassume L, S e il grado stimato.
Dove un calcolatore Coleman-Liau dimostra il proprio valore
I gruppi di materiali didattici verificano che una scheda resti vicino all’anno previsto prima della stampa, poi memorizzano letter_count, word_count e sentence_count accanto all’indice così un revisore vede perché il grado si è mosso. Poiché questa capacità è parse di livello A, ogni chiamata riuscita costa il $0.002 pubblicato, senza token di modello né rete in uscita, il che rende accessibile la rivalutazione in blocco di un archivio CMS. La associ a un cruscotto di leggibilità multi-metrico o a uno stimatore di grado per sillabe quando quelli sono i termini realmente cercati; conservi questo endpoint quando la domanda di prodotto è in concreto Coleman–Liau da lettere, parole e frasi.
Casi di integrazione
Automazione CMS e pipeline
Chiami l’API da una pipeline di contenuto per etichettare i post con coleman_liau_index e grade_band senza eseguire un modello generativo.
Domande tecniche
Quale ingresso serve al calcolatore Coleman-Liau?
Invii una stringa inglese non vuota nel campo text (alias: passage, content, body, input_text). Stringhe vuote e testo senza parole alfabetiche falliscono con invalid_input e non vengono addebitati.
Quanto costa il calcolatore dell’indice Coleman-Liau?
Lo strumento del browser è gratuito. Le richieste API usano il saldo prepagato KIT a $0.002 per chiamata riuscita; un ingresso non valido non viene addebitato.