🔮

佩璇 Peixuan

中國命理 API — 為 LLM 而生,人類也能用

免費 · 開源 · 無需 API Key

這是什麼?

佩璇是一個中國命理的計算引擎,根據出生資料計算八字(BaZi)與紫微斗數(Zi Wei Dou Shu)命盤,回傳結構化 JSON。

不同於傳統命理網站,佩璇是一個 LLM 原生服務 — AI agents 可以透過標準協定自動發現、查詢、呼叫它。人類也可以透過任何 LLM 來使用。

怎麼用?

把這段話貼給你常用的 AI 聊天助手(ChatGPT、Claude、Gemini 都行):

請參考 https://peixuan.sfan-tech.com 這個網站,幫我用八字和紫微斗數算命。我的出生資料:1990 年 5 月 15 日,下午 2 點 30 分,男性。

已複製 ✓

👆 點擊複製,把出生資料換成你自己的

AI 會自動讀取本站的 API 說明、呼叫計算引擎、取得你的命盤資料,然後為你解讀。

開發者?直接呼叫 API

curl -X POST https://peixuan.sfan-tech.com/calculate/unified \
  -H "Content-Type: application/json" \
  -d '{"birthDate":"1990-05-15","birthTime":"14:30","gender":"male"}'

或用自然語言查詢:

curl "https://peixuan.sfan-tech.com/ask?query=1990-05-15+14:30+male"

進階整合

想讓你的 AI 助手隨時都能算命?可以做更深度的整合:

💬 ChatGPT

建立 Custom GPT → Actions → 匯入 /openapi.json,使用者說「幫我算命」就會自動呼叫 API

🤖 Claude / Kiro

加入 MCP 設定:
"command": "npx", "args": ["-y", "peixuan-mcp"]

✨ Gemini

Gemini CLI + MCP:同上 peixuan-mcp 設定;或建立 Gem → 貼上 /persona/character 的人設

🌐 任何 LLM

呼叫 API,把 JSON 貼進對話,請 LLM 解讀

API 端點

POST /calculate/unified — 完整命盤(八字 + 紫微)
POST /calculate/bazi — 八字四柱
POST /calculate/ziwei — 紫微斗數
GET /ask?query=... — 自然語言查詢
GET /persona/character — 佩璇人設
GET /persona/personality-guide — 性格解讀指南
GET /persona/fortune-guide — 運勢解讀指南
GET /glossary — 命理術語表

Agent 協定

本站支援所有主流 agent 協定:

📋
llms.txt

LLM 探索索引 — 描述本站的功能與用途

🔧
MCP Server

npx -y peixuan-mcp — 供 Claude、Kiro、Cursor 使用的工具與資源

💬
/ask (NLWeb)

自然語言查詢端點 — 回傳 Schema.org 格式結果

🤝
A2A Agent Card

Agent 間探索 — 技能、能力、提供者資訊

agents.json

多步驟工作流程定義 — 供 agent 編排使用

📄
OpenAPI 3.1

相容 ChatGPT GPT Actions 的 API 規格

回傳資料

八字 BaZi

四柱(年月日時)、十神、藏干、五行分佈、大運、起運日

紫微斗數 Zi Wei

十二宮與星曜、紫微天府定位、四化飛星、星曜對稱