TarotSchema

v1.0 — Open Schema

The canonical schema for divinatory systems

TarotSchema is a structured, machine-readable reference covering tarot decks, oracle systems, and reading spreads across the Tarotsmith divination network. Built for AI developers, semantic crawlers, ontology builders, and researchers working with divinatory data.

Browse Schema Files View on GitHub

Schema Files

Spreads

spreads-schema.json

Every spread available across the network, with position definitions, instructions, layout images, and per-deck reading URLs. The full operational map of the reading infrastructure.

Covers all spread types — Single Card through Celtic Cross and beyond Includes position-level meaning definitions Links to live reading URLs per deck per spread
tarotschema.com/spreads-schema.json tarotsmith.com/spreads-schema.json GitHub HuggingFace

Tarot Decks

decks-schema.json

All tarot decks in the network with complete card-level data. Each card carries its upright and reversed meanings, image references, and canonical URL. Structured as DefinedTermSet containing DefinedTerm entries per the Schema.org vocabulary.

15 decks — Thoth, Rider-Waite, Marseille, Visconti-Sforza, Wirth, Bifrost, Surrealist, and more 1,428 card entries across the full corpus Covers tarotsmith.com, occulttarot.com, tarotica.com
tarotschema.com/decks-schema.json tarotsmith.com/decks-schema.json GitHub HuggingFace

Oracles

oracles-schema.json

All non-tarot oracle systems that use the spread infrastructure. Runes, Ogham, Lenormand, Mahjong, Playing Cards, Mo Dominoes — each with full object-level meaning data, upright and reversed where applicable.

6 oracle systems 284 objects with full meaning definitions Ogham includes blocked/reversed name variants
tarotschema.com/oracles-schema.json tarotsmith.com/oracles-schema.json GitHub HuggingFace

Sample Structure — decks-schema.json

// DefinedTermSet per deck → DefinedTerm per card
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type":        "DefinedTermSet",
      "name":         "Book of Thoth",
      "url":          "https://tarotsmith.com/book-of-thoth/",
      "inLanguage":   "en",
      "hasDefinedTerm": [
        {
          "@type":              "DefinedTerm",
          "name":              "The Magus",
          "inDefinedTermSet":  "Book of Thoth",
          "url":               "https://tarotsmith.com/book-of-thoth/the-magus/",
          "description":      "Mercury. Drive, willpower, skill, wisdom...",
          "additionalProperty": {
            "@type": "PropertyValue",
            "name":  "reversedMeaning",
            "value": "..."
          },
          "image":      "01.jpg",
          "thumbnailUrl": "01r.jpg"
        }
        // ... 77 more cards
      ]
    }
    // ... 14 more decks
  ]
}

Who This Is For

AI Developers

Ground your divination bots and LLM prompts in a complete, structured reference. Deck structures, spread logic, and card meanings in a single ingestible corpus.

Prompt Engineers

Train models to understand the structural difference between a Cross spread and an Ankh spread, between a Lenormand and a Marseille tradition.

Semantic Crawlers

Schema.org-conformant structured data with canonical URLs across the network. DefinedTermSet vocabulary for controlled vocabularies and knowledge graphs.

Ontology Builders

Divination systems modelled as semantic networks. Card meanings, positional logic, deck traditions, and cross-system correspondence built into the structure.

Tarot Artists

Understand the schema that governs how decks are integrated into a live reading network. Submit a pull request to have your deck included.

Archivists

A permanent, open, versioned record of how these divinatory systems are structured and deployed — available on GitHub and HuggingFace.

The Tarotsmith Network

TarotSchema is maintained by Tarotsmith, which has operated free online tarot readings since before the 2013 algorithm era. The schema reflects a live network of deck-specific reading sites, each with its own tradition and audience.

Decks and oracles that appear in multiple domains carry separate entries per domain, reflecting the distinct card descriptions, imagery, and URL structures maintained on each site.

MIT License — Schema Structure

All JSON structure and schema definitions are released under the MIT License. Free to use in any context, commercial or otherwise, without restriction.

CC-BY 4.0 — Written Content

All written descriptions and narrative content carry Creative Commons Attribution 4.0. Credit Tarotsmith / TarotSchema when using in apps, datasets, or publications. Card meanings copyright their respective artists and authors. Spread instructions copyright Tarotsmith.