奇门遁甲

小奇智算 API 機能 | Xiaoqi Intelligent Calculation API スキル

API キーの取得：https://www.xiaoqizhisuan.cn/account.html

ヘルプ：https://www.xiaoqizhisuan.cn/help.html

利用可能なツール

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 データ）

价格 | 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 ウェブページ画像

参数 | 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 の呼び出し方法

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 による直接呼び出し

汎用 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 キーがないか、無効です
• 402：アカウント残高が不足しています
• 403：API キーが無効化されています
• 500：サーバー内部エラー

注意事項

1. EN：本サービスは、データ分析と認知科学に基づき、合理的な意思決定の参考情報を提供します。 CN：本サービスはデータ分析と認知科学に基づいており、合理的な意思決定の参考としてのみご利用ください。
2. EN：封建的な迷信を含む内容は扱いません。 CN：内容に封建的な迷信を推奨するものは含まれません。
3. EN：本サービスの利用時には、免責事項を追加することをおすすめします。 CN：本サービスを利用する際は、免責事項を追加することをおすすめします。

---

サービス提供者の声明

CN：本スキルは【小奇智算】が公式に独自開発したサービスです。運営主体、API の料金、プライバシー規則はすべて公式サイトで公開しています。 EN：本スキルは【Xiaoqi Intelligent Calculation】が公式に独自開発したサービスです。運営主体、API の料金、プライバシー規則は公式サイトで公開しています。

公式サイト：https://www.xiaoqizhisuan.cn

プライバシーポリシー：https://www.xiaoqizhisuan.cn/privacy.html

利用規約：https://www.xiaoqizhisuan.cn/terms.html

CN：本サービスは明朗な従量課金制です。すべての API 価格と課金ルールを文書で公開しており、隠れた料金はありません。 EN：本サービスは、利用回数に応じた透明性の高い料金体系を採用しています。すべての API 価格と課金ルールを文書で公開しており、隠れた料金はありません。

---

重要用語の統一

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