Open Data

Parola Viva espone come Open Data il testo integrale della Bibbia Martini e il calendario liturgico del Rito Romano. Tutti i dati sono disponibili come file JSON statici, liberamente accessibili via HTTP, senza autenticazione.

Endpoint API

Base URL: https://parolaviva.art

Tutti gli endpoint JSON includono l’header Access-Control-Allow-Origin: * (CORS abilitato). Tutte le risposte includono header di sicurezza: HSTS (preload), Content-Security-Policy, Permissions-Policy, X-Content-Type-Options, Referrer-Policy. Nessun cookie, nessun tracciamento.

Testo biblico

Indice dei libri

curl https://parolaviva.art/api/v1/bibbia/indice.json

Restituisce un array di 73 libri:

[
  {"s": "gen", "n": "Genesi", "m": "Gen", "c": 50},
  {"s": "gv", "n": "Vangelo secondo Giovanni", "m": "Gv", "c": 21},
  ...
]

Capitolo

curl https://parolaviva.art/api/v1/bibbia/gv/3.json

{
  "l": "Gv",
  "n": "Vangelo secondo Giovanni",
  "c": 3,
  "v": [
    {"n": 1, "t": "Or v'era tra' Farisei un uomo..."},
    {"n": 2, "t": "Questi andò a trovar Gesù..."},
    ...
  ]
}

Letture liturgiche

curl https://parolaviva.art/api/v1/letture/2026/03-10.json

{
  "data": "2026-03-10",
  "rito": "romano",
  "celebrazione": "Martedì della III settimana di Quaresima",
  "colore": "viola",
  "rango": 9,
  "letture": {
    "prima": {"riferimento": "Dn 3,25.34-43", "testo": "..."},
    "salmo": {"riferimento": "Sal 24,4-5.6-7.8-9", "testo": "..."},
    "vangelo": {"riferimento": "Mt 18,21-35", "testo": "..."}
  },
  "complementare": {
    "riferimento": "Es 28,1-43",
    "anno_piano": "A",
    "giorno_piano": 119,
    "testo": "..."
  }
}

Ricerca avanzata

curl "https://parolaviva.art/api/v1/cerca?q=principio"

{
  "risultati": [
    {"riferimento": "Gv 1,1", "testo": "Nel principio era il Verbo..."},
    ...
  ],
  "totale": 12,
  "query": "principio"
}

Cerca nel testo della Bibbia Martini (da 2 a 200 caratteri). La ricerca è case-insensitive e ignora gli accenti.

Parametri

Esempio con parametri

# Solo riferimenti, massimo 10
curl "https://parolaviva.art/api/v1/cerca?q=principio&limit=10&format=refs"

# Risposta:
# {"risultati": ["Gv 1,1", "Gen 1,1", ...], "totale": 10, "query": "principio"}

Operatori booleani

Wildcard

Frasi esatte

curl "https://parolaviva.art/api/v1/cerca?q=\"nel+principio+era\""

Le virgolette delimitano una frase esatta: i termini devono comparire adiacenti e nell’ordine indicato.

Esempi combinati

# Parole che iniziano con «giust» insieme a «Dio»
curl "https://parolaviva.art/api/v1/cerca?q=giust*+AND+dio"

# «pace» o «gioia» nel contesto del «cuore»
curl "https://parolaviva.art/api/v1/cerca?q=(pace+OR+gioia)+AND+cuore"

Versetti specifici

# Singolo versetto
curl https://parolaviva.art/api/v1/bibbia/gv/3/16

# Range di versetti
curl https://parolaviva.art/api/v1/bibbia/sal/22/1-6

Restituisce solo i versetti richiesti di un capitolo, con metadati del libro e link alla pagina su parolaviva.art.

Riferimento biblico

curl "https://parolaviva.art/api/v1/riferimento?rif=Gv%203,16-18"

Accetta riferimenti nel formato abbreviato o esteso (es. Gv 3,16, Gen 1,1-5, Sal 22,1-6). Restituisce libro, capitolo, versetti e link.

Versetto casuale

# Da tutta la Bibbia
curl https://parolaviva.art/api/v1/casuale

# Solo dal Vangelo di Giovanni
curl "https://parolaviva.art/api/v1/casuale?libro=gv"

Restituisce un versetto casuale con riferimento, testo e link alla pagina su parolaviva.art.

Statistiche

curl https://parolaviva.art/api/v1/statistiche

Statistiche aggregate: totale libri (73), capitoli (1.334), versetti (35.714) e dettaglio per ogni libro (capitoli e versetti).

Paralleli

curl https://parolaviva.art/api/v1/paralleli/gv/3/16

Passi paralleli autoriali e correlati per tag a un passo contemplativo pubblicato su Parola Viva.

Frequenze parole

curl "https://parolaviva.art/api/v1/frequenze?parola=amore"

Frequenza di una parola nei 73 libri della Bibbia Martini, con totale complessivo e conteggio per libro.

Esempio JavaScript

// Leggi Giovanni 3
const cap = await fetch('https://parolaviva.art/api/v1/bibbia/gv/3.json')
  .then(r => r.json());
for (const v of cap.v) {
  console.log(`${cap.l} ${cap.c},${v.n} — ${v.t}`);
}

// Letture di oggi
const oggi = new Date();
const mm = String(oggi.getMonth()+1).padStart(2,'0');
const gg = String(oggi.getDate()).padStart(2,'0');
const letture = await fetch(
  `https://parolaviva.art/api/v1/letture/${oggi.getFullYear()}/${mm}-${gg}.json`
).then(r => r.json());
console.log(letture.celebrazione, '—', letture.colore);

Esempio Python

import requests

# Indice libri
indice = requests.get('https://parolaviva.art/api/v1/bibbia/indice.json').json()
for libro in indice:
    print(f"{libro['m']:8s} {libro['n']:40s} ({libro['c']} capitoli)")

# Genesi 1
gen1 = requests.get('https://parolaviva.art/api/v1/bibbia/gen/1.json').json()
for v in gen1['v']:
    print(f"  [{v['n']}] {v['t']}")

MCP Server

Parola Viva espone un server MCP (Model Context Protocol) che permette a Claude, ChatGPT e altri assistenti AI di accedere direttamente ai dati biblici e liturgici.

Tools disponibili (15)

Configurazione Claude Desktop

{
  "mcpServers": {
    "parola-viva": {
      "type": "url",
      "url": "https://mcp.parolaviva.art"
    }
  }
}

JSON-LD (Web Semantico)

Tutti i dati della Bibbia Martini sono disponibili anche in formato JSON-LD con vocabolario schema.org, per l’integrazione con grafi di conoscenza, motori di ricerca e triplestore.

Corpus completo

curl https://parolaviva.art/opendata/bibbia-martini.jsonld

Grafo completo: 73 libri (Book), 1.334 capitoli (Chapter), 6 passi contemplativi (CreativeWork) con relazioni semantiche (isPartOf, hasPart, relatedLink).

Per capitolo

# URL diretto
curl https://parolaviva.art/api/v1/bibbia/gv/3.jsonld

# Content negotiation
curl -H "Accept: application/ld+json" https://parolaviva.art/api/v1/bibbia/gv/3.json

Ogni capitolo con i versetti come Quotation (tipo, posizione, testo, riferimento, URL navigabile). I versetti che fanno parte di passi contemplativi includono un subjectOf con link alla meditazione.

Tipi schema.org utilizzati

Numeri

• 73 libri della Bibbia Martini (canone cattolico)
• 1.334 capitoli
• 35.714 versetti
• 5 anni di letture liturgiche (2026–2030)
• 293 letture complementari (piano triennale A/B/C — a cura di Giovanni Novelli)

Condizioni d’uso

• Testo biblico (Bibbia Martini, 1769–1781): pubblico dominio
• Dati strutturati, calendario liturgico e piano di lettura triennale: CC-BY 4.0 — a cura di Giovanni Novelli
• Meditazioni e contenuti contemplativi: © Giovanni Novelli, tutti i diritti riservati
• Codice sorgente: MIT

Il manifesto Frictionless Data è disponibile a /datapackage.json.

Documentazione interattiva

La specifica completa delle API è disponibile in formato OpenAPI 3.0 e come documentazione interattiva Swagger, dove è possibile esplorare e provare ogni endpoint direttamente dal browser.

GPT Expert

È disponibile nel GPT Store il GPT Expert Parola Viva (link diretto), un assistente conversazionale che si appoggia a queste API per esplorare il testo della Bibbia Martini, le letture liturgiche e i passi contemplativi pubblicati.

Retrocompatibilità

Lo sviluppo delle API si ispira al principio della retrocompatibilità: eventuali evoluzioni future mireranno a preservare il funzionamento delle integrazioni esistenti. Qualora si rendessero necessarie modifiche incompatibili, le nuove versioni saranno esposte sotto un prefisso separato (es. /api/v2/), mantenendo gli endpoint attuali disponibili per un congruo periodo di transizione.

Disponibilità del servizio

Le API sono messe a disposizione a titolo gratuito, senza garanzie di continuità. L’autore si riserva il diritto di sospendere, modificare o dismettere gli endpoint in qualsiasi momento e senza preavviso, così come di prevederne in futuro la disponibilità in forme non onerose per il medesimo.

L’autore non risponde di errori, omissioni o inesattezze nei dati forniti. L’utilizzo avviene sotto la esclusiva responsabilità dell’utente. Per qualsiasi controversia è competente il Foro di Catania.