双语牌面资料
获取名称、关键词、描述、正逆位牌义、三种牌图 URL 与来源信息。maj00 这样的稳定 ID,在不同语言中仍指向同一张牌。

Frankie 返回结构化的牌面参考与牌阵定义。问题、选牌、正逆位、解读与保存状态,由调用方界面负责。
获取名称、关键词、描述、正逆位牌义、三种牌图 URL 与来源信息。maj00 这样的稳定 ID,在不同语言中仍指向同一张牌。
每个牌阵提供牌数、有序位置标签与各位置的牌池。例如宫廷行为模式依次使用点数牌、宫廷牌与大阿卡纳。
五个无 UI 的 MCP 工具提供检索、查询、牌阵定义与可选抽牌。服务本身不调用语言模型,也不生成个性化解读。
curl "https://tarot-api.songhai.site/api/v1/cards/maj00?locale=zh-CN"{
"id": "maj00",
"name": "愚人",
"names": {
"en": "The Fool",
"zh-CN": "愚人"
},
"arcana": "MAJOR",
"suit": null,
"rank": 0
}这个小示例改编自真实的 SpreadLayout 组件,使用当前源码数据。编号图形表示位置,并非已经选出的牌;不会发送请求或保存记录。
选择 en 或 zh-CN 获取牌库与牌阵,默认语言为 zh-CN。牌库不分页,公共服务无需 API key。
让用户选择牌阵与牌,再按 ID 查询。独立的 Frankie Tarot 应用提供交互牌桌,这个服务提供参考数据。
可选的随机牌与牌阵抽牌接口,每次都会生成新样本。只有用户明确委托自动抽牌时才调用;只提出一个问题,并不等于同意代选卡牌。
调用方保存牌 ID、位置、正逆位与准确的牌阵定义。没有公开种子、幂等键或恢复接口;结果不确定时再次请求,会是新一次抽牌。
REST 提供带 CORS 的只读 GET 接口。Agent MCP 通过 /mcp/agent 的 Streamable HTTP 返回结构化内容;它是工具服务,不是 ChatGPT 可视化组件或账号系统。
智能体指南 ↗search_tarot_cardsget_random_tarot_cardsdraw_tarot_spreadget_tarot_cardlist_tarot_spreads主要牌义附有 PKT 1911 英文引文出处与中文编辑摘要。modernMeanings 保留项目整理的延伸解释,图像变体、关键词与描述同样经过项目编辑;不能把所有字段都视为历史原文。
服务没有数据库或模型 API 依赖。历史、恢复、用户选择、解读与正逆位由调用方管理;象征性牌义不是事实预测或概率。
不合法查询返回 400,不存在的牌或牌阵返回 404,不支持的 REST 方法返回 405。应处理错误响应,不能编造成功结果。
REST 与 Agent MCP 位于 http://127.0.0.1:3001。独立的 Vite 命令用于编辑完整文档;只启动静态文件服务器,并不会运行服务。
截图与接口约定更新指南 ↗npm ci
npm run api