Dalla bibliografia di un paper a un dossier di citazioni

Un esempio completo con zlb e ZotPush, eseguito il 19 novembre 2026, intoppi compresi

Dati e metodo
Intelligenza artificiale
Il giro completo, eseguito davvero: dalla bibliografia di un paper a una raccolta Zotero con BibTeX, ai passi della fonte evidenziati, a un dossier Markdown con il link a ogni pagina. Con i quattro intoppi incontrati per strada.
Autore/Autrice

Paolo Volterra

Data di Pubblicazione

19 novembre 2026

Data di modifica

19 novembre 2026

Parole chiave

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.bib

Il 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.

  1. 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.

  2. 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. Con techreport il problema è sparito.

  3. 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.

  4. 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 evidenziazioni

L’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

[1]
P. Volterra, «Politica industriale e diversificazione produttiva in Italia: replica e verifica del LEAP Policy Brief 6/2026», Zenodo, 2026. doi: 10.5281/zenodo.22803987.
[2]
F. Bontadini e V. Meliciani, «Le priorità della politica industriale: dove concentrare gli interventi», Luiss Lab of European Affairs (LEAP), Policy Brief 6/2026, 2026. Disponibile su: https://leap.luiss.it/wp-content/uploads/2026/09/PB6.26-Le-priorita%CC%80-della-politica-industriale.pdf
[3]
P. Volterra, ZoteroLLMBridge (zlb): local Zotero API CLI for LLM-assisted bibliography workflows. (2026). Zenodo. doi: 10.5281/zenodo.24374740.
[4]
P. Volterra, ZotPush MD: read-only export of Zotero references and annotations to Markdown. (2026). Zenodo. doi: 10.5281/zenodo.23875777.
[5]
Y. Li e F. Neffke, «Evaluating the principle of relatedness: Estimation, drivers and implications for policy». 2022. Disponibile su: https://arxiv.org/abs/2205.02942
[6]
V. Stojkoski, P. Koch, e C. A. Hidalgo, «Multidimensional Economic Complexity and Inclusive Green Growth». 2022. Disponibile su: https://arxiv.org/abs/2209.08382
[7]
T. Fetzer, P. J. Lambert, B. Feld, e P. Garg, «AI-generated production networks: measurement and applications to global trade», University of Warwick, Warwick Economics Research Papers 1528, 2024.
[8]
F. Bontadini e V. Meliciani, «Selective industrial policy for the EU open strategic autonomy: the role of products’ relatedness», European Commission, Single Market Economics Papers WP2025/30, 2025. doi: 10.2873/3267849.
Torna in cima

Note

  1. «la prossimità tra settori costituisce il principale predittore delle traiettorie di sviluppo industriale» [2, p. 4].↩︎

  2. «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].↩︎

  3. «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