日本の祝日計算をAPI一本に——開発者が作った「Japanese Calendar API」
📌 掲載理由
開発効率化とAIエージェント信頼性向上の両面で実用価値が高い個人開発事例
毎回のプロジェクトで同じ祝日計算コードを書き直している開発者向けに、日本の祝日・営業日・暦情報を返すAPIとMCPサーバーが公開されました。AIエージェントとの連携も想定した設計になっています。
日本での開発業務では「発注から◯営業日後の納品日」「最短お届け日の計算」といった祝日関連の処理が頻繁に必要になります。EC、SaaS、社内ツール——プロジェクトが異なるたびに、同じような営業日計算ロジックを一からコーディングする羽目になるのが開発者の悩みでした。
この課題を解決するため、個人開発者が「Japanese Calendar API」を公開しました。内閣府が公開する公式の祝日CSVをデータソースとし、JSON・iCal・CSV・MCPなど複数の形式で配信します。
提供される機能は、祝日の判定・一覧・詳細メタ情報、営業日数のカウントと加算、販促向けイベント、暦注（六曜・旧暦・十干十二支など）、AIエージェント向けリモートMCPサーバーの5つのカテゴリーです。
LLMだけでは「3営業日後」「ゴールデンウィーク明けの最初の営業日」といった相対的な日付指定の結果にばらつきが出る問題も解決でき、AIエージェントの信頼性向上につながります。セットアップ不要で、curlやブラウザからすぐに試用可能です。
⚠️ 注意点
利用料金体系・レート制限・ダウンタイムSLAなど運用詳細は記事に未記載
参照元
Zenn AIカテゴリ
AI Picks
3つの視点から見た、この記事へのコメント
MCPサーバーの提供が秀逸です。内閣府CSVを正規化するミドルウェアとしてAPI化することで、振替休日や国民の休日の複雑なロジックを一箇所で管理できるのは大きい。ただ、セットアップから運用保守の責任がどこにあるか、アップストリーム（内閣府CSV）の更新タイミングとの同期方法が気になります。
毎プロジェクト同じコード再実装の手間削減、AIエージェントへの日付計算委譲による精度向上など、開発効率とサービス品質の両立が期待できます。ただ外部API依存となるため、サービス継続性・可用性の保証体制が事業モデルとして成立しているかの確認が重要です。
「◯営業日後の納品日計算」「支払期日の自動算出」など、実務で毎日使う計算が統一されるメリットは大きい。実装済み機能が豊富なのも良いですが、実際の導入時には既存システムとの連携方法、データ形式の変換、トラブル時のフォールバック対応などを事前に検討しておく必要があります。
※ AI Picks は Claude が記事内容を元に複数の視点で生成したコメントです。実在の人物・組織の見解を示すものではありません。
User Picks
この記事へのコメント
コメントを投稿するにはログインが必要です
Google でログインして Pick するまだコメントはありません。最初に Pick してみましょう。