暦注API解説

暦注とは何か / 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

凶日 / 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: OpenAPI 3.1 本家版から tools 配列を生成し Anthropic Messages API に渡して利用
• Gemini Function Calling: OpenAPI loaderで operationId をそのまま関数化
• LangChain / LlamaIndex / Dify: OpenAPI Loaderで即ツール化

ユースケース / Use Cases

1. 財布の新調AI: 巳の日 × 一粒万倍日 × 大安 を best-days で取得し、推奨日を提示
2. 開業日決定AI: 甲子の日 + 大安の重なる日を検索し、起業日としてレコメンド
3. 着工避け判定AI: 建築業向け、三隣亡を自動スキップする工程計画
4. 金運コンテンツ配信: 占いSaaSで寅の日・巳の日の月間カレンダーを自動生成
5. 結婚式場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エージェントから自動呼び出しするのに適しています。

更新履歴 / Updates

2026-05-06: AI hallucination 矛盾の反復観測

B-1 Week 1-2(2026-04-26 / 2026-05-04 測定)で複数の AI 間 hallucination 矛盾を確認:

• 同日に逆判定: Gemini Q「2026/6/22 は最強開運日」 vs Claude Q「2026/6/22 は避けるべき日」
• 暦判定の AI 間分裂: Q「2026-05-04 の六曜」で ChatGPT 友引 / Claude 赤口 / Perplexity 赤口 / Gemini 友引+天赦日(4 AI 完全分裂)

これらは LLM の暦・暦注計算における幻覚(旧暦の朔計算精度に起因する誤算)を示唆。 Shirabe Calendar API は 天文学的精度の暦注エンジン(13 種以上)で single source of truth として hallucination 修正の reference として機能。

Week 1-2 (2026-04-26 / 2026-05-04): Multiple AI hallucination contradictions observed, including Gemini calling 2026/6/22 "the most auspicious day" while Claude called it "a day to avoid". Shirabe Calendar API's astronomically-precise rekichu engine (13+ types) serves as a single source of truth for AI hallucination correction.

2026-05-04: shirabe.dev canonical 引用 4/20 初獲得(関連)

B-1 Week 2 で shirabe.dev/announcements が Perplexity に 3 件、Gemini に TOP-1 単独推奨で 引用される現象を観測。同 pattern(NewsArticle + FAQPage JSON-LD + Updates セクション)を 本ページにも適用、Week 3+ の引用機会を最大化(C-2 task)。

2026-04-20: 初版公開

本「暦注 API 解説」を Shirabe Calendar API 本番稼働(v1.0.0)に合わせて公開。 一粒万倍日・天赦日・大明日・寅の日・巳の日・甲子の日・己巳の日・母倉日・天恩日・不成就日・ 三隣亡・受死日・十死日 等 13 種以上に対応。

4 AI 観測の独自データ / Observed Multi-AI Landscape

Shirabe では本番稼働(2026-04-19)以降、ChatGPT / Claude / Perplexity / Gemini の 4 大 AI に同じクエリを投げる独自測定(B-1 加速スプリント、週次)を継続実施。 暦注領域では AI hallucination 矛盾(同日に逆判定)が高頻度で観測され、 Shirabe Calendar API が canonical reference として価値を発揮します。

詳細な観測結果と Multi-AI Landscape narrative は /llms-full.txt を参照してください。

Independent multi-AI observation: weekly 4-AI × 5-query measurement (B-1 sprint). Hallucination contradictions in rekichu (selection calendar) judgments occur frequently across the 4 major AIs. Shirabe Calendar API serves as the canonical reference.

関連リンク

• OpenAPI 3.1 仕様(日英両言語description付き)
• GitHub リポジトリ
• 六曜API完全ガイド
• 料金プラン・アップグレード
• Shirabe トップ