奇门遁甲
v1.0.6提供基于数据分析与认知科学的八字和奇门遁甲排盘及解盘,辅助理性传统命理决策参考。
小奇智算 API 能力 | Xiaoqi Intelligent Calculation API Skill
GET APIKEY:https://www.xiaoqizhisuan.cn
可用工具 | Available Tools
1. bazi_dayun - 八字大运查询 | BaZi Great Fortune Query
价格 | Price: ¥0.2 / time / 次
参数 | Parameters:
year (integer, 必填) 出生年(公历)
month (integer, 必填) 出生月
day (integer, 必填) 出生日
hour (integer, 必填) 出生时(0-23)
xingbie (string, 必填) 性别("男" / "女")
返回 | Return:
success, cost, balance, bazi, dayun, error
实测结果 | real test: https://www.xiaoqizhisuan.cn/examples/example_1_bazi_dayun.html
2. qimen_paipan - 奇门排盘(JSON 数据)| Qi Men Chart Generation (JSON Data)
价格 | Price: ¥0.5 / time / 次
参数 | Parameters:
year (integer, 必填) 年
month (integer, 必填) 月
day (integer, 必填) 日
hour (integer, 必填) 时(0-23)
minute (integer, 选填, 默认0) 分
number (integer, 选填, 默认1) 排盘方法(1=拆补法, 2=置润法)
返回 | Return:
success, cost, balance, 数据, error
实测结果 | real test: https://www.xiaoqizhisuan.cn/examples/example_2_qimen_paipan.html
3. qimen_paipan_image - 奇门排盘+HTML网页图 | Qi Men Chart Generation + HTML Webpage Chart
参数 | Parameters:
year (integer, 必填) 年
month (integer, 必填) 月
day (integer, 必填) 日
hour (integer, 必填) 时(0-23)
minute (integer, 选填, 默认0)
number (integer, 选填, 默认1)
返回 | Return:
success, cost, balance, 数据, html_url, error
实测结果 | real test: https://www.xiaoqizhisuan.cn/examples/example_3_qimen_paipan_image.html
4. qimen_jiepan - 即时盘解析准备 | Immediate Chart Analysis Preparation
价格 | Price: ¥1.0 / time / 次
参数 | Parameters:
year, month, day, hour (integer, 必填) 起盘时间
minute (integer, 选填, 默认0)
number (integer, 选填, 默认1)
question (string, 必填)
返回 | Return:
success, cost, balance, html_url, system_prompt, user_prompt, error
实测结果 | real test: https://www.xiaoqizhisuan.cn/examples/example_4_qimen_jiepan.html
5. qimen_jiepan_lifetime - 终身盘解析准备 | Lifetime Chart Analysis Preparation
价格 | Price: ¥1.2 / time / 次
参数 | Parameters:
year, month, day, hour (integer, 必填)
xingbie (string, 必填) 性别("男"/"女")
minute (integer, 选填, 默认0)
number (integer, 选填, 默认1)
question (string, 必填)
返回 | Return:
success, cost, balance, bazi, dayun, html_url, system_prompt, user_prompt, error
实测结果 | real test: https://www.xiaoqizhisuan.cn/examples/example_5_qimen_jiepan_lifetime.html
6. qimen_full - 即时局完整解盘 | Complete Immediate Chart Interpretation
价格 | Price: ¥1.5 / time / 次
参数 | Parameters:
year, month, day, hour (integer, 必填)
minute (integer, 选填, 默认0)
number (integer, 选填, 默认1)
question (string, 必填)
返回 | Return:
success, cost, balance, html_url, system_prompt, user_prompt, jiepan_result, error
实测结果 | real test: https://www.xiaoqizhisuan.cn/examples/example_6_qimen_full.html
7. qimen_full_lifetime - 终身局完整解盘 | Complete Lifetime Chart Interpretation
价格 | Price: ¥2.0 / time / 次
参数 | Parameters:
year, month, day, hour (integer, 必填)
xingbie (string, 必填) 性别("男"/"女")
minute (integer, 选填, 默认0)
number (integer, 选填, 默认1)
question (string, 必填)
返回 | Return:
success, cost, balance, bazi, dayun, html_url, system_prompt, user_prompt, jiepan_result, error
实测结果 | real test: https://www.xiaoqizhisuan.cn/examples/example_7_qimen_full_lifetime.html
API 调用方式 | API Integration Methods
MCP 服务对接 | MCP Server Configuration
OpenClaw / Hermes / mcporter 配置 | Configuration
{
"mcpServers": {
"xiaoqi": {
"type": "streamable-http",
"url": "https://www.xiaoqizhisuan.cn/mcp",
"headers": {
"x-api-key": "xq_你的API密钥 / xq_Your-API-Key",
"Accept": "application/json, text/event-stream"
}
}
}
}
Claude Desktop / Cursor / Windsurf 配置 | Configuration
{
"mcpServers": {
"xiaoqi": {
"url": "https://www.xiaoqizhisuan.cn/mcp",
"headers": {
"x-api-key": "xq_你的API密钥 / xq_Your-API-Key",
"Accept": "application/json, text/event-stream"
}
}
}
}
直接 HTTP 调用 | Direct HTTP Request
##通用 Curl 请求示例 | Universal Curl Demo
1. 初始化连接 | Initialize Connection
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "x-api-key: xq_你的API密钥" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-03-26",
"capabilities": {},
"clientInfo": {"name": "my-client", "version": "1.0"}
}
}'
2. 获取工具列表 | Fetch Tool List
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "x-api-key: xq_你的API密钥" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}'
3. 调用指定工具 | Call Target Tool
curl -X POST https://www.xiaoqizhisuan.cn/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "x-api-key: xq_你的API密钥" \
-d '{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "bazi_dayun",
"arguments": {
"year": 1990, "month": 5, "day": 15, "hour": 8, "xingbie": "男"
}
}
}'
windows/powershell
curl -X POST https://www.xiaoqizhisuan.cn/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -H "x-api-key: xq_你的API密钥" -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2025-03-26\",\"capabilities\":{},\"clientInfo\":{\"name\":\"my-client\",\"version\":\"1.0\"}}}"
curl -X POST https://www.xiaoqizhisuan.cn/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -H "x-api-key: xq_你的API密钥" -d "{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/list\",\"params\":{}}"
curl -X POST https://www.xiaoqizhisuan.cn/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -H "x-api-key: xq_你的API密钥" -d "{\"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\"params\":{\"name\":\"bazi_dayun\",\"arguments\":{\"year\":1990,\"month\":5,\"day\":15,\"hour\":8,\"xingbie\":\"男\"}}}"
错误码说明 | Error Code Explanation
- 401: 缺少或无效 API 密钥 | Missing or invalid API Key
- 402: 账户余额不足 | Insufficient account balance
- 403: API 密钥已封禁 | API Key disabled
- 500: 服务端内部异常 | Server internal error
注意事项 | Notes
- EN: This service is driven by data analysis and cognitive science for rational decision reference. CN: 本服务基于数据分析与认知科学,仅作理性决策参考。
- EN: No feudal superstitious content is involved. CN: 内容不含封建迷信导向。
- EN: It is recommended to add a disclaimer when using this service. CN: 接入使用时建议补充免责声明。
EN: This service is officially provided by Xiaoqi Intelligent Calculation WeChat Official Account. CN: 本服务由小奇智算官方服务号独家提供。详细调用示例:https://www.xiaoqizhisuan.cn/help.html
关键术语对照(统一规范)
- 八字 — BaZi / Eight Characters
- 奇门遁甲 — Qi Men Dun Jia
- 大运 — Great Fortune
- 流年 — Fleeting Year
- 排盘 — Chart Generation
- 解盘 — Chart Interpretation
- 用神 — Useful God
- 即时盘 — Immediate Chart
- 终身盘 — Lifetime Chart
