Shirabe Calendar Api

What is Shirabe Calendar API?

Shirabe Calendar API is a REST API and MCP server that provides astronomical-quality Japanese calendar data (rokuyo, rekichu, kanshi, 24 solar terms, lunar date, Japanese era) and purpose-specific auspiciousness judgments with 1–10 scores. It is designed for AI-native applications and integrates seamlessly with ChatGPT, Claude, Gemini, LangChain, and other AI frameworks.

How to use Shirabe Calendar API?

Get started with the free tier (10,000 requests/month) by calling endpoints directly via curl with the X-API-Key header, or without a key for anonymous access. For MCP, add the server to claude_desktop_config.json or use the Streamable HTTP URL. Code examples in TypeScript and Python are provided in the quick start.

Key features of Shirabe Calendar API

• Returns 8 purpose-specific auspicious day scores from 1–10
• Provides 13 types of rekichu (such as 一粒万倍日 and 天赦日)
• Covers the date range 1873-01-01 to 2100-12-31
• Exposes three main endpoints: date, range, and best-days
• Fully compliant with OpenAPI 3.1 and MCP protocol
• Supports AI agent integration via GPTs, Claude, Gemini, and LangChain

Use cases of Shirabe Calendar API

• AI chatbot for wedding venues that recommends optimal dates
• Moving company AI that scores customer requested dates and suggests alternatives
• Fortune telling SaaS that automatically annotates birthdays and