cron-explainer

cron-explainer

一个小型按次付费 API，可解析 cron 表达式，返回接下来 N 次触发时间，并生成简短的英文说明。支持时区（IANA）。

在线服务： https://cron-explainer.cron-explainer-prod.workers.dev/ 定价： 每次成功调用收费 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

该服务已列入官方 MCP 注册表，名称为 io.github.IdoAzaCalls/cron-explainer，并提供位于 POST /mcp 的 Streamable HTTP 端点。它提供一个工具 explain_cron。在 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。
• 不收集任何 PII：输入仅包含 cron 字符串和 IANA 时区。绝不记录请求和响应正文。

技术栈

使用 Cloudflare Workers 上的 TypeScript。Cron 解析通过 croner（MIT）实现。英文说明通过 cronstrue（MIT）生成。完整 NOTICE 文本见 /legal/notices。

联系方式

[email protected] — 计费问题、错误报告、自定义定价。