技能介绍

解决什么问题

批量运营场景里，无效邮箱会直接吃掉营销预算和交付率。注册接口收到一次性临时邮箱、客服系统被 mailinator.com 这类地址刷爆、EDM 发送名单里混入大量无法投递的地址，这些问题如果不过滤，要么转化率失真，要么退回率触发发送方信誉惩罚。

oo-mailbox-validator 通过 oo CLI 调用 MailboxValidator，在数据入库或发送之前对单个邮箱地址做一次快速判定，输出三个关键信号：是否来自临时邮箱服务商、是否来自免费邮箱服务商、以及该地址的可投递性状态。适合用在注册校验、名单清洗、线索分级这类环节。

核心能力

validate_email：对单个邮箱地址执行完整验证，返回 MailboxValidator 的可投递性信号（MX 记录、SMTP 探测等）。
check_disposable_email：判断地址是否注册在一次性邮箱服务商名下。
check_free_email：判断地址是否属于免费邮箱服务商，可用于线索分级。

调用方式统一：先用 oo connector schema 拿到当前连接器的实时输入 schema，再构造符合 schema 的 JSON payload 传给 --data。响应结构固定为 { "data": ..., "meta": { "executionId": "..." } }，执行 ID 在 meta.executionId 下，便于做日志追踪或异步轮询。

运行流程

确认目标动作是 validate_email、check_disposable_email 或 check_free_email 之一。
拉取该 action 的 schema，检查必填字段和取值约束。
构造 payload（可以是内联 JSON，也可以是 @path/to/file.json）执行 action。
从 data 字段读取结果，从 meta.executionId 记录本次执行。

凭据由 OOMOL 服务端注入，本地不需要保管 API key。常规情况下直接执行即可；只有在命令报认证或连接类错误时，才走一次性的 OOMOL 登录或重新授权流程。

注意点

本技能只做单地址级别的查询，不提供批量导入或并发限流管理，需要批量处理时需在外部循环调用。邮箱可投递性受目标邮件服务器策略影响，验证通过不代表一定收得到，结果应视为概率信号而非保证。免费邮箱检测依赖服务商名单更新，新出现的服务商可能暂时未覆盖。涉及创建、更新类动作时，执行前需与用户确认 payload 内容，破坏性操作必须得到明确同意。