核心用法
mailbox-bot 是一个面向AI代理的实体邮件API服务，解决数字工作流与物理世界强制要求的脱节问题。核心能力分为两大已上线工作流：
1. 外发邮件API — 通过 POST /v1/mail 提交PDF/DOCX，后端设施完成打印、装封、贴邮票、投递，返回照片凭证。支持USPS First Class（$1.00起）、Certified Mail（$8.98）、Certified+回执（$13.38）、Priority、FedEx、UPS；批量发送最高10,000份。
2. 入站文档上下文API — 用户现有地址收到的邮件经 forward.mailbox.bot 别名转发后，自动拍照、扫描、OCR提取内容。代理可通过 /v1/inbound 读取、/v1/postal-threads 关联历史上下文，并调用 POST /v1/mail 发送带关联ID的物理回复，形成"数字-物理-数字"闭环。
3. 真实邮寄地址（waitlist） — street+box number 的实体邮箱目前仅限南加州、犹他、内华达的私测用户，需身份验证+邮政授权+设施审批。
显著优点
- 法律强制场景覆盖：LLC注册、法院传票、IRS税务通知、合规审计——这些必须纸质处理的场景首次可被代理自动化
- 多协议集成：REST API、MCP（29个工具）、A2A（v0.3）、OpenClad Agent Card + WebSocket，适配各类AI框架
- 安全沙盒：
sk_agent_test_密钥可在生产端点零成本测试，真实费用预览、完整Webhook模拟、生命周期推进 - 成本管控：
X-Max-Cost-Cents头、dry_run模式、force_approval策略、每日发送上限 - 上下文记忆：
MAILBOX.md规则文件、标签/注释系统、postal threads 串联往来邮件
潜在缺点与局限
- 地理限制严重：真实收件地址仅限美西三州私测，其他地区仅能用"现有地址转发"模式
- 人工审批瓶颈：KYC需真人手机（拒VoIP）、信用卡（拒预付卡）、邮箱验证，无法纯代理完成开户
- 成本结构复杂：基础$1.00/页，彩色+$0.25/页，Certified/Priority/FedEx/UPS阶梯定价，批量折扣阈值分散（500/1000/5000）
- 测试与生产数据隔离：沙盒数据不会迁移至生产，需重新配置
- 无国际邮寄：USPS境内及部分FedEx/UPS服务，未提及其他国家邮政
适合人群
- 法律科技/合规自动化团队：需批量处理传票、政府通知、审计邮件
- 企业服务自动化：LLC集群管理、注册地址托管、税务响应代理
- 物业/房地产运营：多房产分账邮箱、自动处理违规通知、租约续约
- 供应商对账自动化：发票-采购单-合同的三方纸质确认流程
常规风险
- 身份冒用风险：开户需真人KYC，但代理密钥一旦泄露可被滥发法律信函
- 地址合规风险：用于注册代理的地址若未获邮政授权，可能导致法律文书送达无效
- 成本超支风险：批量任务误配置彩色打印或Priority等级可能快速累积费用
- 送达证明争议：Certified Mail回执为设施级凭证，非USPS电子回执，法庭认可度需预先确认
- 数据驻留：扫描文档存储位置、保留期限、删除策略未在文档中明确披露