暦データ・API・制作サポート

六曜・吉日・月齢を、
あなたのカレンダーや
サービスに。

Web・アプリへの組み込みから、
カレンダー・手帳の制作まで。
用途に合った形式で、暦データをご提供します。

CSV・JSONでの納品 / APIでの取得 / 制作・組み込み
ご注文の受付は準備中です。APIは導入相談を受け付けています。

カレンダー制作への活用例2027
ベストカレンダーで公開している2027年1月の六曜入りカレンダー
ベストカレンダーの制作例
用途に合わせて選べる形式CSV / JSON / API
六曜月齢節気吉日・選日
CSV・JSONで制作に利用定義・出典がわかる辞書版情報と訂正のご案内

01 / USE CASES

暦データの活用方法

Web・アプリへの組み込みや、カレンダー・手帳の制作に。
用途に合わせて、ファイル納品・API・制作サポートをお選びいただけます。

01

Web・アプリに
暦を組み込む

日付選択画面への六曜表示や、日ごとの月齢表示に利用できます。APIで日・月単位のデータを取得し、自社のWeb・アプリに組み込めます。

APIで受け取る
02

カレンダー・手帳の
制作に使う

一年分のCSV・JSONから必要な項目を取り出して、紙面の制作に利用できます。項目辞書と月別確認表は、内容の確認や校正にも使えます。

納品パックを見る
03

データの加工や
制作を依頼する

独自のデータ形式への変換、カレンダーのレイアウト、サイトへの組み込みなどをご相談いただけます。対応可否や費用は、ご希望の成果物と作業範囲を確認してご案内します。

制作を相談する

02 / DELIVERABLES & SAMPLE

納品内容とサンプル

納品パックには、一年分の暦データ、項目辞書、月別確認表などを同梱します。1か月分のサンプルで、内容や形式をご確認いただけます。

カレンダーの制作例2027 / 01
2027年1月のカレンダー。日付ごとの六曜と祝日を掲載

ベストカレンダーで公開している制作例です。カレンダーメーカーでも確認できます ↗

登録不要

2027年1月分の
サンプルデータ

CSV・JSONと、項目辞書・確認表をまとめてダウンロードできます。表計算ソフトでの確認や、プログラムへの取り込みをお試しください。

開き方・利用条件を見る ↗
版:2027.1 / 試用条件

INSIDE THE PACK

納品パックに含まれるファイル

各カードからサンプルの内容をご覧いただけます。
年間版も、同じ形式で一年分を納品します。

APIで受け取る場合

APIで取得するデータ

日付や年月を指定して、お客様のサーバーから暦データを取得します。取得したJSONを、ご自身のWeb・アプリの表示に利用できます。APIキー・仕様書・版情報も提供します。

  1. 日付・年月を指定
  2. 暦の値をJSONで取得・保存
  3. Web・アプリの表示に使う

APIは提供開始前です。取得対象:2025〜2028年。

応答の例・コードを見る +
2027年1月分のサンプル表示
日付曜祝日・休日六曜旧暦日干支二十四節気・雑節吉日・選日等月齢月相(時刻)月食・スーパームーン
01/01金元日仏滅11月24日庚辰天恩日23.1
01/02土大安11月25日辛巳天恩日・巳の日24.1
01/03日赤口11月26日壬午神吉日・大明日・天恩日・月徳日25.1
01/04月先勝11月27日癸未天恩日26.1
01/05火友引11月28日甲申小寒神吉日・大明日27.1
01/06水先負11月29日乙酉神吉日・不成就日28.1
01/07木仏滅11月30日丙戌29.1
01/08金赤口12月1日丁亥大明日0.3新月 05:24
01/09土先勝12月2日戊子一粒万倍日・神吉日1.3
01/10日友引12月3日己丑2.3
01/11月成人の日先負12月4日庚寅月徳日・寅の日3.3
01/12火仏滅12月5日辛卯一粒万倍日・神吉日4.3
01/13水大安12月6日壬辰大明日・不成就日5.3
01/14木赤口12月7日癸巳母倉日・巳の日6.3
01/15金先勝12月8日甲午神吉日・母倉日7.3
01/16土友引12月9日乙未大明日8.3上弦の月 05:34
01/17日先負12月10日丙申冬の土用神吉日9.3
01/18月仏滅12月11日丁酉神吉日10.3
01/19火大安12月12日戊戌11.3
01/20水赤口12月13日己亥大寒神吉日12.3
01/21木先勝12月14日庚子一粒万倍日・神吉日・月徳日・不成就日13.3
01/22金友引12月15日辛丑神吉日14.3満月 21:17スーパームーン(年内最接近)
01/23土先負12月16日壬寅大明日・寅の日15.3
01/24日仏滅12月17日癸卯一粒万倍日・神吉日16.3
01/25月大安12月18日甲辰大明日17.3
01/26火赤口12月19日乙巳神吉日・大明日・母倉日・巳の日18.3
01/27水先勝12月20日丙午神吉日・大明日・母倉日19.3
01/28木友引12月21日丁未神吉日・大明日20.3
01/29金先負12月22日戊申神吉日・不成就日21.3下弦の月 19:55
01/30土仏滅12月23日己酉神吉日・大明日・天恩日22.3
01/31日大安12月24日庚戌大明日・天恩日・月徳日23.3

03 / DATA & QUALITY

収録項目と
データの検証

各項目の定義・出典・基準時刻を明記します。
検証した範囲とデータの版情報もご確認いただけます。

辞書・検証記録を開く ↓

定義・出典天文計算、公表情報、暦の慣習など、各項目の根拠を示します。

検証・版情報照合先・検証範囲と、データの版を記録します。

訂正・差し替え訂正があった場合は、対象の日付・項目と変更内容をご案内します。

標準収録の7種類
01

旧暦・六曜

旧暦の日付・閏月、大安・友引などの六曜

02

吉日・選日等11種

一粒万倍日・天赦日など。不成就日を含みます

03

二十四節気・雑節

立春・夏至などの節気、節分・土用などの雑節

04

日干支

その日の十干・十二支

05

月齢・月相・朔弦望

月齢、朔・上弦・望・下弦とその時刻

06

国民の祝日・休日

祝日名、振替休日・国民の休日

07

月食・スーパームーン

月食・スーパームーンの情報と判定基準

日の出入・月の出入(47 都道府県の代表地点)、月星座・天体配置(東京・JST 0 時の日別値)は追加提供をご相談ください。

定義・時刻・データの範囲

日付と時刻は日本時間が基本です。月齢の基準時刻や事象の時刻は項目辞書に記載します。将来の祝日は、公表済み情報と現行制度に基づく推定を区別します。

「該当する事象がない」と「未収録・取得失敗」も区別して扱います。検証した項目・期間・照合先は検証記録で確認できます。

追加提供できるデータ・標準収録外の項目

日の出入・月の出入(47 都道府県の代表地点)、月星座・天体配置(東京・JST 0 時の日別値)は追加提供をご相談ください。任意のGPS地点・出生時刻を指定する計算サービスは含みません。

九星・十二直・二十八宿・三隣亡・潮汐、記事・記念日コンテンツは標準収録外です。必要な項目は発注前にご確認ください。

データの版と更新履歴

2026-09-14 / 2027.1
暦データ納品パック 2027 年版(標準 7 資産・365 日)を作成し、受入検証 14 検査に合格。公開サンプル(2027 年 1 月)を同じ版から抽出

2026-09-17 / koyomi-offering-api/1
暦の実体を追加。日・月の応答に entities(その日に立つ名前つきの実体)を足し、一覧 GET /entities(数えない)と GET /entities/{slug}?year=(数える)を追加。既存の項目・値・スキーマ名は変えていない

2026-09-17 / koyomi-offering-pack/1
納品パックに「暦の実体シート」(1 行 = 1 実体 × 1 日)を追加しました。これ以降に作成するパックに入ります。日別 CSV・日別 JSON・事象 CSV は変えていないので、すでにお渡ししているパックのファイルはそのままです

2026-09-17 / koyomi-offering-api/1
暦の実体を 26 から 37 に増やしました(春分の日・お彼岸・清明・穀雨・昭和の日・八十八夜・憲法記念日・みどりの日・こどもの日・立夏・母の日)。お彼岸は年 2 回で、返すのは入りの日です(中日は入りの 3 日後)。春分の日は日付を法律が定めず国立天文台の計算で決まるため、ground_truth.authority に国立天文台と内閣府の両方が入ります。既存の実体・項目・値は変えていません

2026-09-18 / koyomi-offering-api/1
暦の実体を 37 から 48 に増やしました(小満・芒種・入梅・父の日・夏至・半夏生・七夕・小暑・海の日・土用の丑の日・大暑)。土用の丑の日はどの資産にも名前が無く、夏の土用の範囲と日の十二支から組み立てた派生の実体です。二の丑がある年は 2 回返ります(1926-2080 の 155 年中 87 年)。既存の実体・項目・値は変えていません

2026-09-18 / koyomi-offering-api/1
暦の実体を 48 から 57 に増やしました(処暑・立秋・八朔・お盆・白露・中秋の名月・秋分の日・寒露・敬老の日)。お盆は月遅れ盆(8 月 13-16 日)の 4 日間を返します(7 月盆・旧暦盆の地域では日付が違うことを定義に書いてあります)。秋分の日は春分の日と同じく、日付を法律が定めず国立天文台の計算で決まります。既存の実体・項目・値は変えていません

2026-09-18 / koyomi-offering-api/1
暦の実体を 57 から 60 に増やしました(十日戎・小正月・灌仏会)。いずれも新暦の固定日で、地域や寺院で日付が割れるものは採らなかった日も definition に書いてあります。既存の実体・項目・値は変えていません

2026-09-18 / koyomi-offering-api/1
国民の祝日の実体に山の日が欠けていたのを追加しました(2016 年から。2020 年は 8 月 10 日、2021 年は 8 月 8 日の五輪特例)。これで kind=holiday の実体は現行法の 16 祝日すべてになります

2026-09-23 / koyomi-offering-api/1
暦の実体を 61 から 65 に増やしました(一粒万倍日・天赦日・寅の日・巳の日)。種別 kind=luckyday(吉日)を新設しています。年に何十回も立つので、/entities/{slug} の dates はその年の全件です(一粒万倍日は年 57〜64 回、天赦日は 5〜7 回、寅の日・巳の日は 30〜31 回。1926-2080 の実測)。日付は日別の luckydays と同じ正本から出しており、日の干支と節入りから組み直した値と 1926-2080 の全日で一致します。日・月の応答の entities には、その日に立つ吉日の実体が既存の実体の後ろに加わります。既存の実体・項目・値は変えていません

READ THE DETAILS

仕様書・項目辞書・検証記録

取得方法、項目の定義、検証結果をそれぞれの資料でご確認いただけます。

04 / PRICING

提供プランと料金

ファイル納品・API・制作サポートからお選びいただけます。
表示価格は税別です。現在、ご注文の受付は準備中です。

API導入相談受付

暦API

日・月単位の暦データをJSONで取得できます。

6,000円 / 月

1サービス・最低1か月

  • 標準7種類・2025〜2028年
  • 日・月単位のJSONと仕様書
  • 月100,000回・毎秒1回(予定)
  • 契約中の更新通知・メール窓口

提供開始前。API仕様書を見る ↗

APIの導入を相談する
CUSTOM個別対応

制作・組み込み

データ加工や制作・開発を、ご要望に合わせてお見積もりします。

個別見積

成果物と作業範囲に応じて

  • 必要な項目・形式への加工
  • カレンダーの独自レイアウト
  • Web・アプリへの組み込み
  • 追加データ・複数サービスの利用

形式・作業範囲・納期を伺ってご提案します。

制作・組み込みを相談する

APIは単独で契約できます。取得済みの値は、契約終了後も合意したサービスで利用できます。
将来の祝日は公表済み情報と推定を区別します。詳しくは利用条件をご確認ください。

AI アプリから使う(MCP)

Claude などの AI アプリから、同じ暦データを MCP(Model Context Protocol)で引けます。

MCP公開中

公開 MCP サーバー

AI の回答の事実確認に。どなたでも接続できます。

無料

登録・キー不要

  • ツール16本・1926〜2080年
  • 1つの接続元につき 1分60回・1日3,000回まで
  • 期間の指定は366日まで
  • 出典・照合方法つきの結果

https://bestcalendar.jp/mcp

接続方法を見る
MCP導入相談受付

法人向け MCP

自社の AI アプリ・社内ツールから、公開 MCP の回数の上限なしで。

6,000円 / 月

暦APIの契約に含みます

  • 暦APIと同じ専用のAPIキーで接続
  • 公開 MCP の回数の上限を外し、契約の回数で利用
  • 暦APIと同じデータ・出典・版情報
  • 契約中の更新通知・メール窓口

提供開始前。暦APIの提供開始にあわせてご利用いただけます。

MCP の利用を相談する

05 / TERMS

データの利用範囲と契約条件

基本の利用単位は1サービスです。納品パックを紙の制作に使う場合は、1出版シリーズを単位にご利用いただけます。納品済み・取得済みのデータは、合意した対象で継続利用できます。

利用するサービスの単位

基本単位は1サービス、紙の制作では1出版シリーズです。同一製品を構成するWeb・アプリを含み、画面数やドメイン数だけで追加料金を決めません。

制作会社による、合意した顧客への組み込み・納品に対応します。別の顧客や独立したサービスへの転用、データ自体を第三者へ販売・配布する商品への利用は別途ご相談ください。

納品パック

標準7種類の暦データは1対象年あたり30,000円・税別。納品後12か月は対象年の訂正通知と差し替えを含みます。納品済みのデータは、合意した対象で継続利用できます。

訂正対応の期間は利用期限ではありません。翌年版、対応期間終了後の更新、顧客側の制作物・プログラムの修正は別の扱いです。

API

月6,000円・税別、最低1か月、以後月単位。納品パックの購入は不要です。標準の対象は利用時点の前年〜翌々年の 4 暦年。現在の範囲は2025〜2028年です。

月100,000回・毎秒1回を予定しています。上限超過は制限し、合意のない従量追加課金はしません。開始日・仕様・解約手順は契約前にご案内します。

契約終了後も取得済みのデータは合意したサービスで利用できます。キーによる新規取得、更新通知、窓口対応は終了します。専用SLAや24時間の有人対応は標準料金に含みません。

公開サンプル

公開されたサンプルは、形式・収録項目・取り込み方法の評価や社内での試作にお使いください。具体的な利用条件はサンプルに同梱する案内もご確認ください。

既存の無料カレンダーや配布物には、それぞれの利用条件が適用されます。このページで過去の条件を変更するものではありません。

お申し込み・請求・訂正

メールでの相談だけで注文や課金は成立しません。用途・対象・金額・納期・請求方法を確認し、合意後に提供します。APIが利用可能になる前に利用料金を請求しません。

データの訂正は対象の日付・項目と版をご案内します。顧客側の表示・印刷物への反映作業は、個別に依頼された場合を除いて含みません。キャンセル・返金・責任範囲などの個別条件は発注前に確認します。

現在は注文受付の準備中です。正式な条件書・請求方法は、受付開始時にご案内します。

06 / GET STARTED

導入までの流れ

  1. 01

    サンプルを確認

    見本・収録項目を確認し、必要な形式と対象年を選びます。

  2. 02

    利用条件・見積もりを確認

    用途・金額・納期をご確認いただき、合意後にご発注いただきます。ご相談だけで料金は発生しません。

  3. 03

    データ・APIキーを受け取る

    ファイルまたはAPIキーを受け取り、制作物やシステムへの取り込みをご確認ください。

  4. 04

    利用を開始

    Web・アプリや印刷物などでご利用いただけます。訂正のご案内が届いた際は、内容をご確認のうえ反映してください。

FAQ

よくあるご質問

無料のカレンダーやAPIとの違いは?

業務で利用する暦データに、項目の定義・出典、版情報、訂正対応をまとめて提供します。祝日だけ、あるいは既存のカレンダーで十分な場合は、無料ツールもご利用いただけます。サイトに今日の六曜・吉日を表示するだけなら、HTML に 1 行貼る無料の暦ウィジェットも、AI アプリから同じ暦データを引ける無料の MCP サーバーもあります。

プログラミングは必要ですか?

CSVは表計算ソフトで確認できます。Web・アプリへの組み込みには実装が必要です。取り込みや制作も依頼したい場合は、制作・組み込みをご相談ください。

制作会社が顧客へ納品できますか?

合意した顧客のサービスへの組み込み・納品を含めます。別の顧客や独立した複数サービスへ転用する場合は、利用範囲をご相談ください。

AIを使った開発にも利用できますか?

仕様書とサンプルを実装の材料にできます。日付や暦の値は、生成した文章ではなく、取得したデータを参照してください。

九星や任意地点の天体データは入っていますか?

九星・十二直・二十八宿・潮汐は標準収録外です。追加の日月出入は47代表地点、天体配置は東京・JST 0時が基準です。

LET’S MAKE IT

導入・制作の
ご相談

用途や必要な項目、ご希望の納品形式をお聞かせください。
仕様がまだ決まっていなくても、ご相談いただけます。

contact@satyinc.co.jp ↗

株式会社SATY お問い合わせ先
現在はメールでご相談を受け付けています。

DOCUMENT PREVIEW

資料を見る