Tarotoo Tarot Card Meanings Dataset

一个完整的、结构化的78张塔罗牌（22张主牌和56张副牌）数据集，基于经典的莱德-韦特-史密斯传统，由Tarotoo发布。这些卡片含义是Tarotoo.com上AI生成解读的基础。A complete and structured dataset of 78 Tarot cards (22 Major Arcana and 56 Minor Arcana) is based on the classic Rider-Waite-Smith tradition and published by Tarotoo. The meanings of these cards serve as the foundation for AI-generated interpretations on Tarotoo.com.

原始信息汇总

数据集概述

Tarotoo Tarot Card Meanings Dataset 是一个完整、结构化的塔罗牌数据集，涵盖全部 78 张塔罗牌（22 张大阿尔卡纳 + 56 张小阿尔卡纳），基于经典的 Rider–Waite–Smith 传统体系。该数据集由 Tarotoo 发布，并用于支撑 Tarotoo.com 上 AI 生成的塔罗解读。

数据集内容与格式

数据集以多种格式提供，包含以下文件：

• data/cards.json — 权威数据集，包含 78 个牌对象的数组
• data/cards.jsonl — 每行一张牌（适用于 Hugging Face）
• data/cards.csv — 扁平 CSV 镜像
• data/src/ — 各花色源文件
• scripts/build.py — 合并、验证并重新生成产物的构建脚本
• packages/npm/ — npm 包（数据 + 查询辅助函数）
• packages/python/ — PyPI 包（数据 + 查询辅助函数）
• huggingface/ — Hugging Face 镜像的数据集卡片
• kaggle/ — Kaggle 镜像的元数据

数据字段结构

每张牌记录包含以下字段：

字段	类型	说明
id	int	稳定标识符，0–77（0–21 大阿尔卡纳，随后依次为权杖、圣杯、宝剑、星币）
name	string	牌名，如 "The Fool"、"Ace of Cups"
arcana	string	"major" 或 "minor"（大/小阿尔卡纳）
suit	string/null	大阿尔卡纳为 null；小阿尔卡纳为 "wands"、"cups"、"swords"、"pentacles"
number_numerology	int	数字命理编号（宫廷牌：Page=11, Knight=12, Queen=13, King=14）
element	string	经典元素关联
planet	string/null	行星关联（金色黎明体系；数字牌的十度行星）
zodiac	string/null	星座关联（星座、十度星座或宫廷牌元素星座）
yes_no	string	"yes"、"no" 或 "maybe" — 用于是/否解读
yes_no_reversed	string	逆位牌的 "yes"、"no" 或 "maybe" 值
keywords_upright	string[]	4–5 个正位关键词
keywords_reversed	string[]	4–5 个逆位关键词
meaning_upright	string	正位含义（简洁关键词短语）
meaning_reversed	string	逆位含义（简洁关键词短语）
love / love_reversed	string	爱情/关系情境（正位/逆位）
career / career_reversed	string	事业/工作情境（正位/逆位）
mood / mood_reversed	string	情绪/情感基调（正位/逆位）
spiritual / spiritual_reversed	string	灵性成长情境（正位/逆位）

数据获取方式

• Hugging Face: Tarotoo/tarotoo-tarot-card-meanings
• Kaggle: tarotoo/tarotoo-tarot-card-meanings
• npm: tarotoo-tarot
• PyPI: tarotoo-tarot
• Zenodo（数据集）: DOI 10.5281/zenodo.21285777
• Zenodo（完整仓库）: DOI 10.5281/zenodo.21514519（概念 DOI：10.5281/zenodo.21268290）
• 原始文件: 可通过 GitHub 直接下载 data/cards.json 等文件
• MCP 服务器: tarotoo-mcp-server（适用于 Claude Desktop、Claude Code、Cursor 等 AI 助手）

构建方法与数据来源

• 所有解读文本由 Tarotoo 在 Rider–Waite–Smith 传统体系内创作，主要参考 A. E. Waite 的《The Pictorial Key to the Tarot》（1911）。
• 行星和星座对应关系遵循古典守护体系及金色黎明《Book T》中的十度系统。
• 是/否判定参考现代广泛使用的解读惯例及 Tarotoo 合作的塔罗专家意见。
• 每张牌均经一致性审查，确保整个牌组在语气、术语和结构上的统一。

许可与引用

• 许可协议: MIT License — 可自由使用、复制、修改和再分发（含商业用途），建议注明出处。
• 引用格式: Tarotoo. (2026). Tarotoo Tarot Card Meanings: Complete Dataset Repository and Infrastructure (Version 2.0.0) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.21514519

预期用途

该数据集适用于教育、研究、创意、娱乐和自我反思目的，不应作为医疗、法律、财务、心理健康或其他专业建议的替代品。

搜集汇总

数据集介绍

构建方式

该数据集由塔罗文化领域的专业团队Tarotoo精心构建，完整收录了Rider-Waite-Smith传统下的78张塔罗牌，涵盖22张大阿卡纳与56张小阿卡纳。每张牌均按照统一的schema进行结构化编码，包含编号、名称、所属阿卡纳类型、花色、数字命理学、元素、行星与星座对应、正逆位关键词、正逆位释义，以及爱情、事业、心境、灵性等不同维度的解读文本。数据的构建依托于A.E. Waite的《The Pictorial Key to the Tarot》等经典文献，并参考了金色黎明协会的《Book T》中的星象对应体系，由塔罗专家团队对牌义进行统一校勘与润色，最终生成了JSON、JSONL、CSV等多格式的规范数据集。

特点

该数据集的核心特色在于其结构化的多维度设计，每个牌义记录不仅包含传统的正逆位关键词与释义，还扩展了针对爱情、事业、心境、灵性等具体场景的细分解读，极大提升了数据的实用性与灵活性。同时，数据严格遵循Rider-Waite-Smith传统，并融入了现代塔罗实践中广泛接受的星象对应与是非判断规则，保证了内容的权威性与时代性。所有牌义的措辞、术语和结构均经过统一审查，确保了整套数据集在风格上的一致性与逻辑上的连贯性。此外，数据集提供了稳定的标识符和跨平台的多格式镜像，并获得了Zenodo的DOI认证，为学术研究与应用开发提供了可靠的数据基础。

使用方法

该数据集的使用方式极为便捷多样。开发者可通过Python或JavaScript的官方包直接引入，如使用pip安装tarotoo-tarot后即可调用get_card、search_cards等函数快速查询牌义；也可利用Hugging Face的datasets库或Kaggle平台直接下载数据用于机器学习或自然语言处理研究。对于无编程需求的用户，可直接从GitHub仓库获取原始JSON文件，或通过npm配置MCP服务器，使Claude等AI助手能够实时查询牌义。数据集的构建脚本支持用户自定义修改源文件并重新生成构建产物，便于持续更新与扩展。其MIT开源许可允许商业与非商业用途的广泛使用，适合教育、创意、娱乐及自我反思等多种应用场景。

背景与挑战

背景概述

塔罗牌作为一种古老的占卜与自我反思工具，其象征体系与解读方法在西方神秘学传统中占据重要地位。随着人工智能技术的迅猛发展，将塔罗牌的语义结构数字化、结构化，成为连接传统智慧与现代计算技术的桥梁。Tarotoo Tarot Card Meanings Dataset由Tarotoo团队于2025年发布，系统化整理了基于莱德·伟特·史密斯传统的全部78张塔罗牌（22张大阿卡纳与56张小阿卡纳）的丰富语义信息，涵盖关键词、正逆位解读、爱情、事业、情绪及灵性等多维度语境。该数据集通过Hugging Face、Kaggle、npm与PyPI等平台分发，并配备Python与JavaScript开发工具包及MCP服务器，为研究者与开发者提供了便捷的访问途径。其创建旨在为塔罗牌AI解读系统提供锚定于经典文献的可靠语义基础，推动了塔罗牌在情感计算、人机交互与数字人文等领域的应用研究，具有开创性的学术与实践影响力。

当前挑战

塔罗牌语义的数字化面临多重挑战。领域层面，塔罗牌解读具有高度主观性与语境依赖性，不同流派与解读者的理解存在显著差异，如何在结构化数据中保留其象征的开放性与多义性，是一大难题。构建过程中，需在忠实于莱德·伟特·史密斯传统的基础上，融合A.E.韦特的《塔罗图形密钥》、金色黎明协会的《T书》等经典文献，确保占星、元素对应关系的准确性与一致性。同时，为每张牌生成涵盖爱情、事业、情绪等领域的正逆位解读，要求团队具备深厚的塔罗学知识并维持统一的文风与术语体系。此外，数据集的构建还需应对版本管理、质量验证与跨平台分发的复杂性，通过自动化构建脚本与持续集成流程保障数据的可靠性与可持续性，对开发者提出了技术挑战。

常用场景

经典使用场景

Tarotoo Tarot Card Meanings Dataset作为一套系统化、结构化的塔罗牌语义资源，涵盖了全部78张经典牌卡（22张大阿尔卡纳与56张小阿尔卡纳），并严格遵循莱德-韦特-史密斯传统。其经典使用场景在于作为自然语言处理与生成式AI模型的语义锚点，为塔罗解读类应用提供标准化的输入语料。通过统一的JSON、CSV或JSONL格式，研究者可直接集成于检索增强生成（RAG）流程，或作为微调数据以提升模型对神秘学符号的语义理解，从而构建更具解释一致性的对话系统。

衍生相关工作

围绕此数据集，业界已衍生出一系列兼具学术与工程价值的后续工作。在软件生态层面，官方维护了Python、JavaScript双语言的查询辅助库，并构建了基于Hugging Face与Kaggle的镜像分发通道，极大便利了社区复用。在学术探索方面，该数据的规范结构催生了关于塔罗牌自动解读、象征情感分析以及跨文化比较等议题的研究尝试。此外，其与MCP协议的融合促进了大型语言模型在专业垂直领域的工具化适配，为类似文化符号数据集的标准化提供了可借鉴范式。

数据集最近研究

最新研究方向

塔罗牌卡牌含义数据集的构建与AI驱动的个性化解读应用，尤其聚焦于将经典符号体系与机器学习、自然语言处理技术深度融合，以提升占卜解读的文化精准度与个体适配性，同时推动神秘学遗产的数字化转译与开源共享。