postbag

Name: postbag
Author: postbag.dev

本地服务

postbag.dev开发工具05 周前更新

代码仓库访问官网

关于 postbag

Postbag 是面向多网站表单的后端服务，也供构建网站的 AI Agent 使用。它将提交集中管理，并通过可重试的投递流程路由到邮件、Telegram、Webhook、合作方或 CRM。

主要功能

01接收并集中管理网站表单提交
02将不同表单字段映射为统一结构
03将数据路由到邮件、Telegram 或 Webhook
04通过持久发件箱和重试投递

适用场景

01将多个网站的表单汇入同一数据流
02向合作方发送标准化表单数据
03确保提交在投递失败后仍可重试

MCP 相关

README 提及 MIT 许可的 `@postbag/mcp` 客户端包，但未说明其 MCP 工具或连接方式。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "dev-postbag": {
      "command": "npx",
      "args": [
        "-y",
        "@postbag/mcp"
      ],
      "env": {
        "POSTBAG_API_KEY": "<POSTBAG_API_KEY>",
        "POSTBAG_API_URL": "<POSTBAG_API_URL>"
      }
    }
  }
}

启动命令npx -y @postbag/mcp

需要配置的环境变量

POSTBAG_API_KEY密钥A Postbag API key (pb_live_… or pb_test_…). Mint one at https://postbag.dev/app or with `postbag login`.

POSTBAG_API_URLBase URL of the Postbag API. Defaults to https://postbag.dev — set this only for a self-hosted instance.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@postbag/mcp0.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Postbag

会路由的表单后端。 将任意 HTML 表单指向 Postbag 端点，提交内容就会进入你的收件箱，然后被发送到该去的地方：电子邮件、Telegram、webhook、合作伙伴或 CRM。专为运营多个网站的人，以及构建这些网站的 AI Agent 打造。

<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>

这就是一个表单的全部集成。其他所有功能——将四十个表单归为一个流、把它们不同的字段映射为统一结构、在两个日期之间将该结构发送给合作伙伴、每日摘要、绝不丢失提交内容——都能在需要时使用，不需要时则不会打扰你。

初次使用（无论你是人类还是 AI Agent）？请先阅读 CLAUDE.md。

为什么要开发它

每个网站都有表单，每个表单都需要一个去处。Formspree 等服务可以为单个网站解决“去处”问题；但当十五个网站要将数据发送给同一个合作伙伴，且各自的表单略有不同时，它们就难以应对。Postbag 是每个表单收集哪些内容、每个下游系统接收哪些内容，以及它们之间版本化契约的真实数据源。

核心理念

数据库保证正确性；事件提升速度。

提交内容一旦成为一条记录，就会立即被接收。投递通过持久化发件箱实现，由工作进程不断处理并重试。实时通知只是加速手段，绝不是传输机制。即使系统中的所有事件流都停止工作，每条提交内容仍然会送达——可能晚一些，但绝不会丢失。（此设计继承自本项目推广通用化的线索处理管道；详见 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。