小奇智算 API 能力 | Xiaoqi Intelligent Calculation API Skill
GET APIKEY：https://www.xiaoqizhisuan.cn/account.html GET HELP: https://www.xiaoqizhisuan.cn/help.html
可用工具 | 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": "${XIAOQIZHISUAN_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": "${XIAOQIZHISUAN_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: ${XIAOQIZHISUAN_API_KEY}" \
-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: ${XIAOQIZHISUAN_API_KEY}" \
-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: ${XIAOQIZHISUAN_API_KEY}" \
-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: 接入使用时建议补充免责声明。
服务商声明 | Service Provider Statement
CN: 本技能为【小奇智算】官方自研服务，运营主体、接口计费、隐私规则均公示于官网： EN: This skill is an official self-developed service of [Xiaoqi Intelligent Calculation]. The operating entity, interface billing, and privacy rules are publicly available on the official website:
官网 | Official Website: https://www.xiaoqizhisuan.cn 隐私政策 | Privacy Policy: https://www.xiaoqizhisuan.cn/privacy.html 服务条款 | Terms of Service: https://www.xiaoqizhisuan.cn/terms.html
CN: 本服务为明码标价按量计费，所有接口价格、扣费规则均文档公示，无隐性收费。 EN: This service uses transparent pay-per-call pricing. All interface prices and deduction rules are publicly documented with no hidden fees.
关键术语对照（统一规范）
- 八字 — BaZi / Eight Characters
- 奇门遁甲 — Qi Men Dun Jia
- 大运 — Great Fortune
- 流年 — Fleeting Year
- 排盘 — Chart Generation
- 解盘 — Chart Interpretation
- 用神 — Useful God
- 即时盘 — Immediate Chart
- 终身盘 — Lifetime Chart