# ベストカレンダー（bestcalendar.jp）

> 日本の暦のデータ: 六曜・吉日（選日）・二十四節気・雑節・旧暦・和暦・干支・九星・国民の祝日・月齢と朔弦望・日の出入りと月の出入り。1926〜2080 年。朔と二十四節気は国立天文台の公式値、祝日は内閣府の公表値と照合している。

Japanese calendar (koyomi) data for AI agents: rokuyo, lucky days, 24 solar terms, lunisolar (kyureki) dates, Japanese era years, national holidays, moon phases, sunrise/sunset. Years 1926-2080. New moons, solar terms and sunrise/sunset follow the National Astronomical Observatory of Japan (NAOJ); holidays follow the Cabinet Office; lucky days follow the traditional almanac rules.

## AI から使う（MCP）

- MCP サーバー: `POST https://bestcalendar.jp/mcp`（Streamable HTTP・JSON-RPC 2.0。ブラウザで開くページではない）。キーは不要。上限は 1 つの IP から 1 分 60 回・1 日 3,000 回
- [MCP の案内と接続の設定例](https://bestcalendar.jp/tools/mcp): Claude・Cursor などへのつなぎ方

## MCP の道具

- `get_koyomi_day`（特定の日の暦）: 指定した日の暦: 和暦・旧暦（閏月）・六曜・吉日・不成就日・二十四節気/雑節・日干支・月齢と朔弦望の時刻・祝日・月食・年と月の九星。
- `search_lucky_days`（期間の吉日検索）: 期間（366日まで）の中から、六曜（大安・友引など）と吉日（一粒万倍日・天赦日・寅の日など）の条件に合う日を探す。
- `convert_wareki_eto`（和暦・干支・九星）: 西暦の年（1926〜2080）を和暦（改元の年は両方）・十干十二支・年の九星に、または日付を和暦・本命星・月命星に換算する。
- `get_sun_moon_times`（日の出入り・月の出入り）: 日の出・日の入り・月の出・月の入り・南中の時刻。
- `list_holidays`（祝日）: 国民の祝日・振替休日・国民の休日の一覧（内閣府の公表値と照合済み）。
- `get_solar_term_times`（二十四節気の節入りの時刻）: 二十四節気の節入りの日時（日本標準時。秒までと、分に四捨五入した値）。
- `get_moon_phases`（新月・満月・上弦・下弦の瞬間）: 朔（新月）・上弦・望（満月）・下弦の瞬間（日本標準時・秒まで）の一覧。
- `get_koyomi_entity`（行事・節気・祝日・吉日の日付）: 名前（例: 春分の日・土用の丑の日・十五夜・一粒万倍日・戌の日・不成就日・節分・彼岸）から、その年の日付・次はいつ・あと何日・定義・根拠を返す。
- `get_moon_events`（月食・スーパームーン）: 月食（皆既・部分・半影、日本での見え方と時刻）とスーパームーンの一覧。
- `get_rokuyo_hours`（六曜の時間帯）: 指定した日の六曜と、時間帯ごとの吉凶（例: 先勝は午前が吉、赤口は正午前後だけ吉）。
- `get_old_time`（明六つ・暮六つと昔の時刻）: 日本時間の日時から、その日の明六つ・暮六つ（国立天文台の定義）と、不定時法の刻（暮六つ・暁九つ など）、十二辰刻（丑三つ時 など）を返す。
- `count_days`（日数と営業日数）: 2 つの日付の間の日数（開始日・終了日を含めるか選べる）と営業日数（土日祝を除く。定休の曜日・お盆・年末年始・個別の休業日と営業日も指定できる）。
- `add_days`（N 日後・N 営業日後）: 日付の N 日後・N 日前、または N 営業日後・前（business: true。土日祝を除く。定休の曜日・お盆・年末年始・個別の指定も可）。
- `check_business_day`（営業日かどうか）: 日付（または 62 日までの期間）が営業日か休みか（理由と祝日名）。
- `find_dates`（条件で日付を探す）: 期間（366日まで）の中から、条件に合う日を探す。
- `answer`（暦の質問に 1 回で答える）: 日本語の質問 1 つ（例: 2027年4月の一粒万倍日はいつ？／2026年10月1日の六曜は？／2027年の夏至の時刻は？／1990年5月23日から20営業日後は？）に、答え・根拠の道具と引数・出典を 1 回で返す。

## 人が読むページ

- [今日の暦](https://bestcalendar.jp/today): 今日の六曜・吉日・旧暦・月齢・日の出入り・祝日
- [暦の行事・節気・吉日の索引](https://bestcalendar.jp/koyomi): 土用の丑の日・十五夜・一粒万倍日などの定義と、毎年の日付
- [今夜の月](https://bestcalendar.jp/moon): 月齢・月相・月の出入り
- [暦と日付の道具](https://bestcalendar.jp/tools): 日数計算・営業日・和暦・生まれた日の暦など
- [購読カレンダー（ICS）](https://bestcalendar.jp/ical): 六曜・吉日・祝日・節気・月相を Google カレンダーや iPhone に
- [暦の埋め込みウィジェット](https://bestcalendar.jp/widget): 今日の暦を iframe 1 行で
- [予定表を作って共有](https://bestcalendar.jp/schedule): 登録なし・無料。日付をなぞって予定を入れ、見るだけのリンクで共有、PDF・エクセルで保存
- [年間予定表のエクセル・PDF](https://bestcalendar.jp/excel/schedule): 12ヶ月×31日・月間・週間・工程表。六曜・祝日入りの書き込む表
- [データの出典と訂正履歴](https://bestcalendar.jp/about/data): 国立天文台・内閣府との照合の方法と、直した誤りの一覧

## Optional

- [法人向けのデータ提供](https://bestcalendar.jp/business): 長い期間の一括データ・商用の組み込み