暦注API解説
Rekichu REST API — 13 Japanese selection-calendar days
一粒万倍日・天赦日・大明日・寅の日・巳の日など、 日本の暦注13種以上を判定するREST API + MCPサーバー。 結婚式・開業・財布の新調・引越しなどの日取り決めに使われる暦注を、天文学的精度で返します。
OpenAPI 3.1 Free 10,000回/月 MCP対応
暦注とは何か / What is Rekichu?
暦注(れきちゅう)は、日本のカレンダーに記される吉凶の目印で、 六曜とは別体系で存在します。旧暦や干支の周期から決定的に導出され、 結婚式・開業・財布の新調・引越しなど具体的な用途に対する吉凶を指し示します。
Rekichu are auxiliary calendar marks in the Japanese almanac that indicate the auspiciousness of a day for specific purposes, derived from the lunar calendar and sexagenary cycle.
サポート暦注一覧(13種)
吉日 / Auspicious Days
| 暦注名 | 読み | 意味・用途 |
|---|---|---|
| 一粒万倍日 | いちりゅうまんばいび | 一粒の籾が万倍に膨らむとされる吉日。開業・種まき・財布の新調に最適 |
| 天赦日 | てんしゃにち | 最上級の吉日。すべての罪を赦すとされ、結婚式・起業・契約に良い |
| 大明日 | だいみょうにち | 太陽が照らす吉日。旅行・引越し・結婚に良い |
| 母倉日 | ぼそうにち | 天が母のように人を育てる日。結婚・養子縁組に吉 |
| 天恩日 | てんおんにち | 天の恩恵を受ける日。祝い事・吉事の開始に吉 |
| 寅の日 | とらのひ | 「虎は千里行って千里帰る」金運の日。財布の新調・旅行に最適 |
| 巳の日 | みのひ | 弁財天の日。金運・芸能・財運の向上に良い |
| 己巳の日 | つちのとみのひ | 60日に一度の強い金運日。巳の日よりさらに強い吉日 |
| 甲子の日 | きのえねのひ | 60干支の始まり。大黒天と結びつく吉日、新規事の開始に最適 |
凶日 / Inauspicious Days
| 暦注名 | 読み | 意味・用途 |
|---|---|---|
| 不成就日 | ふじょうじゅにち | 何事も成就しないとされる凶日。重要な開始は避ける |
| 三隣亡 | さんりんぼう | 建築で三軒隣まで滅ぼすとされる凶日。上棟・着工は避ける |
| 受死日 | じゅしにち | 葬儀以外は凶とされる日 |
| 十死日 | じゅうしにち | 受死日と同系統の凶日 |
各暦注は API レスポンスの rekichu 配列に、名前・読み・説明・吉凶タイプ付きで返されます。
複数の暦注が重なる日(例: 大安 × 天赦日 × 一粒万倍日)は、スコア最高の最上吉日となります。
クイックスタート / Quick Start
curl
# 指定日の暦注を取得 / Get rekichu for a specific date
curl "https://shirabe.dev/api/v1/calendar/2026-04-15"
# 一粒万倍日のみを期間から抽出 / Filter ichiryu-manbaibi days
curl "https://shirabe.dev/api/v1/calendar/range?start=2026-04-01&end=2026-12-31&filter_rekichu=一粒万倍日"
# 天赦日×一粒万倍日の日を抽出
curl "https://shirabe.dev/api/v1/calendar/range?start=2026-04-01&end=2026-12-31&filter_rekichu=天赦日,一粒万倍日"
# 開業に最適な日を期間からランキング
curl "https://shirabe.dev/api/v1/calendar/best-days?purpose=business&start=2026-04-01&end=2026-12-31&limit=10"TypeScript
const res = await fetch(
"https://shirabe.dev/api/v1/calendar/best-days?purpose=business&start=2026-04-01&end=2026-12-31&limit=5",
{ headers: { "X-API-Key": process.env.SHIRABE_API_KEY! } }
);
const data = await res.json();
// data.results[0] = { date: "2026-04-15", score: 9, judgment: "大吉",
// note: "大安 × 一粒万倍日。開業に非常に良い日。",
// rokuyo: "大安", rekichu: ["一粒万倍日"] }レスポンス例
GET /api/v1/calendar/2026-05-10(大安 × 天赦日の最上吉日):
{
"date": "2026-05-10",
"rokuyo": { "name": "大安", "reading": "たいあん" },
"rekichu": [
{ "name": "天赦日", "reading": "てんしゃにち",
"description": "最上級の吉日。すべての罪を赦すとされる。",
"type": "吉" }
],
"context": {
"business": { "judgment": "大吉", "score": 9,
"note": "大安 × 天赦日。最上級の吉日。" },
"wedding": { "judgment": "大吉", "score": 9,
"note": "大安 × 天赦日。結婚式に最上。" }
},
"summary": "令和8年5月10日(日)大安・天赦日。最上級の吉日。"
}AIエージェント統合 / AI Agent Integration
Shirabe Calendar APIは OpenAPI 3.1 準拠で、以下のAIフレームワーク・AIエージェントから即利用可能です。
- ChatGPT GPTs Actions:
https://shirabe.dev/openapi.yamlを Import URL に指定 - Claude Tool Use / Claude Desktop: MCPエンドポイント
https://shirabe.dev/mcpに接続 - Gemini Function Calling: OpenAPI loaderで operationId をそのまま関数化
- LangChain / LlamaIndex / Dify: OpenAPI Loaderで即ツール化
ユースケース / Use Cases
- 財布の新調AI: 巳の日 × 一粒万倍日 × 大安 を best-days で取得し、推奨日を提示
- 開業日決定AI: 甲子の日 + 大安の重なる日を検索し、起業日としてレコメンド
- 着工避け判定AI: 建築業向け、三隣亡を自動スキップする工程計画
- 金運コンテンツ配信: 占いSaaSで寅の日・巳の日の月間カレンダーを自動生成
- 結婚式場AI: 大安 × 天赦日 の日程を上位提示
よくある質問 / FAQ
Q1. 一粒万倍日を判定するAPIはありますか?
はい。Shirabe Calendar APIの GET /api/v1/calendar/{date} で、
指定日の暦注(一粒万倍日・天赦日・大明日など13種以上)をまとめて返します。
大安との重なりなど複合判定も自動で行われます。
Q2. 天赦日と一粒万倍日が重なる日を期間から検索できますか?
GET /api/v1/calendar/range?filter_rekichu=天赦日,一粒万倍日 で期間内の該当日を一括取得できます(最大93日間)。
さらに GET /api/v1/calendar/best-days?purpose=business で用途スコア順のランキングも取得可能です。
Q3. 暦注はいくつサポートしていますか?
13種以上をサポート: 一粒万倍日、天赦日、大明日、母倉日、天恩日、寅の日、巳の日、己巳の日、甲子の日、 不成就日、三隣亡、受死日、十死日。各暦注に読み・意味・吉凶タイプが付与されます。
Q4. 三隣亡を避けて建築スケジュールを組みたい
GET /api/v1/calendar/range でレスポンスの rekichu 配列に「三隣亡」が含まれる日を除外すれば実現できます。
建築業向けRPA・AIエージェントから自動呼び出しするのに適しています。