Agent Skills
返回列表
Mailbox 实体邮件 API

Mailbox 实体邮件 API

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-mailbox-bot。

技能介绍

问题从哪来

智能体可以起草合同、跑工作流,但一到实体邮件就会断档:法院要求认证信、政府函件寄到真实地址、LLC 注册地址、IRS 纸质回复——这些都不在纯数字链路里。mailbox.bot 把出站寄信和入站文档上下文做成 API,让代理能在同一套「邮政线程」里读写物理世界。

技能如何工作

当前已上线两条主路径:

  • 出站物理邮件:POST /v1/mail 提交 PDF/DOCX 等,设施打印、装封、贴邮并寄出,支持 Certified、Priority、FedEx/UPS 及 CSV 批量(最高约 1 万封)。
  • 入站上下文(非新分配街址):用 GET /v1/inbound-forwarding-addresses 获取转发别名,经 forward.mailbox.bot 把操作者已有地址上的扫描、照片、PDF、人工备注汇入;GET /v1/inbound/:id?include=drafting 取提取结果与 draft_context;/v1/postal-threads* 把入站捕获与出站发送串成一条线程,再带 inbound_capture_id 发关联回信。

接入方式包括 REST(https://mailbox.bot/api/v1)、MCP(29 工具)、A2A 与 OpenClaw。可用 MAILBOX.md 写常驻规则;requires_approval=true 或规则标注需审批时,在控制台人工放行。测试密钥 sk_agent_test_ 走全量校验与费用预览,不扣款、不真寄。

边界与注意

真实邮寄邮箱地址(街址 + 邮箱号、到件拍照/OCR/代操作)仍在 waitlist/私测,与「默认入站转发别名」是两条产品线;Southern California 先行。代理不得未经人工同意代开户:优先引导操作者到 https://mailbox.bot/signup 或 auth.md 流程。入站默认是数字 intake,不是新分配的法定邮寄地址。

使用场景

  • 多家 LLC 注册 PDF 已就绪,需代理通过 `POST /v1/mail` 寄出认证函,并把操作者现有地址转发来的盖章回件挂到同一 `postal-threads` 线程。
  • 操作者常用办公地址收到 IRS 或政府纸质通知,经 `forward.mailbox.bot` 入站捕获后,代理提取 `draft_context` 并在截止日前发送关联纸质回复。
  • 物业管理收到违规或租约相关来函扫描,代理读取 `/v1/inbound*` 分类后,按 `MAILBOX.md` 规则起草并寄出给租户或业主的出站信函。
  • 合规审计需对监管函件做扫描归档:入站分类路由到责任人,出站认证信带 `inbound_capture_id` 留完整邮政往来记录。

适合人员

  • 同时推进多家主体注册与纸质备案的创业者,需要代理代寄章程/通知并处理已有地址转发来的盖章回件扫描。
  • 处理认证信与政府函件时限的法务或合规专员,希望在控制台对 `requires_approval=true` 的出站动作做人工放行。
  • 管理多物业、各址来函格式不一的运营商,要用私有入站转发别名汇总扫描并触发关联出站通知或续签函。
  • 在 Agent 平台里接 MCP 的集成工程师,要把 mailbox.bot 的入站上下文、出站寄信与 webhook 状态回调接进现有对话工作流。