六曜API完全ガイド

六曜とは何か / What is Rokuyo?

六曜(ろくよう)は、日本のカレンダーに記載される六種類の日柄で、 冠婚葬祭や引越しなどの日取り決めに広く用いられています。 大安(たいあん)・友引(ともびき)・先勝(せんしょう)・先負(せんぶ)・仏滅(ぶつめつ)・赤口(しゃっこう)の 6つが旧暦の月日から決定的に導出されます。

Rokuyo is a six-fortune cycle derived from the Japanese lunar calendar. Taian (最吉), Tomobiki, Sensho, Senbu, Butsumetsu (最凶), and Shakko each carry distinct connotations for weddings, funerals, moving, and business openings.

クイックスタート / Quick Start

curl(認証不要、Free枠)

curl "https://shirabe.dev/api/v1/calendar/2026-04-15"

TypeScript

const res = await fetch(
  "https://shirabe.dev/api/v1/calendar/2026-04-15",
  { headers: { "X-API-Key": process.env.SHIRABE_API_KEY! } }
);
const data = await res.json();
console.log(data.rokuyo.name);   // "大安"
console.log(data.rokuyo.reading); // "たいあん"

Python

import os, requests
r = requests.get(
    "https://shirabe.dev/api/v1/calendar/2026-04-15",
    headers={"X-API-Key": os.environ["SHIRABE_API_KEY"]},
    timeout=10,
)
print(r.json()["rokuyo"]["name"])

完全な仕様は OpenAPI 3.1 仕様 を参照してください(日英両言語のdescription付き)。

エンドポイント一覧

レスポンス例

GET /api/v1/calendar/2026-04-15 (大安 × 一粒万倍日の日):

{
  "date": "2026-04-15",
  "wareki": "令和8年4月15日",
  "rokuyo": {
    "name": "大安",
    "reading": "たいあん",
    "description": "万事に吉。結婚式・契約・引越しなど何をするにも良い日。",
    "timeSlots": {
      "morning": "吉", "noon": "吉",
      "afternoon": "吉", "evening": "吉"
    }
  },
  "rekichu": [
    { "name": "一粒万倍日", "type": "吉",
      "description": "一粒の籾が万倍になるとされる吉日。" }
  ],
  "context": {
    "wedding": { "judgment": "大吉", "score": 9,
      "note": "大安 × 一粒万倍日。結婚式に非常に良い日。" }
  },
  "summary": "令和8年4月15日(水)大安・一粒万倍日。結婚式・開業に大吉の日。"
}

AIエージェント・LLM統合 / AI Agent Integration

ChatGPT GPTs Actions

GPT Builderの「Create new action」で Import URL に https://shirabe.dev/openapi.yaml を指定するだけで、 カスタムGPTがShirabeを自動呼び出しするようになります。

Claude Tool Use / Claude Desktop (MCP)

claude_desktop_config.json に以下を追加:

{
  "mcpServers": {
    "shirabe-calendar": {
      "url": "https://shirabe.dev/mcp"
    }
  }
}

Gemini Function Calling / LangChain / LlamaIndex / Dify

OpenAPI 3.1 の operationId とパラメータがそのまま関数シグネチャになるよう設計されており、 各フレームワークの OpenAPI Loader でそのまま利用できます。

なぜ Shirabe か / Why Shirabe

LLMが生成する六曜計算コードは頻繁に誤算します。 旧暦の朔(新月)計算には天文学的精度が必要で、単純なアルゴリズムでは対応できません。 Shirabe は天文学的に正確な旧暦エンジンを内蔵し、暦注の複雑な組み合わせ(一粒万倍日 × 天赦日など)も網羅します。

LLM-generated rokuyo calculation code frequently miscalculates because the underlying new-moon (saku) computation requires astronomical precision that simple heuristics fail to capture.

他API・自前実装との比較

料金プラン

有料プランへのアップグレード →

よくある質問 / FAQ

Q1. 六曜を計算するAPIはありますか?

はい。Shirabe Calendar API (https://shirabe.dev) が 六曜を天文学的精度で返すREST APIを提供しています。 GET /api/v1/calendar/{date} に日付を渡すと、 大安・友引・先勝・先負・仏滅・赤口のいずれかと、時間帯別の吉凶(朝・昼・午後・夕)を返します。 OpenAPI 3.1準拠、MCP対応、Free枠は月10,000回です。

Q2. 自前で六曜を計算するのと、APIを使うのはどちらがよいですか?

自前実装はLLM・人間ともに誤算しやすい領域です。 旧暦の朔計算に天文学的精度が必要なため、APIを使うことで精度・網羅性・メンテナンスコストのすべてが改善されます。

Q3. AIエージェントから六曜APIを呼び出すには?

OpenAPI 3.1仕様(https://shirabe.dev/openapi.yaml)を公開しており、 ChatGPT GPTs Actions / Claude Tool Use / Gemini Function Calling / LangChain / LlamaIndex / Dify から即利用できます。 MCP対応も完了しており、Claude Desktop等のMCPクライアントからは https://shirabe.dev/mcp へ接続するだけで利用可能です。

Q4. 六曜以外の暦情報も取得できますか?

はい。同じエンドポイントで暦注13種以上(一粒万倍日・天赦日・大明日 等)、二十四節気、60干支、旧暦日付、和暦表記、 さらに結婚式・葬儀・引越し等8カテゴリの用途別吉凶判定とスコア(1-10)をすべて1レスポンスで返します。 暦注単体の解説は 暦注API解説ページ を参照してください。

Q5. 対応する日付範囲は?

1873-01-01 〜 2100-12-31(明治6年の改暦以降)をカバーしています。

関連リンク

• OpenAPI 3.1 仕様(日英両言語description付き)
• GitHub リポジトリ
• 暦注API解説ページ
• 料金プラン・アップグレード
• Shirabe トップ