FateStar 郑大钱 · 开发者文档

把紫微斗数排盘引擎接进你的应用 —— 三种方式:API、MCP Server、Skill。三套都是标准协议, 只要你的 Agent / 客户端支持其中任一(Claude、Codex、OpenClaw、Hermes、Cursor、KIMI CLI、飞书 CLI……),就能接入。引擎自建 102 颗星 + 三合派四化 + 真太阳时,纯排盘数据、零第三方库。

API Base URLhttps://www.fatestar.top

API / MCP / Skill 怎么选?

三种都能免费排盘、都能调郑大钱(付费解读)。差别只在「怎么接」跟「适合谁」:

先用大白话讲(把郑大钱当算命师傅):
• API —— 你亲手写信寄到师傅家(得会写程序),最自由,适合做后端、批量自动化。
• MCP —— 给你的 AI 助手(Claude / Cursor)接一条「直通电话」,你打字,它当场打给师傅。装一次,零代码。
• Skill —— 给你的 AI 助手发一本「找师傅说明书」,教它怎么帮你排盘问事。
一句话:不会写程序 → 选 MCP 或 Skill,跟着下面安装一次就能用。

能力	API	MCP	Skill
免费排盘	✓	✓	✓
郑大钱解读(扣积分)	✓	✓	✓
免写代码	✗	✓	✓
AI 里直接用大白话问	✗	✓	✓
零安装(填个地址就能用)	✗	✓	✗
后端 / 批量自动化	✓	△	✗
最适合谁	开发者 / 服务器	Claude·Cursor 用户	Claude·Codex 用户

一句话: 自己写程序、跑后端 → 用 API; 想在 Claude / Cursor 里打字就排盘 → 用 MCP; 想给 Claude / Codex 装个「会排盘的技能」→ 用 Skill。三选一即可,也能混用。

🆓 FateStar 郑大钱(免费版)

透过 Skill / MCP 在你习惯的 Claude / Codex 等平台,直接免费使用「FateStar 郑大钱(免费版)」进行命盘排盘问事。目前开放免费『排盘功能』,仅限个人娱乐使用,LLM 内容仅供参考。

温馨提示: 免费版能精准推算你的命盘,并精确测算十年大运、流年、流月、流日、流时的盘相。但因为是用你自己「未经特殊预训练」的 LLM、上网搜索大量未经检查及认证的资料得出的内容,测算可能有所偏差,纯属娱乐、仅供参考。
(大白话:你用自己的大模型去算命,会算不准啦!问不到这么详细啦~图个乐看看就行啦~不然我做 API 干嘛咧~)

⭐ FateStar 郑大钱(付费版)

升级解锁『郑大钱』『双人合盘』『命盘仓库』全功能,真正预判你的个人运势、趋吉避凶。透过 解读 API 调用,经特训知识引擎 + 郑大钱人格精准断盘。详见解读接口。

● 只有解读 API(问郑大钱)需注册会员;排盘 API 匿名可调,不注册也能排盘。
● 充值后每次提问正常扣除积分;无积分则无法使用 API 接入。
● 免费注册用户每日 3 积分(每天可免费问 3 个问题,北京时间 21:00 重置)。

快速开始

两步把排盘接进来。下面以 1990 年 7 月 23 日早上 8 点出生男性为例。

免费排盘(匿名,无需 Key)

bash

1	curl "https://www.fatestar.top/api/ziwei?year=1990&month=7&day=23&hour=8&gender=male"

付费解读(带 FSFSKey Key,耗积分)

bash

1	curl -X POST "https://www.fatestar.top/api/ziwei/reading" \
2	-H "Authorization: Bearer FSFSKey20260606XXXXXXXXXXXXXXXXXXXX" \
3	-H "Content-Type: application/json" \
4	-d '{ "year": 1990, "month": 7, "day": 23, "hour": 8, "gender": "male", "question": "看我今年的事业" }'

请将 FSFSKey20260606XXXXXXXXXXXXXXXXXXXX 替换为你的真实 Key。可在 fatestar.top 开发者中心免费创建。

认证 & 积分

注册后你会拿到一个固定的 FSFSKey API Key —— 可以重复使用、重复复制,不用每次重新创建。这一个 Key 就同时解锁两种用法,系统看你调哪个接口决定扣不扣积分:

用法 1 · 完全免费

🆓 排盘引擎

/api/ziwei

● 排命盘 + 6 层运限(大限 / 流年 / 流月 / 流日 / 流时 / 斗君)
● 不扣积分,调几万次都免费
● 开源,匿名(不带 Key)也能调,按 IP 限流

用法 2 · 扣积分

⭐ 郑大钱解读

/api/ziwei/reading

● 问郑大钱一个问题,知识引擎 + 郑大钱人格断盘
● 每问一次扣积分:中文 > 10 字 / 英文 > 20 字母 = 1 积分
● 短问免费(中文 ≤10 / 英文 ≤20);一次 201 字以上封顶 2 积分

一句话讲清楚:排盘永远免费,只有问郑大钱(调 /api/ziwei/reading)才扣积分。你不主动问郑大钱,就一个积分都不会少 —— 新手放心排盘。

认证方式(带 / 不带 Key 的区别)

FateStar 排盘引擎支持灵活的认证策略,你可以根据需要选择是否携带 API Key:

调用方式	Header 格式	能力与计费
匿名调用	不提供 Authorization 头	仅『排盘』(命盘 + 6 运限),免费、按 IP 限流
认证调用	`Authorization: Bearer FSFSKey…`	排盘 + 知识引擎 + 郑大钱『解读』,按积分计费

注意:若你在请求中携带了 Authorization 头但 Key 非法、已禁用或已过期,系统将返回401 Unauthorized,而不会降级为匿名调用。

积分规则

● 只有解读 API(问郑大钱)需注册会员;排盘 API 匿名可调,不注册也能排盘。
● 解读按提问字数扣 1 ~ 2 积分(短问免费;详见积分计费)。
● 免费注册用户每日 3 积分(北京时间 21:00 重置);无积分需充值。

排盘 API（免费）

GET / POST/api/ziwei

输入出生信息,返回完整本命盘(可选 6 层运限)。匿名可调,按 IP 限流。参数走 query 或 JSON body。

请求参数

字段名	必填	说明
`year / month / day`	✅	出生年月日(阳历;calendarType=lunar 时为农历)
`hour`	✅	出生小时 0–23(24 小时制,非时辰地支)
`gender`	✅	male / female
`calendarType`		solar(默认)/ lunar
`minute`		出生分钟,配合 longitude 做真太阳时精修
`longitude / tz`		经度 + 时区,启用真太阳时修正
`transits`		=1 或带 targetYear 时加 6 层运限
`targetYear / Month / Day / Hour`		运限目标(默认当年 + 本命月日)

请求示例

bash

1	# 本命盘
2	curl "https://www.fatestar.top/api/ziwei?year=1990&month=7&day=23&hour=8&gender=male"
3
4	# 本命盘 + 2026 流年运限
5	curl "https://www.fatestar.top/api/ziwei?year=1990&month=7&day=23&hour=8&gender=male&transits=1&targetYear=2026"

响应格式

成功返回 { "data": { … } },顶层字段:

字段	说明
`基础`	五行局 / 阴阳 / 命主身主 / 命身宫地支 / 真实出生四柱(万年历按节气)
`十二宫`	每宫主星 / 辅星 / 煞星 / 杂曜 + 庙旺亮度 + 生年四化 + 空宫借星 + 大限年龄
`本命四化`	化禄 / 化权 / 化科 / 化忌(星 + 所在宫)
`格局 / 夹宫`	30+ 经典格局(含古籍出处)+ 夹宫扫描
`运限`	带 transits 时加大限 / 小限 / 流年 / 流月 / 流日 / 流时

完整响应示例(节选):

json

1	{
2	"data": {
3	"基础": {
4	"阳历": "1990-7-23 8时",
5	"五行局": "金四局",
6	"阴阳": "阳",
7	"命主": "巨门", "身主": "天梁",
8	"命宫地支": "卯", "身宫地支": "亥",
9	"真实出生四柱": { "年": "庚午", "月": "癸未", "日": "甲子", "时": "戊辰" }
10	},
11	"十二宫": [
12	{
13	"宫名": "命宫", "天干地支": "己卯",
14	"主星": [{ "名称": "太阳", "亮度": "庙", "四化": "化禄" }],
15	"辅星": [{ "名称": "文昌" }],
16	"煞星": [], "杂曜": ["天官", "天福"],
17	"身宫": false, "大限年龄": "6-15岁"
18	}
19	],
20	"本命四化": {
21	"化禄": { "星": "太阳", "宫": "命宫" },
22	"化权": { "星": "武曲", "宫": "财帛宫" },
23	"化科": { "星": "天同", "宫": "迁移宫" },
24	"化忌": { "星": "太阴", "宫": "夫妻宫" }
25	},
26	"格局": [{ "名称": "日丽中天", "类别": "吉", "宫位": "命宫", "出处": "紫微斗数全书" }],
27	"夹宫": []
28	}
29	}

错误码

所有错误响应均为 { "error": { "code", "message" } } 结构。

状态码	code	说明
400	`VALIDATION_ERROR`	参数缺失或范围错(year/month/day/hour/gender 等)
400	`INVALID_JSON`	POST body 不是合法 JSON
401	`UNAUTHORIZED`	解读 API 缺少或无效的 FSFSKey Key(不降级匿名)
402	`INSUFFICIENT_CREDITS`	积分不足(响应带 need / have);不生成、不扣费
403	`CHART_QUOTA_EXCEEDED`	命盘配额已满
429	`RATE_LIMITED`	请求过于频繁(按 IP 限流)
500	`INTERNAL_ERROR`	服务端内部错误,可重试
502	`GENERATION_FAILED`	解读生成失败(空回复);未扣费

错误响应示例

json

1	{
2	"error": {
3	"code": "INSUFFICIENT_CREDITS",
4	"message": "积分不足: 需 1, 有 0",
5	"need": 1,
6	"have": 0
7	}
8	}

枚举值参考

API 请求与响应里常用的枚举字段取值规范。

性别 gender

malefemale

历法 calendarType

solar(公历,默认)lunar(农历)

运限层级(transits 输出)

大限小限流年流月流日流时

星曜类型

主星(14)辅星(8)煞星(6)杂曜(38)流曜(36)

生年四化

化禄化权化科化忌

庙旺亮度

庙旺得利平不陷

五行局

水二局木三局金四局土五局火六局

十二宫

命宫兄弟夫妻子女财帛疾厄迁移仆役官禄田宅福德父母

解读 API（付费)

POST/api/ziwei/reading

开放问答:传出生信息 + question,返回郑大钱人格 + 知识引擎的完整解读(与网站同质量)。需带 FSFSKey Key,扣 Key 所属开发者积分。

bash

1	curl -X POST "https://www.fatestar.top/api/ziwei/reading" \
2	-H "Authorization: Bearer FSFSKey20260606XXXXXXXXXXXXXXXXXXXX" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"year": 1990, "month": 7, "day": 23, "hour": 8,
6	"gender": "male",
7	"question": "看我今年的事业运,该不该跳槽?"
8	}'

响应示例

json

1	{
2	"data": {
3	"reading": "…郑大钱解读全文…",
4	"creditsUsed": 1,
5	"balanceAfter": 12,
6	"chartId": "…"
7	}
8	}

积分计费

按一次提问的字数计费(中文 / 英文分别计):

提问长度	消耗积分
中文 ≤ 10 字 / 英文 ≤ 20 字	免费
中文 11 ~ 200 字 / 英文 21 ~ 200 字	1 积分
一次性 201 字以上	2 积分(封顶)

项目	规则
解读人格	郑大钱(顶级国学紫微专家人格)
扣谁	FSFSKey Key 所属开发者本人
余额不足	返回 402 INSUFFICIENT_CREDITS,不生成、不扣费
空回复	生成失败(空回复)不扣费
叠加	订阅积分可与单买积分叠加使用

MCP 安装

Model Context Protocol —— 让 Claude / Cursor 等 AI 客户端直接调。三个工具:ziwei_chart(本命盘)、ziwei_transits(6 层运限)、ziwei_reading(郑大钱付费解读,需 key 扣积分)。 FateStar 的 MCP 走标准 Streamable HTTP,填一个 URL 即可 —— 零安装、始终最新、无需任何桥接代理。

配置(零安装,填一个 URL)

支持 MCP 的客户端,配置里填一个地址即可:

json

1	{
2	"mcpServers": {
3	"ziwei": { "url": "https://www.fatestar.top/api/mcp" }
4	}
5	}

带 Key(解锁郑大钱解读)

排盘免费匿名;要调郑大钱解读(付费),加一个 Authorization 头:

json

1	{
2	"mcpServers": {
3	"ziwei": {
4	"url": "https://www.fatestar.top/api/mcp",
5	"headers": { "Authorization": "Bearer FSFSKey20260606XXXXXXXXXXXXXXXXXXXX" }
6	}
7	}
8	}

Skill 安装(Claude / Codex)

把排盘封装成 Agent Skill,丢进 Agent 的 skills 目录即用。Skill 内部调排盘 API,自然语言「帮我排 XXX 的紫微盘」直接出盘。也可直接用上方 MCP 配置(等效,二选一)。

下载安装

Skill 已开源(GitHub),git clone 下来,整个目录改名 ziwei-paipan 放进 Agent 的 skills 目录:

bash

1	git clone https://github.com/LouisLin0723/fatestar-ziwei-skill.git
2
3	# Claude Code / Claude Desktop
4	mv fatestar-ziwei-skill ~/.claude/skills/ziwei-paipan
5
6	# OpenAI Codex
7	mv fatestar-ziwei-skill ~/.codex/skills/ziwei-paipan

API Key 配置

排盘免费,开箱即用,无需 key。想让 skill 顺便调郑大钱解读(扣积分),把 FSFSKey key 配进环境变量,skill 会自动带上:

bash

1	# 在 fatestar.top 开发者中心申请 key 后, 写进环境变量
2	export FATESTAR_API_KEY="FSFSKey20260606XXXXXXXXXXXXXXXXXXXX"
3
4	# skill 检测到 key → 解读解锁; 无 key → 仅排盘(免费)

验证安装

重启 Agent,用大白话直接问:

● 排盘(免费):「帮我排 1990 年 7 月 23 日早上 8 点、男的紫微盘」→ 出完整命盘 = 成功。
● 解读(扣积分):「我今年事业运如何?该不该跳槽?」→ 郑大钱断盘 = 成功(需已配 key)。

想要更深的「只讲真话」专业断盘 + 古籍依据?上 fatestar.top 找 AI 命理师『郑大钱』(积分解锁知识引擎)。

接入各 Agent

FateStar 排盘引擎走三套标准协议,任何支持其一的 Agent / 客户端都能接入,不限下面列出的:

● MCP:填远程地址 https://www.fatestar.top/api/mcp
● API:任何能发 HTTP 的语言 / 工具直接调
● Skill:SKILL.md 格式,cp 进 Agent 的 skills 目录

Claude Desktop / Claude Code

json

1	{
2	"mcpServers": { "ziwei": { "url": "https://www.fatestar.top/api/mcp" } }
3	}
4	// 或 Skill: mv fatestar-ziwei-skill ~/.claude/skills/ziwei-paipan

OpenAI Codex

json

1	{
2	"mcpServers": { "ziwei": { "url": "https://www.fatestar.top/api/mcp" } }
3	}
4	// 或 Skill: mv fatestar-ziwei-skill ~/.codex/skills/ziwei-paipan

OpenClaw

json

1	{
2	"mcpServers": { "ziwei": { "url": "https://www.fatestar.top/api/mcp" } }
3	}
4	// 或 Skill: mv fatestar-ziwei-skill ~/.openclaw/skills/ziwei-paipan

Hermes / Cursor / Cline / KIMI CLI / 飞书 CLI / 其他

同样填标准 MCP 地址。各 Agent 的配置文件位置 / key 名略有差异(参考各自文档),核心地址完全一致:

json

1	{ "mcpServers": { "ziwei": { "url": "https://www.fatestar.top/api/mcp" } } }

客户端速查

Agent	MCP	Skill 目录
Claude Desktop / Code	填 url	`~/.claude/skills/`
OpenAI Codex	填 url	`~/.codex/skills/`
OpenClaw	填 url	`~/.openclaw/skills/`
Cursor	填 url	`项目/.skills/`
Hermes / Cline / KIMI CLI / 飞书 CLI / 其他	填 url	各自 skills 目录

只要你的 Agent 支持 MCP / API / Skill 任一,就能接入 FateStar 排盘引擎。远程 MCP 地址统一:https://www.fatestar.top/api/mcp。

关于 FateStar

『FateStar』是一款只讲真话的紫微斗数 AI 智能体应用,基于中国传统文化『紫微斗数』开发的 SaaS 工具, 具备一位有灵魂、有使命感的大脑『郑大钱』老师,给予用户们指导意见。

自研核心双重引擎系统:【排盘引擎】+【知识引擎】。『郑大钱』透过每个人独一无二的『命盘』, 进行超过 500,000 种排列组合分析,确保最低幻觉率、最高精准度。

有别于 MBTI 人格测验,只需三分钟、问三个问题,就能知道自己擅长的天赋、适合的伴侣,甚至是职场发展方向。只要输入出生时间及出生地,就能获得一份详细的『人生藏宝图』,找到自己的『盲点』。

核心功能

『排盘引擎』 —— 输入出生时间及出生地,生成独一无二的『命盘』:12 个宫位、50 万种排列组合,每个人都不相同。
『郑大钱』 —— 直接提问,得到诚实的指导:感情、工作、金钱、创业、家庭、健康……专属于自身的定制化答案。
『双人合盘』(核心功能) —— 两个『命盘』对照比对,看彼此『相生相克』、如何分工合作、如何维持关系。可与伴侣 / 好友 / 家人 / 合伙人 / 客户,甚至情敌、竞争对手合盘。
『命盘仓库』 —— 新增 / 编辑 / 储存自己、家人、朋友的命盘,内建笔记本记录与『郑大钱』的对话重点、心得、Idea。

解决什么问题

1. 两个人生意合伙,到底合不合适?该不该投资?
2. 工作很不快乐,到底适合做什么工作?该不该换工作?
3. 学生不知道选什么专业?该学些什么适合自己?
4. 家人或伴侣吵架,该如何经营感情?如何有效沟通?
5. 不了解自己,对未来感到迷茫、困惑、没有方向感?

免费领积分的玩法

🎁 连续登录挑战 —— 每天登录 FateStar,连续登录满约定天数即可领取积分奖励;养成习惯,天天白嫖郑大钱。
👥 邀请好礼 —— 邀请朋友注册成功,双方都有礼:送 PRO 会员 7 天 + 额外积分,越拉越多。
🤝 联盟营销 —— 加入 FateStar 联盟计划,把命理工具推广给更多人,赚取佣金分润,变成你的副业。