Cos'è e perché conta
Quando qualcuno chiede a ChatGPT «qual è la migliore app per…?», la risposta fa qualche nome e spesso cita dei siti come fonte. Se il tuo nome non c'è, chi legge non ti vede. E tu non lo sai, perché nessuno te lo dice.
Limelit Open serve a misurarlo. Gli dai il tuo sito e fino a cinque rivali, e lui fa a ChatGPT, Claude, Perplexity e Gemini le domande di un cliente, attraverso le loro API e con la ricerca web accesa. Poi conta quante volte esci tu e quante i rivali, in che posizione, e quali siti vengono citati. Tutto in una dashboard sul tuo computer, che puoi interrogare da Claude Code.
Due cose da sapere subito. È un progetto open source di terzi, non mio, con licenza Apache-2.0. Ed è ancora in pre-release, cioè in prova: non c'è una versione finale. È per chi ha un'app, un SaaS o un sito: indie hacker, founder da soli, vibecoder.
1. Cosa misura, e cosa no
Ogni giro salva le risposte intere e ci cerca il tuo nome e quelli dei rivali con una semplice ricerca di testo: nessun modello decide cosa ha visto, quindi ogni numero si ricontrolla a mano. I numeri:
- Visibilità: la quota di risposte che ti nominano.
- Quota di voce (share of voice): le tue menzioni sul totale di quelle dei brand che segui.
- Posizione: il posto medio in cui compari quando la risposta è un elenco.
- Quota di citazioni: quante fonti citate sono il tuo sito. Ogni sito citato è classificato: tuo, di un rivale, social, informativo, altro.
- Le ricerche che il motore ha fatto prima di rispondere, che spesso non sono la domanda che hai fatto tu.
Ogni numero dice su quante risposte si basa (n), e sotto le 20 la dashboard te lo segnala. Le domande che nominano il tuo brand restano fuori dal numero principale: misurerebbero solo la domanda.
Il limite più importante
Le risposte arrivano dalle API dei modelli, con la ricerca web accesa, e non sono identiche a quelle che vede una persona nell'app di ChatGPT: il README lo dice chiaro. Per misurare quello che vede la gente servono gli scraper, servizi a pagamento che leggono la pagina come un utente. Lo stesso per AI Overview e AI Mode di Google e per Copilot di Bing, che un'API non ce l'hanno: o uno scraper, o la versione ospitata di Limelit. Prendi i numeri come una direzione.
2. Installalo e fai il primo giro
Gira su Mac o Linux, è un file solo, e si crea da solo il suo database SQLite. Non serve installare niente prima. Apri il Terminale e incolla:
mkdir -p ~/limelit && cd ~/limelit curl -fsSL https://github.com/limelit-co/open/releases/latest/download/limelit_$(uname -s | tr A-Z a-z)_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz | tar xz limelit ./limelit serve
- Apri http://localhost:1515 nel browser. Il Terminale stampa anche le righe pronte per collegare Claude Code, con i tuoi percorsi.
- La procedura guidata ti chiede il dominio, poi la categoria, cioè la frase che userebbe un cliente (per esempio «app per imparare le lingue»), e fino a cinque rivali.
- Ti propone le domande di partenza, in inglese. Togli quelle che un tuo cliente non farebbe mai e sotto aggiungi le tue, una per riga, anche in italiano.
- Ultimo passo: una chiave per arrivare ai motori. Le strade sono due, le trovi nel capitolo 3.
- Premi Run: prima di quel bottone non si spende niente. Le risposte arrivano di solito entro un minuto.
Il mio consiglio: le domande contano più di tutto il resto. Scrivile come le scriverebbe un cliente che non ti conosce: cosa vuole fare, per chi, con quale vincolo. Una base da adattare:
Qual è la migliore app per [cosa fa la tua app]? Che app mi consigli per [problema] se [vincolo, per esempio: ho poco tempo]? C'è un'app gratuita per [cosa fa la tua app]? Alternative a [rivale]? Come scelgo un'app per [cosa fa la tua app]?
3. La chiave: gratuita o le tue
Il wizard ti chiede una chiave, cioè il codice per usare le API dei motori. Due strade:
- La chiave gratuita. Accedi con Google a Limelit Cloud, crei la chiave e la incolli nel wizard (o lanci limelit login). Arriva a ChatGPT, Gemini, Perplexity e ad AI Overview e AI Mode di Google, dentro una quota mensile gratuita. Ma le tue domande passano dai server di Limelit Cloud per arrivare ai motori; le risposte restano da te.
- Le tue chiavi. La più rapida è quella di OpenAI, che apre ChatGPT; per Claude serve quella di Anthropic. In Settings trovi ogni fornitore con il link alla pagina dove si crea la chiave. Paghi i fornitori direttamente, alle loro tariffe: il progetto non aggiunge costi suoi.
Con le tue chiavi c'è un tetto, runs_per_day, che cambi in Settings: un giro che lo supererebbe viene rifiutato prima di spendere. Limelit conta anche chiamate e token per motore e per giorno.
Se lasci limelit serve acceso, ripete il giro da solo ogni giorno o ogni ora: così vedi chi vince giorno per giorno.
4. Collegalo a Claude Code
Limelit Open ha un server MCP, cioè una porta che permette a Claude di leggere i tuoi dati e risponderti a parole, con gli stessi numeri della dashboard. Nel Terminale:
claude mcp add limelit -s user -- sh -c 'cd ~/limelit && exec ./limelit mcp'
-s user lo rende disponibile in tutti i tuoi progetti. Deve partire da ~/limelit per leggere lo stesso database della dashboard: avviato altrove ne apre uno vuoto. Poi apri una sessione nuova di Claude Code e scrivi /mcp: limelit deve risultare collegato.
Non devi conoscere i nomi degli strumenti. Parti da qui:
Iniziamo con Limelit: a che punto è la mia installazione e cosa devo fare adesso?
Claude ti dice a che punto sei e cosa fare dopo. Può anche lanciare un giro: prima ti mostra il piano, e parte solo quando dici sì.
Oppure con il plugin
Il repository è anche un marketplace di plugin per Claude. In Claude Code scrivi:
/plugin marketplace add limelit-co/open /plugin install limelit-open@limelit
limelit-open collega la tua installazione con la skill limelit-open-visibility-report. C'è anche limelit-audit, senza installazione né account: ai-crawler-check ti dice quali crawler delle AI il tuo robots.txt lascia entrare, llms-txt-check controlla il tuo llms.txt. Possono mandare il dominio al controllo gratuito di Limelit.
5. Le domande da fare a Claude Code
Una volta collegato, queste sono le domande che ti consiglio. Cambia le parti tra [ ] con le tue.
Su quali domande sto perdendo? Per ognuna dimmi quale rivale viene nominato al posto mio, su quale motore, e su quante risposte si basa il numero.
Nelle risposte dove non compaio, quali siti vengono citati? Dammi gli indirizzi precisi delle pagine, in ordine di quante volte sono citate.
Per la domanda «[domanda]», quali ricerche ha fatto il motore prima di rispondere? Che parole usa che io sul mio sito non uso?
Confrontami con [rivale]: su quali domande vince lui, su quali io, e quali siti citano le risposte che vince lui. Se il campione è piccolo, dimmelo prima di trarre conclusioni.
6. Cosa fare con i risultati
Questi sono consigli miei, non funzioni di Limelit: lui misura, il lavoro lo fai tu.
- Entra nelle pagine citate. Se le risposte citano sempre la stessa classifica «le migliori app per…», quella pagina conta più del tuo sito: scrivi a chi la cura e presenta la tua app.
- Scrivi la pagina che risponde alla domanda. Se perdi su «c'è un'app gratuita per…?», fai una pagina che risponde proprio a quello, con fatti precisi.
- Fai una pagina di confronto onesta. Per «alternative a [rivale]», spiega quando conviene scegliere te e quando no.
- Usa le parole del motore. Se le sue ricerche usano parole diverse dalle tue, mettile nei titoli delle tue pagine.
- Rimisura dopo qualche settimana, non dopo un giorno: le risposte cambiano anche da sole.
Gli errori più comuni
- Riempire la lista di domande che nominano il tuo brand. Servono domande da cliente che non ti conosce.
- Trarre conclusioni da pochi giri. Guarda n: sotto le 20 risposte è un campione piccolo, non un trend.
- Dimenticare che con la chiave gratuita le domande passano da Limelit Cloud. Se non ti va bene, usa le tue chiavi.
Checklist
- limelit serve è acceso e la dashboard si apre su localhost:1515
- Le domande sono da cliente, e ho aggiunto le mie nella mia lingua
- Ho scelto la chiave: quella gratuita (passa da Limelit Cloud) o le mie
- Ho controllato runs_per_day prima di attivare il giro automatico
- In Claude Code, /mcp mostra limelit collegato
Domande frequenti
Limelit Open è gratis?
Il progetto sì: open source, senza prezzi o crediti suoi. Le risposte le paghi ai fornitori con le tue chiavi, oppure usi la quota mensile gratuita di Limelit Cloud. Gli scraper sono servizi a pagamento a parte.
I miei dati escono dal computer?
Solo il testo delle domande, nelle chiamate ai motori e agli scraper che configuri, e attraverso Limelit Cloud se usi la chiave gratuita. Risposte, menzioni, citazioni e consumi restano nel tuo file SQLite.
Posso seguire più app con una sola installazione?
Per ora no: un brand per installazione. Se hai più app, avvii più installazioni separate, ognuna nella sua cartella.