402cron

402cron — 面向 AI Agent 的 cron，按交付次数付费

402cron 按 cron 计划调用你的 HTTPS 端点，为每个请求签名，并重试失败的请求。 Agent 可以自行设置：无需账户、银行卡，也无需人工介入。付款方式为 x402 — Base 上的 USDC — 唯一身份标识就是付款的钱包。

此仓库包含文档和可运行示例。服务运行于 https://402cron.com；其源代码未公开。

链接

• https://402cron.com — 服务
• https://402cron.com/docs — 机器可读文档（JSON；试试 ?section=quickstart）
• https://402cron.com/openapi.json — OpenAPI 3.1
• https://402cron.com/llms.txt — 面向模型的服务说明
• https://402cron.com/mcp — 远程 MCP 服务（可流式传输的 HTTP），已列入官方 MCP Registry，名称为 com.402cron/402cron
• https://402cron.com/.well-known/agent-card.json — A2A Agent 卡片
• https://402cron.com/api/pricing — 机器可读的价格表
• https://402cron.com/terms — 条款 · [email protected]

延伸阅读

• 无人投诉：面向 AI Agent 的付费 API 的 28 种静默故障：介绍 x402 付款标头、Agent 目录、A2A 卡片以及从 Cloudflare Workers 发起调用，并逐一说明原因、修复方法和检查方式。如果你正在构建自己的付费 Agent API，这篇文章会很有帮助。

定价

套餐	价格	交付次数	每次交付费用
trial	$0.02	20	$0.001
starter	$1	2,000	$0.0005
month	$25	50,000	$0.0005

余额按交付次数计算，而不是按金额计算，且永不过期。每次交付尝试消耗一个额度，因此失败的交付最多花费三个额度。当前价格：https://402cron.com/api/pricing。

工作原理

1. 购买。 GET https://402cron.com/buy/trial 会返回 402，并在 PAYMENT-REQUIRED 标头中提供价格。使用任意 x402 客户端付款。收据中包含管理 令牌，该令牌仅显示一次。
2. 注册。 使用 {"url": "https://your.host/hook"} 调用 POST /api/destinations，返回 目标 ID 和签名密钥，二者均仅显示一次。
3. 验证。 调用 POST /api/destinations/{id}/verify。我们会向你的 URL 发送一个质询，而你的 端点会将其原样返回。之后，权限将覆盖该路径及其下的所有路径。
4. 安排计划。 使用 {"name", "url", "cron", "body"} 调用 POST /api/tasks。响应会显示 接下来的三次运行时间。

管理请求需要 Authorization: Bearer <token>。令牌丢失了？使用同一个钱包再次购买，并添加 ?rotate=1；旧令牌将失效。

你的端点会收到什么

同一个 URL 会收到三种请求。可通过 X-402cron-Event 区分：

X-402cron-Event	时间	已签名	你的端点应当
verify	调用 /verify 时一次	否	在 5 s 内以 X-402cron-Challenge 的值作为响应正文
delivery	按计划执行、重试以及调用 /run 时	是	检查签名，并在 2 s 内返回 2xx
task_paused	任务暂停时一次	是	读取 reasonCode，修复原因，并 POST 到 resume URL

签名格式为 X-402cron-Signature: sha256=<hex>，它是使用你的签名密钥计算的 HMAC-SHA256， 计算对象为以下字节：

{X-402cron-Timestamp}\n{X-402cron-Delivery-Id}\n{X-402cron-Attempt}\n{METHOD}\n{path+query}\n{raw body}

事件标签本身未签名：可以根据它进行分支处理，但只能信任签名所覆盖的内容。交付采用 至少一次机制 — 同一个 X-402cron-Delivery-Id 可能会收到两次，因此应将重复请求视为 已处理。交付还会附带 X-402cron-Task-Id 和 X-402cron-Deliveries-Left。

重试与暂停

• 请求超时或主机无法访问时会重试：最多 3 次，间隔 60 秒和 120 秒。
• 4xx 或 5xx 是服务器的响应，因此不会重试。
• 连续失败 3 次、连续收到 20 次拒绝，或连续出现 10 次服务器错误时，任务会暂停。你会收到一条 task_paused 通知；恢复任务只需调用一次。

限制

• cron：5 个字段，始终使用 UTC，最短间隔为 1 分钟。支持名称（MON-FRI、JAN）和宏 （@daily、@hourly，……）；不支持的内容会被拒绝，并附上说明原因的代码。
• 目标地址必须使用 https://。
• 请求正文最大为 64 KB，自定义标头最大为 8 KB。

所有限制：https://402cron.com/docs?section=limits

示例

文件夹	内容	运行方式
receiver/node	目标端点，无依赖项	SECRET_402CRON=… node server.mjs
receiver/python	同上，仅使用标准库	SECRET_402CRON=… python server.py
client	使用 x402 购买试用、注册、验证并安排任务	npm install，然后运行 DRY_RUN=1 node buy-and-schedule.mjs

两个接收端都会响应质询、验证签名、丢弃重复投递，并记录暂停通知。客户端像任何标准 x402 客户端一样，从 PAYMENT-REQUIRED 标头读取价格，限制可支出的金额（MAX_USD，默认为 $0.05）；使用 DRY_RUN=1 时会进行签名，但不会付款。在 Windows PowerShell 中，先使用 $env:SECRET_402CRON="…" 设置变量。

在 MCP 客户端中使用

Claude Code：

claude mcp add --transport http 402cron https://402cron.com/mcp --header "Authorization: Bearer <token>"

其他客户端：添加一个指向 https://402cron.com/mcp 的远程（可流式传输的 HTTP）服务，并使用相同的标头。无需令牌即可使用 get_pricing、get_docs 和 get_service_status。特意不提供购买工具：请通过普通 HTTP 付款，因为签名付款不应经过模型的上下文。

保证

我们保证已尝试投递你的任务，但不保证其他服务器会如何处理。完整条款：https://402cron.com/terms

许可证

本仓库中的示例采用 MIT 许可证，详见 LICENSE。