Shirabe Calendar API — Endpoint Index
日本の暦情報(六曜・暦注・干支・二十四節気)と用途別吉凶判定を天文学的精度で返す AI ネイティブ REST API + MCP サーバーの endpoint hub ページです。 Free 枠 10,000 回/月 認証不要で即利用開始可能。
Status: Production v1.0.0 / 対応日付範囲: 1873-01-01 〜 2100-12-31 / 545+ tests passing / Cloudflare Workers + KV + Analytics Engine 稼働中。
Endpoints (3 種)
| HTTP Method | Path | 用途 |
|---|---|---|
GET |
/api/v1/calendar/{date} |
指定日(YYYY-MM-DD)の六曜・暦注・干支・二十四節気・用途別吉凶判定 |
GET |
/api/v1/calendar/range |
日付範囲一括取得(最大 93 日、?start=YYYY-MM-DD&end=YYYY-MM-DD) |
GET |
/api/v1/calendar/best-days |
用途別吉日ランキング(?purpose={wedding|funeral|moving|construction|business|car_delivery|marriage_registration|travel}&start=YYYY-MM-DD&end=YYYY-MM-DD) |
curl 例 / Examples
# 指定日の暦情報(認証不要、Free 枠 10,000 回/月)
curl https://shirabe.dev/api/v1/calendar/2026-06-15
# 日付範囲一括(最大 93 日)
curl "https://shirabe.dev/api/v1/calendar/range?start=2026-06-01&end=2026-06-30"
# 用途別吉日ランキング(2026 年 6 月の結婚式に良い日)
curl "https://shirabe.dev/api/v1/calendar/best-days?purpose=wedding&start=2026-06-01&end=2026-06-30"
# Starter 以上は X-API-Key ヘッダー認証
curl -H "X-API-Key: shrb_..." https://shirabe.dev/api/v1/calendar/2026-06-15AI 統合経路 / AI Integration Paths
- ChatGPT GPTs Actions: Shirabe 日本の暦 GPT 公開中、 短縮版 OpenAPI 3.1(description ≤ 300 字) も提供。
- Claude Tool Use / MCP: MCP エンドポイント に Claude Desktop 等の MCP クライアントから直接接続可能。
- Gemini Function Calling: OpenAPI 3.1 本家版(日英併記、x-llm-hint 付き)から自動スキーマ生成。
- LangChain / Dify: OpenAPI loader でそのまま使用可能、CORS 許可済。
- llms.txt 仕様: /llms.txt でサイト全体要約 + curl 例 + AI 向け hint を提供(暦 + 住所 + 7 月予定の text 統合版)。
料金プラン / Pricing
| プラン | 月間上限 | 単価 | レート制限 |
|---|---|---|---|
| Free | 10,000 回 | 無料 | 1 req/s |
| Starter | 500,000 回 | 0.05 円/回 | 30 req/s |
| Pro | 5,000,000 回 | 0.03 円/回 | 100 req/s |
| Enterprise | 無制限 | 0.01 円/回 | 500 req/s |
全プラン Free 枠 10,000 回/月、超過分のみ課金(Stripe Billing)。 アップグレードはこちら。
関連ドキュメント / Related
- OpenAPI 3.1 仕様(本家、日英併記 + x-llm-hint)
- OpenAPI 3.1 GPTs 短縮版(description ≤ 300 字)
- 六曜 API 完全ガイド
- 暦注 API 解説
- 2026-05-01 リリース告知(住所 API v1.0.0)
- llms.txt(LLM 向けサイト要約)
- GitHub リポジトリ
運営 / About
運営: 株式会社テックウェル(福岡)/ ドメイン: shirabe.dev / 利用規約 / プライバシーポリシー / 特定商取引法に基づく表記