Dalla bibliografia di un paper a un dossier di citazioni
Un esempio completo con zlb e ZotPush, eseguito il 19 novembre 2026, intoppi compresi
Zotero, LLM, Markdown, bibliografia, politica industriale
1 Il punto di partenza
Il documento di partenza è un mio paper di settembre, che replica il Policy Brief 6/2026 del Luiss Lab of European Affairs sulle priorità della politica industriale [1], [2]. Ha una bibliografia di 20 voci: articoli, working paper, regolamenti europei e banche dati.
L’obiettivo dell’esempio è quello di chi riprende in mano un lavoro: avere in una raccolta Zotero tutte le fonti con il loro PDF, un BibTeX pulito, e i passi della fonte principale su cui il paper si appoggia, segnati nel PDF e raccolti in un file Markdown. Gli strumenti sono zlb 0.3.0 [3] e ZotPush MD 0.5.2 [4], presentati nel post precedente. Il ruolo dell’LLM lo ha svolto Claude, in un terminale.
2 Passo 1: dalla bibliografia al manifest
Delle 20 voci, 7 sono banche dati o siti (BACI-CEPII, OEC, Growth Lab, TiVA, ICIO, Strategic Trade Atlas, Registro Nazionale degli Aiuti): non c’è un PDF da mettere in Zotero e restano fuori. Le altre 13 diventano un manifest, un file JSON con titolo, autori, anno e, quando c’è, il DOI. A queste ho aggiunto due letture consigliate dall’LLM sul principio di relatedness, che è il cuore del metodo [5], [6].
Tre voci richiedono il giudizio dell’LLM prima ancora di zlb, perché in libreria non coincidono con la bibliografia: un articolo è presente come reprint con un DOI diverso, un documento della Commissione europea è presente due volte, un regolamento è presente con il titolo italiano. Per queste il manifest indica direttamente la chiave Zotero verificata. Un estratto:
{"id": "4", "citekey": "balland2022Paradigm", "type": "article",
"title": "The new paradigm of economic complexity", "year": "2022",
"doi": "10.1016/j.respol.2021.104450", "zotero_key": "PHPJWSQ9"},
{"id": "C1", "citekey": "li2022Relatedness", "type": "article",
"title": "Evaluating the principle of relatedness: Estimation, drivers and implications for policy",
"year": "2022", "pdf_url": "https://arxiv.org/pdf/2205.02942"}3 Passo 2: la raccolta e il BibTeX
zlb ensure-collection --name "zlb-esempio LEAP"
zlb apply --manifest references.json --collection "zlb-esempio LEAP" --output references.bibIl risultato finale:
| Esito | Voci | Che cosa significa |
|---|---|---|
| Già in libreria, aggiunte alla raccolta | 13 | zlb le trova per DOI, titolo o chiave e le collega alla raccolta, senza duplicare il PDF |
| Importata dal web | 1 | Li e Neffke 2022, scaricata da arXiv e importata con l’API locale |
| Non reperita | 1 | il Chips Act: il sito EUR-Lex risponde con una pagina di controllo anti-bot invece del PDF |
In parole semplici: 14 fonti su 15 sono in Zotero con il loro PDF; l’unica mancante finisce in cima al BibTeX, da recuperare a mano.
Il BibTeX comincia infatti così, senza chiavi o percorsi inventati:
% Missing PDFs (1)
@misc{eu2023ChipsAct,
author = {European Union},
title = {Regulation (EU) 2023/1781 establishing a framework of measures for strengthening Europe's semiconductor ecosystem (Chips Act)},
year = {2023},
}
% PDFs in Zotero (14)Le altre voci portano la chiave del PDF in Zotero e il suo percorso sul disco. Tutte le schede avevano già la citation key uguale alla chiave del PDF, quindi zlb non ha dovuto cambiarla.
3.1 Gli intoppi, così come sono andati
Il giro completo ha richiesto quattro esecuzioni di apply. Le racconto perché dicono molto su come lavora lo strumento.
Un doppione in libreria. Il paper di Fetzer e coautori sulle reti produttive [7] era in Zotero due volte. zlb non ha scelto a caso: si è fermato con «multiple matches; set zotero_key explicitly». La verifica preliminare dell’LLM lo aveva mancato; l’ha corretta indicando la chiave della copia più vecchia, e il doppione è rimasto da cancellare a mano, perché zlb non cancella nulla. Il difetto vero è un altro: un’ambiguità su una voce ferma l’intero giro senza produrre il report delle voci già fatte. È il prossimo punto da correggere in zlb.
Dopo questo giro l’LLM ha indicato la chiave verificata anche per altre quattro voci che zlb non aveva trovato da solo: due hanno in libreria un titolo diverso da quello della bibliografia; le altre due, fra cui una lettura consigliata, non sono emerse dalla ricerca anche se il titolo coincide.
Un tipo BibTeX non standard. Il manifest usava
report; zlb accetta solo i tipi standard e si è fermato prima di scrivere il BibTeX, dopo aver già importato il PDF nuovo. Contechreportil problema è sparito.Un timeout. L’API locale di Zotero non ha risposto entro due minuti, probabilmente perché nello stesso momento girava un altro comando sulla stessa libreria. Rilanciato da solo, il comando è andato a buon fine.
Un sito che rifiuta i programmi. EUR-Lex non consegna il PDF a un client automatico; zlb non aggira questi blocchi e segnala la voce come non reperita.
I giri ripetuti non fanno danni: zlb riconosce le voci già nella raccolta e non duplica i PDF. I tempi sono stati di 2-8 minuti per giro, perché per le voci senza chiave zlb cerca nell’intera libreria, testo dei PDF compreso.
3.2 I tag automatici
Per questo esempio i tag automatici erano accesi, con un massimo di 10. Il PDF importato, Li e Neffke 2022, ha ricevuto dieci tag, tutti scelti fra quelli già presenti nella libreria da un modello in esecuzione sul computer: industrial policy, RCA, trade, industries, Growth, country, analysis, Data, Framework, candidate. I primi sono pertinenti; gli ultimi tre sono generici e andrebbero tolti a mano. È il motivo per cui la funzione è spenta per default: richiede un LLM locale e il suo risultato va comunque riletto.
4 Passo 3: evidenziare i passi della fonte
La fonte principale è il Policy Brief. L’LLM ha individuato i cinque passi su cui il paper si appoggia e li ha scritti, parola per parola, in un secondo manifest con il numero di pagina. Prima l’anteprima, poi la scrittura:
zlb highlight --manifest passages_leap.json # anteprima
zlb highlight --manifest passages_leap.json --apply # crea le evidenziazioniL’anteprima ha trovato tutti e cinque i passi una sola volta nel PDF (exact: 5, ambiguous: 0, not-found: 0); la scrittura ha creato cinque evidenziazioni grigie con il tag zlb-citazione.
| Passo | Pagina | Che cosa sostiene nel paper |
|---|---|---|
| La prossimità come predittore dello sviluppo industriale1 | 4 | il metodo replicato |
| Distanza ridotta in macchinari e mezzi di trasporto, maggiore in chimica e metalli di base | 6 | il confronto per macrosettori |
| Prossimità ai prodotti NZIA, distanza dai semiconduttori2 | 7 | il risultato principale confermato dalla replica |
| Definizione delle «opportunità produttive»3 | 8 | la classificazione in quadranti |
| Definizione della misura di dipendenza commerciale | 8 (nota 7) | la scelta della misura |
In parole semplici: ogni riga è un passo del Policy Brief ora evidenziato in Zotero, con la pagina stampata e la parte del paper che lo usa.
L’ultimo passo merita una parola. Il brief definisce la dipendenza come rapporto fra la differenza tra importazioni ed esportazioni e la loro somma. Il paper usa la stessa misura «riscalato nell’intervallo unitario: valori sopra 0,5 indicano dipendenza netta dalle importazioni» (p. 2), con il rimando al working paper del 2025 degli stessi autori [8]. Avere la definizione originale evidenziata accanto a quella usata rende la scelta controllabile da chiunque riapra il PDF.
5 Passo 4: il dossier in Markdown
L’ultimo passo è in Zotero: seleziono tutte le schede della raccolta, clic destro, Push evidenze filtrate in Markdown…, filtro tag:zlb-citazione. ZotPush scarta le fonti senza evidenze e produce un solo file, Evidenze Zotero - tag-zlb-citazione.md, con una fonte e cinque evidenze. Ecco l’inizio:
## Le priorità della politica industriale
Citation key: `YST2S4T7` — Chiave Zotero: `CZDUNWAB`
### highlight — p. 4
Colore Zotero: `#aaaaaa`
> la prossimità tra settori costituisce il principale predittore delle traiettorie di sviluppo industriale.
zlb highlight:d898ba9ec50e6393 — Volterra, Politica industriale e diversificazione produttiva in Italia, DOI 10.5281/zenodo.22803987 — metodo-prossimita
Tag: #zlb-citazione
[Apri in Zotero](<zotero://open-pdf/library/items/YST2S4T7?page=4&annotation=6QBHN9UD>)Tre dettagli si vedono bene. La citation key è la chiave del PDF, impostata da zlb. Il commento dell’evidenza dice da quale documento e da quale voce del manifest viene: chi la ritrova fra sei mesi sa perché è lì. Il link riapre il PDF esattamente su quell’evidenziazione.
L’esempio ha mostrato anche un piccolo difetto di ZotPush: il frontmatter YAML del dossier esce con una riga vuota fra un campo e l’altro. Resta YAML valido, ma andrà sistemato nella prossima versione.
6 Che cosa resta all’autore
Lo strumento ha fatto le parti meccaniche: cercare, collegare, scaricare, scrivere il BibTeX, trovare le frasi nel PDF. Le decisioni sono rimaste a chi scrive: quali voci della bibliografia sono documenti, quale copia del doppione tenere, quali passi contano davvero, quali tag automatici togliere, come recuperare il regolamento che il sito non consegna. È la divisione dei compiti per cui i due strumenti sono stati costruiti.
Nota metodologica
Questo documento nasce dall’interazione di tre componenti. L’autore definisce le domande, esercita il giudizio critico e assume la responsabilità scientifica ed editoriale del risultato. Strumenti di intelligenza artificiale generativa sono impiegati a supporto della ricerca bibliografica, della lettura, della sintesi, della riorganizzazione argomentativa e della revisione del testo. Un’infrastruttura open source sviluppata dall’autore automatizza il reperimento, l’armonizzazione e il controllo dei dati dalle fonti statistiche ufficiali, e mantiene l’elaborazione documentata e riproducibile.
Le fonti sono pubblicamente accessibili e citate con la loro denominazione ufficiale; l’analisi è pertanto integralmente auditabile e replicabile da terzi a partire da esse. Le tabelle e i grafici sono elaborazioni dell’autore: calcoli, aggregazioni, trasformazioni e scelte di rappresentazione sono attribuibili all’autore e non agli enti produttori dei dati.
La responsabilità per le fonti utilizzate, le analisi condotte, le elaborazioni effettuate, le interpretazioni proposte e le conclusioni formulate resta interamente in capo all’autore. L’intelligenza artificiale è stata impiegata come ambiente di supporto cognitivo ed editoriale, non come fonte primaria, autore autonomo o sostituto del giudizio critico.
Riferimenti
Note
«la prossimità tra settori costituisce il principale predittore delle traiettorie di sviluppo industriale» [2, p. 4].↩︎
«i settori italiani dei macchinari e dei componenti elettronici mostrano un’elevata prossimità ai prodotti NZIA, ma una distanza significativa rispetto a quelli destinati alla produzione di semiconduttori» [2, p. 7].↩︎
«Questi sono i prodotti che si trovano vicini alla struttura produttiva italiana e che hanno un’elevata complessità e quindi un potenziale per la crescita economica più elevato» [2, p. 8].↩︎
Vedi anche
- zlb e ZotPush: la ricerca dentro e fuori da Zoterozlb è un comando da terminale che permette a un LLM di lavorare sulla libreria Zotero sotto il controllo dell’utente; ZotPush MD è un plugin che esporta riferimenti ed evidenze in Markdown senza mai scrivere nella librer
- Structured Evidence Inference: un metodo grounded per l’analisi di documentazione istituzionaleThis paper introduces structured evidence inference , a pipeline methodology for transforming heterogeneous institutional policy documentation into a multi-layer, computationally auditable evidence structure.
- ChatGPT & Reverse EngineeringRicavare i valori di un grafico da un’immagine con un LLM: come far lavorare in gruppo modello, OCR e Python.