核心用法
mailbox.bot 是一个专为 AI 智能体设计的物理物流基础设施服务。用户通过 KYC 验证后获得专属仓库地址和参考编码，即可让智能体像调用普通 API 一样管理实体包裹流转。
关键工作流程
1. 身份验证与地址分配：通过 Stripe Identity 完成 KYC，获取唯一参考编码（如 MB-7F3A）和仓库收货地址
2. 包裹投递：在电商平台结账时使用 facility 地址 + 参考编码，支持 FedEx、UPS、DHL、Amazon、OnTrac 等主流私人承运商
3. 自动化处理：包裹到达后自动完成扫描、称重、尺寸测量和高清拍照，生成结构化数据
4. 智能决策：通过 webhook 实时推送 JSON 数据，智能体可调用 API 执行转发、存储、深度扫描或退货操作
API 能力矩阵
| 功能 | 端点 | 认证要求 |
|------|------|----------|
| 加入等待名单 | POST /api/v1/waitlist | 无需认证 |
| 包裹列表查询 | GET /api/v1/packages | Bearer Token |
| 包裹详情获取 | GET /api/v1/packages/{id} | Bearer Token || 转发请求 | POST /api/v1/packages/{id}/forward | Bearer Token |显著优点
- 协议兼容性强：原生支持 MCP（Model Context Protocol）、A2A（Agent-to-Agent）、OpenClaw 和标准 REST 四种协议，适配各类智能体架构
- 零代码基础设施：无需自建仓库或集成多家物流 API，单个端点覆盖收货、文档化、通知、转发全流程
- 实时数据结构化： webhook 推送包含重量、尺寸、多视角高清照片、承运商信息，可直接进入智能体决策流
- 退货自动化：出站包裹自动生成退货路由，退件按参考编码原路返回智能体，无需人工干预
- 多层级定价：从免费 Endpoint Only 到定制 Enterprise，覆盖个人开发者到企业级部署
潜在缺点与局限性
- USPS 限制：明确不接受 USPS 邮件，仅限私人承运商，可能增加部分电商平台运费成本
- 地理限制：仓库地址固定，跨国转运可能产生额外费用和时效延迟
- KYC 门槛：强制身份验证流程对匿名或隐私敏感场景不适用
- 存储期限：基础套餐仅 14 天免费存储，超期需付费或面临处置
- v1.0 早期阶段：服务处于刚上线状态，API 稳定性、覆盖区域、承运商网络仍在扩展中
适合人群
- 硬件采购自动化：AI 智能体自主订购传感器、开发板、服务器组件
- 边缘计算部署：远程站点设备到货、验收、转发的无人化管理
- 法律/金融文档处理：通过私人快递接收纸质合同，自动扫描归档
- 电商退货代理：自动化 RMA 处理和退货路由
- 多节点物流协调：Swarm 套餐适合分布式团队或设备网络管理
常规风险
- 数据隐私：包裹外观照片和元数据存储于第三方服务器，敏感商业信息需谨慎评估
- 服务连续性：初创公司运营，存在业务调整或终止风险，关键业务建议保留备用物流方案
- 合规边界：作为托管服务（bailee）而非邮政代理，在特定司法管辖区可能存在监管解释差异
- API 密钥安全：Bearer Token 泄露可导致包裹信息暴露和未经授权的转发操作，需按生产密钥标准保管