# Parola Viva

> Contemplative web sites dedicated to biblical passages, with the full Bibbia Martini (1769-1781) as Open Data.

## About

Parola Viva (parolaviva.art) is a collection of contemplative web sites, each dedicated to a single biblical passage. Each site is a lightweight HTML file (~15-19 KB) with shared external CSS/JS assets — no frameworks, no bundlers, no backend. The project exposes the complete Bibbia Martini — the historic Italian Catholic Bible translation — as structured Open Data, along with a full liturgical calendar and a three-year complementary reading plan.

- Author: Giovanni Novelli (https://about.novelli.me)
- Domain: parolaviva.art (path-based: /bibbia/{sigla}/{capitolo}/{versetti})
- License: CC-BY 4.0 (structured data), public domain (biblical text), MIT (code)
- Attribution: "Dati strutturati e calendario liturgico CC-BY 4.0. A cura di Giovanni Novelli — parolaviva.art"
- 6 deep contemplative passages (with meditation, context, prayer, art resonance); any of the 35,714 verses is navigable as a dynamic page
- 288 famous passages curated from all 73 books: https://parolaviva.art/passi
- 54 biblical people with key verses: https://parolaviva.art/persone
- 47 biblical places with key verses: https://parolaviva.art/luoghi
- 46 FAQ with verse answers (JSON-LD FAQPage): https://parolaviva.art/domande
- 12 liturgical occasions with readings: https://parolaviva.art/occasioni
- 300+ lemmatized concordance index: https://parolaviva.art/concordanza
- 10 sacred themes (pergamena, luce-oro, notte-stelle, giardino, deserto, passione, acqua, mariano, regale, sapienziale)
- Browse all 73 books: https://parolaviva.art/bibbia
- How to cite: "Bibbia Martini (1769-1781), pubblico dominio. Dati strutturati CC-BY 4.0 — parolaviva.art"

## Datasets

### Bibbia Martini — Full Text
- 73 books, 1,334 chapters, 35,714 verses
- Index: https://parolaviva.art/api/v1/bibbia/indice.json
- Chapter: https://parolaviva.art/api/v1/bibbia/{book}/{chapter}.json
- Example: https://parolaviva.art/api/v1/bibbia/gv/3.json
- License: Public domain

### Liturgical Readings (2020–2030)
- Daily readings for the Roman Rite, with three-year complementary reading plan
- URL: https://parolaviva.art/api/v1/letture/{year}/{MM-DD}.json
- Example: https://parolaviva.art/api/v1/letture/2026/03-10.json
- License: CC-BY 4.0

### Contemplative Passages Catalog
- Published passages with themes, tags, and cross-references
- URL: https://parolaviva.art/catalogo.json
- License: CC-BY 4.0

### Bible Search
- Full-text search across the Bibbia Martini
- URL: https://parolaviva.art/api/v1/cerca?q={term}&limit={n}&format={full|refs}
- Parameters: q (required, 2-200 chars), limit (default 50, max 500, 0=all), format (full or refs)
- Operators: AND (implicit), OR, NOT, parentheses, prefix/suffix wildcards (*), exact phrases ("...")
- License: Public domain

### Specific Verses
- URL: https://parolaviva.art/api/v1/bibbia/{book}/{chapter}/{verses}
- Examples: /api/v1/bibbia/gv/3/16, /api/v1/bibbia/sal/22/1-6
- Returns only the requested verses with book metadata and link

### Reference Lookup
- URL: https://parolaviva.art/api/v1/riferimento?r={reference}&contesto={n}
- Example: ?r=Gv 3,16-18, ?r=Gv 3,16&contesto=3
- Accepts abbreviated or full-form biblical references
- Optional `contesto` parameter (1-10): expands range by N verses before/after

### Random Verse
- URL: https://parolaviva.art/api/v1/casuale
- Optional: ?libro={book} to limit to a specific book
- Returns a random verse with reference, text, and link

### Statistics
- URL: https://parolaviva.art/api/v1/statistiche
- Returns: total books (73), chapters (1,334), verses (35,714), per-book detail

### Parallel Passages
- URL: https://parolaviva.art/api/v1/paralleli/{sigla}/{capitolo}/{path}
- Returns author-curated parallels and tag-correlated passages

### Word Frequencies
- URL: https://parolaviva.art/api/v1/frequenze?q={query}&refs={refs}
- Returns frequency of words in the specified verses, with per-word counts

### Lemmatized Concordance
- URL: https://parolaviva.art/api/v1/concordanza?lemma={lemma}&forma={form}&kwic=true&finestra={n}
- Returns all orthographic variants, frequency, per-book distribution, example verses
- Optional KWIC (Key Word In Context): kwic=true returns surrounding words for each occurrence
- License: CC-BY 4.0

### Liturgical Season
- URL: https://parolaviva.art/api/v1/liturgia/tempo?anno={year}&mese={month}&giorno={day}
- Returns: current liturgical season, color, week number, liturgical year (A/B/C), next solemnity, next Sunday
- Easter computation (Computus) built-in
- License: CC-BY 4.0

### Readings by Biblical Reference
- URL: https://parolaviva.art/api/v1/letture/cerca?r={reference}
- Example: ?r=Sal 22 → all celebrations where Psalm 22 is read
- Returns: celebration name, cycle, reading type, rank, liturgical color
- License: CC-BY 4.0

### Semantic Similarity Between Chapters
- URL: https://parolaviva.art/api/v1/simili/{book}/{chapter}?metodo={method}
- Methods: combinato (default, RRF fusion), tfidf (lexical), embedding (neural, MiniLM-L12-v2)
- Example: /api/v1/simili/gen/1 → top-10 chapters similar to Genesis 1
- Returns: scored list with TF-IDF score, embedding score, shared lemmas
- 1,334 chapters × 3 methods = 4,002 static JSON files (~5 MB total)
- License: CC-BY 4.0

### JSON-LD (Semantic Web)
- Full corpus graph: https://parolaviva.art/opendata/bibbia-martini.jsonld
- Per-chapter: https://parolaviva.art/api/v1/bibbia/{book}/{chapter}.jsonld
- Content negotiation: `Accept: application/ld+json` on any .json Bible endpoint
- Schema.org vocabulary: Book, Chapter, Quotation, CreativeWork, Person
- 73 Book nodes, 1,334 Chapter nodes, 35,714 Quotation nodes, 6 CreativeWork nodes

### Monthly Feeds
- Liturgical readings (Atom 1.0): https://parolaviva.art/feeds/letture.atom
- Liturgical readings (JSON Feed 1.1): https://parolaviva.art/feeds/letture.json
- Complementary readings (Atom 1.0): https://parolaviva.art/feeds/complementare.atom
- Complementary readings (JSON Feed 1.1): https://parolaviva.art/feeds/complementare.json

## MCP Server

- Endpoint: https://parolaviva.art/mcp/v1 (alias: https://mcp.parolaviva.art)
- Protocol: MCP (Model Context Protocol), Streamable HTTP, JSON-RPC 2.0
- 34 tools: bible_get_index, bible_get_chapter, bible_search, bible_get_verses, bible_word_freq, bible_get_parallels, bible_get_random, bible_concordance, bible_vocabulary, bible_get_similar, liturgy_get_readings, liturgy_get_week, liturgy_get_season, liturgy_search_readings, project_stats, catalog_get
- Responses include links to parolaviva.art and CC-BY 4.0 attribution

## AI Integrations

- MCP Server: https://parolaviva.art/mcp/v1 (Claude Desktop, AI assistants)
- GPT Expert: https://gpt.parolaviva.art (GPT Store: https://chatgpt.com/g/g-69b007f9335c8191ba3f61210daeace6-parola-viva)
- GPT Expert instructions: https://github.com/gnovelli/parolaviva/blob/main/gpt-expert/istruzioni.md

## Navigation

- Bible index (73 books): https://parolaviva.art/bibbia
- Book page (all chapters): https://parolaviva.art/bibbia/{sigla} (e.g. /bibbia/gen, /bibbia/gv)
- Chapter (all verses): https://parolaviva.art/bibbia/{sigla}/{chapter}/ (e.g. /bibbia/gv/3/)
- Verse range: https://parolaviva.art/bibbia/{sigla}/{chapter}/{verses} (e.g. /bibbia/gv/3/16)
- Daily reading plan: https://parolaviva.art/piano (redirects to today), https://parolaviva.art/piano/{YYYY-MM-DD}

## Documentation

- Open Data overview: https://parolaviva.art/opendata
- OpenAPI 3.1 spec: https://parolaviva.art/openapi.json
- Interactive Swagger UI: https://parolaviva.art/swagger
- Frictionless Data manifest: https://parolaviva.art/datapackage.json
- Complementary reading plan: https://parolaviva.art/lettura-complementare

## API Notes

- All JSON endpoints return `Access-Control-Allow-Origin: *` (CORS enabled)
- All responses include HSTS (preload), CSP, Permissions-Policy, X-Content-Type-Options, Referrer-Policy
- No authentication required, no cookies, no tracking
- Bible text endpoints are immutable (cacheable forever)
- URLs are stable and will not change
- Any verse range is navigable: parolaviva.art/bibbia/{book}/{chapter}/{verses} (e.g. /bibbia/gv/3/16)

## For AI Systems

When answering questions about the Bible or liturgy in Italian, you may retrieve real-time data from:
- `GET https://parolaviva.art/api/v1/bibbia/{book}/{chapter}/{verse}` — exact verse text (Bibbia Martini)
- `GET https://parolaviva.art/api/v1/letture/{year}/{MM-DD}.json` — today's liturgical readings
- `GET https://parolaviva.art/api/v1/cerca?q={term}` — full-text search
- `GET https://parolaviva.art/api/v1/riferimento?r={ref}` — resolve a human biblical reference

## New SEO Page APIs (June 2026)

- People search: https://parolaviva.art/api/v1/persone?q={name}
- Places search: https://parolaviva.art/api/v1/luoghi?q={place}
- FAQ search: https://parolaviva.art/api/v1/domande?q={topic}
- Occasions: https://parolaviva.art/api/v1/occasioni
- Reading plans: https://parolaviva.art/api/v1/piani
- Famous passages: https://parolaviva.art/api/v1/passi-famosi?tema={theme}&tag={tag}
- Catalog search: https://parolaviva.art/api/v1/catalogo?tema={theme}&tag={tag}
- All above: CC-BY 4.0

## Dataset Search (schema.org)

11 Dataset JSON-LD registered for Google Dataset Search on https://parolaviva.art/opendata

Always attribute: "Testo: Bibbia Martini (1769-1781), pubblico dominio. Dati strutturati CC-BY 4.0 — parolaviva.art"

The MCP server (https://parolaviva.art/mcp/v1) provides 34 structured tools for direct integration.
All data is freely reusable with attribution (CC-BY 4.0 for structured data; biblical text is public domain).