402cron

402cron — AI エージェント向けの cron、配信ごとの従量課金

402cron は cron スケジュールに従って HTTPS エンドポイントを呼び出し、すべてのリクエストに署名し、失敗したリクエストを再試行します。 エージェントが自分で設定できます。アカウントもカードも不要で、人間が介在する必要もありません。支払いには 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 エージェントカード
• https://402cron.com/api/pricing — 機械可読な料金表
• https://402cron.com/terms — 利用規約 · [email protected]

詳細情報

• 誰も苦情を言わない：AI エージェント向け有料 API の 28 件のサイレント障害：x402 の支払いヘッダー、エージェントカタログ、A2A カード、Cloudflare Workers からの呼び出しについて、それぞれ原因、修正方法、問題を検出するチェック方法を説明しています。エージェント向けの独自の有料 API を構築する場合に役立ちます。

料金

パック	価格	配信数	1 配信あたり
trial	$0.02	20	$0.001
starter	$1	2,000	$0.0005
month	$25	50,000	$0.0005

残高は金額ではなく配信数で計算され、有効期限はありません。配信の試行ごとにクレジットを 1 つ消費するため、配信に失敗した場合の費用は最大 3 クレジットです。現在の料金：https://402cron.com/api/pricing

仕組み

1. 購入。 GET https://402cron.com/buy/trial は、PAYMENT-REQUIRED ヘッダーに価格を含めて 402 を返します。任意の x402 クライアントで支払えます。レシートには管理トークンが含まれ、一度だけ表示されます。
2. 登録。 {"url": "https://your.host/hook"} を指定して POST /api/destinations を呼び出すと、宛先 ID と署名シークレットが返されます。どちらも一度だけ表示されます。
3. 検証。 POST /api/destinations/{id}/verify を呼び出します。指定した URL にチャレンジを POST し、エンドポイントがそれをそのまま返します。この権限はそのパスと、その配下すべてを対象とします。
4. スケジュール設定。 {"name", "url", "cron", "body"} を指定して POST /api/tasks を呼び出します。レスポンスには次の 3 回の実行予定が表示されます。

管理用の呼び出しでは Authorization: Bearer <token> を指定します。トークンを紛失した場合は、同じウォレットから ?rotate=1 を付けて再購入してください。以前のトークンは使えなくなります。

エンドポイントが受け取る内容

同じ URL に 3 種類のリクエストが届きます。X-402cron-Event で判別できます。

X-402cron-Event	タイミング	署名	エンドポイントで行うこと
verify	/verify の呼び出し時に 1 回	なし	X-402cron-Challenge の値を本文として、5 秒以内に返す
delivery	スケジュール実行時、再試行時、/run の呼び出し時	あり	署名を検証し、2 秒以内に 2xx を返す
task_paused	タスクの一時停止時に 1 回	あり	reasonCode を確認し、原因を修正して、resume URL に POST する

署名は 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}

イベントラベルには署名がありません。ラベルに応じて処理を分岐しても、信頼できるのは署名の対象となる内容だけです。配信は少なくとも 1 回行われるため、同じ X-402cron-Delivery-Id が 2 回届くことがあります。重複した配信は処理済みとして扱ってください。配信には X-402cron-Task-Id と X-402cron-Deliveries-Left も含まれます。

再試行と一時停止

• タイムアウトまたはホストに到達できない場合は再試行します。最大3回で、間隔は60秒、120秒です。
• 4xx または 5xx はサーバーからの応答であるため、再試行しません。
• 3回連続の失敗、20回連続の拒否、または10回連続のサーバーエラーが発生すると、タスクは一時停止します。task_paused 通知が1回届き、再開は1回の呼び出しで行えます。

制限

• 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をご覧ください。