Verifichi nomi immagine descrittivi e separati da trattini
Sappia prima di pubblicarla se il nome di un'immagine aiuta: red-running-shoes-side-view.jpg passa, mentre untitled.webp viene segnalato come generico. Ogni problema è indicato a parte, da spazi e trattini bassi a maiuscole o trattini doppi, e nessuna immagine viene inviata. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Nome del file
- red-running-shoes-side-view.jpg
- Nome senza estensione
- red-running-shoes-side-view
- Estensione
- jpg
Un buon nome di file offre alle persone, ai team editoriali e ai motori di ricerca un indizio chiaro prima che l’immagine venga aperta. Questo strumento analizza un nome in pochi secondi, individua schemi generici di fotocamere ed esportazioni, controlla la separazione con trattini e segnala ogni problema singolarmente. Il controllo è deterministico, privato e non richiede il caricamento dell’immagine.
Che cosa rende descrittivo un nome immagine
Un nome descrittivo identifica il soggetto visibile o il contesto utile della risorsa, invece di conservare un contatore della fotocamera o un’etichetta provvisoria di esportazione. Per esempio, scarpe-rosse-vista-laterale.jpg offre un’indicazione concreta, mentre IMG_1234.jpg, screenshot-2026-01-12.png e untitled.webp non lo fanno. Il controllo usa un elenco prudente di parole generiche e schemi numerati comuni.
Non interpreta i pixel, quindi non può confermare che la descrizione sia fedele né scegliere le parole chiave ideali. Questo limite consente di eseguire una regola deterministica in un modulo di caricamento, ottenendo sempre la stessa risposta senza trasmettere l’immagine. Se viene segnalato un nome generico, Lei lo sostituisca con una breve espressione che indichi davvero soggetto, variante, angolazione, luogo o funzione.
Eviti l’accumulo di parole chiave: una descrizione naturale e specifica è più utile di una lunga sequenza ripetitiva.
Perché trattini ed estensione sono controllati separatamente
La prova di formato richiede lettere minuscole e cifre organizzate in segmenti separati da un solo trattino. Spazi, trattini bassi, maiuscole, punteggiatura, trattini iniziali, finali o ripetuti causano un esito negativo. Una radice descrittiva di una sola parola può essere valida perché non contiene termini da separare.
L’estensione è obbligatoria: stabilisce senza ambiguità il confine tra radice descrittiva e formato. La sua assenza genera pertanto un errore di input, non un normale risultato SEO negativo. Ogni richiesta valida possiede radice ed estensione; gli indicatori comunicano poi se la radice è descrittiva e ben formata.
Nell’output l’estensione diventa minuscola e, in caso di errore, compare un suggerimento deterministico. Lo consideri un aiuto alla formattazione, non una descrizione automatica. Se la radice originale è generica, la sostituisca con parole fondate sul contenuto reale prima di pubblicare.
Inserire il risultato nel flusso di pubblicazione
Esegua il controllo quando una risorsa entra nel Suo CMS, catalogo prodotti, archivio digitale o repository di un sito statico. L’interfaccia può così spiegare se occorre riscrivere un nome generico, correggere i separatori o fare entrambe le cose. Nell’integrazione continua può bloccare i nuovi file non validi e revisionare gradualmente quelli esistenti.
Viene accettato solo il nome, non un percorso, affinché le cartelle non influenzino il giudizio e i risultati restino coerenti fra sistemi operativi. Non viene effettuata alcuna richiesta di rete e non si leggono byte dell’immagine. Conservi i codici nell’audit se serve tracciabilità e ripeta la verifica dopo la rinomina per confermare una regola uniforme.
Casi d'uso
Proteggere i caricamenti nel CMS
Avvisi la redazione quando una risorsa conserva un nome da fotocamera o usa spazi e trattini bassi.
Applicare le regole del repository
Controlli i nomi durante la build e mostri codici stabili prima della pubblicazione.
Riordinare un archivio multimediale
Valuti con coerenza i nomi esportati prima di pianificare una rinomina batch controllata.
Domande frequenti
Quanto costa il controllo?
L’algoritmo non utilizza la rete né modelli di IA.
Perché l’estensione è obbligatoria?
Definisce un confine inequivocabile tra radice descrittiva e formato. Se manca, l’input è considerato non valido.
Un risultato valido garantisce un posizionamento migliore?
No. Conferma una convenzione, non le prestazioni di ricerca. Contano anche pertinenza, contesto, testo alternativo e qualità.
Sono ammessi i trattini bassi come separatori?
No. Separi le parole con un solo trattino. Trattini bassi, spazi e trattini ripetuti non superano il controllo.
L’immagine viene esaminata o caricata?
No. Il servizio riceve soltanto il nome del file ed esegue controlli locali deterministici.
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/seo/image-filename-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"filename":"red-running-shoes-side-view.jpg"}'const res = await fetch("https://api.kit.forhosting.com/seo/image-filename-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"filename": "red-running-shoes-side-view.jpg"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/seo/image-filename-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"filename": "red-running-shoes-side-view.jpg"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/image-filename-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"filename":"red-running-shoes-side-view.jpg"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"filename":"red-running-shoes-side-view.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/image-filename-check", 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
{
"filename": "red-running-shoes-side-view.jpg"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "seo.image_filename_check",
"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
Inserisca il nome completo di estensione per ricevere un risultato JSON stabile, adatto a moduli CMS, flussi di caricamento, liste editoriali o script batch.
Inserire il risultato nel flusso di pubblicazione
Il risultato distingue descriptive da hyphen_separated, li riunisce in valid e restituisce codici di problema stabili. Ogni controllo tramite API costa $0.002.