postbag

Postbag

ルーティング機能を備えたフォームバックエンドです。 あらゆるHTMLフォームの送信先をPostbagのエンドポイントに指定すると、送信内容が受信トレイに届きます。その後は、メール、Telegram、Webhook、パートナー、CRMなど、必要な場所へ送信できます。多くのサイトを運営する人と、それらを構築するAIエージェントのために作られています。

<form action="https://api.postbag.dev/s/fm_8f3kq2" method="POST">
  <input name="email" type="email" required>
  <textarea name="message"></textarea>
  <button>Send</button>
</form>

フォーム1つの連携はこれだけです。40個のフォームを1つのストリームにまとめること、異なるフィールドを共通の形式にマッピングすること、2つの日付の間にその形式のデータをパートナーへ送信すること、日次ダイジェスト、送信内容を決して失わない仕組みなどは、必要なときに利用でき、不要なときには意識せずに済みます。

初めての方（人間でもAIエージェントでも）は、まず CLAUDE.md をお読みください。

存在する理由

どのWebサイトにもフォームがあります。どのフォームにも、送信先が必要です。Formspreeなどは1つのサイトの「送信先」を解決しますが、15個のサイトから、少しずつ異なるフォームを使って1つのパートナーへデータを送るような状況では対応できません。Postbagは、各フォームで収集する内容、各下流システムが受け取る内容、そしてその間のバージョン管理された契約の信頼できる唯一の情報源です。

1つの考え方

データベースが正確性を担保し、イベントが処理を高速化します。

送信内容は、データベースの行として記録された時点ですぐに受理されます。配信は永続的なアウトボックスに保存され、ワーカーがリトライしながら処理します。リアルタイム通知は処理を高速化しますが、決してデータの転送手段にはなりません。システム内のすべてのイベントストリームが停止しても、すべての送信内容は遅れて届くことはあっても、失われることはありません。（この仕組みは、一般化の元となったリードパイプラインから受け継いでいます。詳しくは docs/ARCHITECTURE.md を参照してください。）

ステータス

フェーズ1 — MVP公開中：postbag.dev（サイト、ドキュメント、/app のダッシュボード、/v1 のAPI）。公開中の設計図は PROGRESS.md、各フェーズについては docs/ROADMAP.md をご覧ください。

ドキュメント

docs/README.md から始めてください。

ライセンス

サーバー、ダッシュボード、サイト、ドメインパッケージ（apps/*、packages/core、packages/db、packages/auth）はAGPL-3.0のライセンスで提供されます。お使いのコード内で実行するクライアントパッケージ（@postbag/sdk、postbag CLI、@postbag/mcp）はMITのライセンスで提供されます。ライセンスの根拠はADR-006をご覧ください。