奇门遁甲

小奇智算 API 能力 | Xiaoqi Intelligent Calculation API 技能

获取 APIKEY：https://www.xiaoqizhisuan.cn/account.html

获取帮助：https://www.xiaoqizhisuan.cn/help.html

可用工具 | Available Tools

1. bazi_dayun - 八字大运查询 | 八字大运查询

价格 | Price: ¥0.2 / time / 次
参数 | Parameters:
 year (integer, 必填) 出生年（公历）
 month (integer, 必填) 出生月
 day (integer, 必填) 出生日
 hour (integer, 必填) 出生时（0-23）
 xingbie (string, 必填) 性别（"男" / "女"）

返回 | Return:
 success, cost, balance, bazi, dayun, error

实测结果 | 实测结果： https://www.xiaoqizhisuan.cn/examples/example_1_bazi_dayun.html

2. qimen_paipan - 奇门排盘（JSON 数据）| 奇门排盘（JSON 数据）

价格 | 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, data, error

实测结果 | 实测结果： https://www.xiaoqizhisuan.cn/examples/example_2_qimen_paipan.html

3. qimen_paipan_image - 奇门排盘+HTML网页图 | 奇门排盘+HTML 网页图

参数 | Parameters:
 year (integer, 必填) 年
 month (integer, 必填) 月
 day (integer, 必填) 日
 hour (integer, 必填) 时（0-23）
 minute (integer, 选填, 默认0)
 number (integer, 选填, 默认1)

返回 | Return:
 success, cost, balance, data, html_url, error

实测结果 | 实测结果： https://www.xiaoqizhisuan.cn/examples/example_3_qimen_paipan_image.html

4. qimen_jiepan - 即时盘解析准备 | 即时盘解析准备

价格 | 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

实测结果 | 实测结果： https://www.xiaoqizhisuan.cn/examples/example_4_qimen_jiepan.html

5. qimen_jiepan_lifetime - 终身盘解析准备 | 终身盘解析准备

价格 | 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

实测结果 | 实测结果： https://www.xiaoqizhisuan.cn/examples/example_5_qimen_jiepan_lifetime.html

6. qimen_full - 即时局完整解盘 | 即时局完整解盘

价格 | 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

实测结果 | 实测结果： https://www.xiaoqizhisuan.cn/examples/example_6_qimen_full.html

7. qimen_full_lifetime - 终身局完整解盘 | 终身局完整解盘

价格 | 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

实测结果 | 实测结果： https://www.xiaoqizhisuan.cn/examples/example_7_qimen_full_lifetime.html

API 调用方式 | API 集成方式

MCP 服务对接 | MCP 服务配置

OpenClaw / Hermes / mcporter 配置 | 配置

{
  "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 配置 | 配置

{
  "mcpServers": {
    "xiaoqi": {
      "url": "https://www.xiaoqizhisuan.cn/mcp",
      "headers": {
        "x-api-key": "${XIAOQIZHISUAN_API_KEY}",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

直接 HTTP 调用 | 直接 HTTP 请求

##通用 Curl 请求示例 | 通用 Curl 示例

1. 初始化连接 | 初始化连接

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. 获取工具列表 | 获取工具列表

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. 调用指定工具 | 调用指定工具

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": "男"
      }
    }
  }'

错误码说明 | 错误码说明

• 401: 缺少或无效 API 密钥 | 缺少或无效的 API 密钥
• 402: 账户余额不足 | 账户余额不足
• 403: API 密钥已封禁 | API 密钥已停用
• 500: 服务端内部异常 | 服务端内部错误

注意事项 | 注意事项

1. 英文：本服务以数据分析和认知科学为基础，旨在为理性决策提供参考。 中文：本服务基于数据分析与认知科学，仅作理性决策参考。
2. 英文：不涉及封建迷信内容。 中文：内容不含封建迷信导向。
3. 英文：使用本服务时，建议添加免责声明。 中文：接入使用时建议补充免责声明。

---

服务商声明 | 服务商声明

中文：本技能为【小奇智算】官方自研服务，运营主体、接口计费、隐私规则均公示于官网： 英文：本技能为【小奇智算】官方自主研发服务。运营主体、接口计费和隐私规则均在官方网站公开：

官网 | 官方网站: https://www.xiaoqizhisuan.cn

隐私政策 | 隐私政策: https://www.xiaoqizhisuan.cn/privacy.html

服务条款 | 服务条款: https://www.xiaoqizhisuan.cn/terms.html

中文：本服务明码标价、按量计费，所有接口价格和扣费规则均以文档公示，无隐性收费。 英文：本服务采用透明的按次计费方式。所有接口价格和扣费规则均有文档公示，不存在隐性收费。

---

关键术语对照（统一规范）

1. 八字 — 八字 / 四柱
2. 奇门遁甲 — 奇门遁甲
3. 大运 — 大运
4. 流年 — 流年
5. 排盘 — 排盘
6. 解盘 — 解盘
7. 用神 — 用神
8. 即时盘 — 即时盘
9. 终身盘 — 终身盘