skill-qimen-api（技能 qimen API）

小奇智算 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, data, 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, data, 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

1. EN: This service is driven by data analysis and cognitive science for rational decision reference.

CN: 本服务基于数据分析与认知科学，仅作理性决策参考。

1. EN: No feudal superstitious content is involved.

CN: 内容不含封建迷信导向。

1. 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.

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

1. 八字 — BaZi / Eight Characters
2. 奇门遁甲 — Qi Men Dun Jia
3. 大运 — Great Fortune
4. 流年 — Fleeting Year
5. 排盘 — Chart Generation
6. 解盘 — Chart Interpretation
7. 用神 — Useful God
8. 即时盘 — Immediate Chart
9. 终身盘 — Lifetime Chart