Unified Reading

unified-reading

公開されている Unified Reading API 用の SDK、CLI、stdio MCP サーバーです。生年月日を渡すと、ライフパスナンバー、西洋占星術の太陽星座、中国の干支を返します。1924～2044 年の旧正月の表にも対応しています。API キーは不要で、データは保存されません。

生年月日のみを送信し、氏名、生まれた時刻や場所は送信しないでください。個人向けの総合リーディングは unifiedreading.com で利用できます。

CLI

npx unified-reading profile 1990-07-14

1990-07-14
Life Path   4  The Builder
Sun sign    ♋ Cancer, decan 3 (Water, Cardinal, ruled by Moon)
Chinese     Yang Metal Horse

コマンド	説明
unified-reading profile <YYYY-MM-DD>	1 つの日付のライフパスナンバー、太陽星座、中国の干支
unified-reading batch <YYYY-MM-DD>...	最大 20 個の日付について、同じ情報を取得
unified-reading year <YYYY>	中国の干支の年と、その旧正月の開始日および終了日
unified-reading years [--limit N] [--cursor YYYY] [--all]	年の一覧をページごとに取得
unified-reading mcp	stdio MCP サーバーとして実行

任意のコマンドに --json を追加すると、API の生のレスポンスを取得できます。--base-url を指定すると、CLI の接続先を別のオリジンに変更できます。

MCP サーバー

unified-reading mcp は、リモートサーバー https://unifiedreading.com/mcp にリクエストを転送する stdio MCP サーバーを起動します。ローカルコマンドのみを起動する MCP クライアント向けです。

{ "mcpServers": { "unified-reading": { "command": "npx", "args": ["-y", "unified-reading", "mcp"] } } }

このサーバーは、読み取りオプション、生年月日のプロフィール（MCP Apps カード付き）、中国の干支の年を扱うツールを提供します。公式の MCP レジストリには com.unifiedreading/unified-reading として登録されています。

SDK

Node 18 以降、または fetch を備えた任意のランタイムが必要です。

import { UnifiedReading, UnifiedReadingError } from "unified-reading";

const client = new UnifiedReading();

const profile = await client.profile("1990-07-14");
console.log(profile.lifePath.number, profile.sunSign.sign, profile.chineseZodiac.animal); // 4 Cancer Horse

const results = await client.profiles(["1990-07-14", "1990-01-20"], { idempotencyKey: crypto.randomUUID() });

for await (const year of client.allChineseZodiacYears()) {
  console.log(year.year, year.animal, year.starts, year.ends);
}

try {
  await client.profile("1990-02-30");
} catch (error) {
  if (error instanceof UnifiedReadingError) console.log(error.code, error.hint); // invalid_date ...
}

メソッド	エンドポイント
profile(date)	GET /api/v1/profile?date=
profiles(dates, { idempotencyKey })	POST /api/v1/profiles/batch
chineseZodiacYears({ limit, cursor })	GET /api/v1/chinese-zodiac/years（1 ページ分）
allChineseZodiacYears()	すべてのページを非同期イテレーターとして取得
chineseZodiacYear(year)	1 年分を取得。1924～2044 年の範囲外の場合は null

日付には YYYY-MM-DD 形式の文字列または Date オブジェクトを指定できます。Date は現地の暦日として送信されます。エラーが発生すると UnifiedReadingError がスローされ、status、code、hint、retryAfter を保持します。API のリクエスト上限は IP ごとに 1 分あたり 10 回です。

リンク

• API ガイド：https://unifiedreading.com/docs
• OpenAPI 仕様：https://unifiedreading.com/openapi.json
• MCP サーバー（AI エージェント向けの同じ計算）：https://unifiedreading.com/mcp
• ソース：https://github.com/emrecolako/unified-reading/tree/main/sdk
• バグ報告：https://github.com/emrecolako/unified-reading/issues（個人情報は含めないでください）、または [email protected]