cron-explainer

cron-explainer

cron 式を解析し、次回の N 回の実行時刻を返して、短い英語の説明を生成する、小規模な従量課金制 API です。タイムゾーン（IANA）に対応しています。

公開先： https://cron-explainer.cron-explainer-prod.workers.dev/ 料金： 呼び出し成功 1 回につき 0.01 EUR。Stripe Checkout で 500／5,000／50,000 回分を前払いします。2xx 以外の応答は返金されます。サブスクリプションはありません。キーの有効期限はありません。

クイックスタート

1. https://cron-explainer.cron-explainer-prod.workers.dev/ でキーを取得します（Stripe Checkout、最低 €5）。
2. キーをコピーします。一度だけ表示されます。
3. API を呼び出します。

curl -X POST https://cron-explainer.cron-explainer-prod.workers.dev/v1/explain \
  -H "content-type: application/json" \
  -H "x-api-key: $YOUR_KEY" \
  -d '{"cron":"0 9 * * 1-5","tz":"Europe/Lisbon","n":3}'

応答：

{
  "input": {"cron":"0 9 * * 1-5","tz":"Europe/Lisbon","n":3},
  "valid": true,
  "description": "At 09:00, Monday through Friday",
  "next": ["2026-04-24T08:00:00.000Z","2026-04-27T08:00:00.000Z","2026-04-28T08:00:00.000Z"],
  "flags": {"dst_transition_ahead": false, "ambiguous": false, "notes": []},
  "errors": []
}

残高を確認します。

curl -H "x-api-key: $YOUR_KEY" \
  https://cron-explainer.cron-explainer-prod.workers.dev/v1/balance

MCP

このサーバーは、io.github.IdoAzaCalls/cron-explainer として公式 MCP レジストリに登録されており、POST /mcp に Streamable HTTP エンドポイントがあります。explain_cron というツールを 1 つ公開しています。MCP トランスポートでは、x-api-key を HTTP ヘッダーとして渡してください。料金は REST と同じです。

レジストリエントリー：https://registry.modelcontextprotocol.io/v0/servers?search=cron-explainer

エンドポイント

メソッド	パス	用途
POST	/v1/explain	解析、説明、次回の実行時刻（課金対象）
GET	/v1/balance	x-api-key の残高
POST	/v1/checkout	Stripe Checkout セッションを作成
GET	/v1/schema	リクエスト／レスポンスの JSON Schema
POST	/mcp	MCP Streamable HTTP（JSON-RPC 2.0）
GET	/.well-known/mcp.json	静的ツールマニフェスト
GET	/health	稼働状態の確認
GET	/legal/{tos,privacy,disclaimer,notices}	法的文書

制限事項

• cron：5 フィールドの POSIX/Vixie 構文（分、時、月の日、月、曜日）。
• タイムゾーン：IANA 名（例：Europe/Lisbon、America/Los_Angeles）。デフォルトは UTC です。
• n は [1, 100] の範囲に制限されます。
• 精度はベストエフォートです。保証条件については /legal/disclaimer をご覧ください。
• 個人を特定できる情報は一切扱いません。入力は cron 文字列と IANA タイムゾーンのみです。リクエストおよびレスポンスの本文はログに記録されません。

技術スタック

Cloudflare Workers 上の TypeScript です。cron の解析には croner（MIT）を使用しています。英語の説明の生成には cronstrue（MIT）を使用しています。NOTICE 全文は /legal/notices にあります。

お問い合わせ

[email protected] — 請求に関する問題、バグ報告、個別料金のご相談。