Shirabe Calendar Api

Name: Shirabe Calendar Api
Author: techwell-inc-jp

@techwell-inc-jp

关于 Shirabe Calendar Api

Japanese calendar data API for AI agents. Provides Rokuyo, Rekichu (13 types), Kanshi, 24 Sekki, and fortune judgments for 8 categories (wedding, business, moving, etc.). MCP + REST API.

#japanese #calendar #rokuyo #rekichu #fortune #mcp #api

基本信息

分类

开发工具

传输方式

stdio

发布者

techwell-inc-jp

提交者

Shirabe-dev-sys

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "shirabe-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@shirabe-api/calendar-mcp"
      ],
      "env": {
        "SHIRABE_API_KEY": "your-api-key-here"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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