ZeroBounce 邮箱验证与分析

要解决的问题

邮件列表质量、验证结果、活动记录、API 用量和额度余额散落在 ZeroBounce 控制台里。当你想把注册校验、列表清洗或消耗监控写进脚本时，手动复制数据既脆弱又难以追溯；直接对接 API 还要处理 token、重试和密钥泄漏风险。这个技能通过 OOMOL 连接 ZeroBounce，由服务端注入凭证，让你用 oo CLI 完成这些操作。

技能如何工作

它不是另起一套接口，而是对 ZeroBounce connector 的薄封装：不猜测参数，先取 live schema，再执行 connector action。

• 每个 action 都有 reference 文件说明用途和命令；构造 payload 前先读它。
• 用 oo connector schema 获取当前 action 的输入/输出契约。
• 通过 --data 传入 JSON 对象（字符串或 @path/to/file.json）；省略则发送 {}。
• 返回结构为 {"data": ..., "meta": {"executionId": "..."}}，执行 id 在 meta.executionId，可用于追踪。

暴露 6 个 action：

• validate_email：实时验证单个邮箱地址。
• get_activity_data：查询某个邮箱地址的活动数据。
• get_api_usage：按日期范围读取 API 用量指标。
• get_credit_balance：读取当前 credit 余额。
• list_filter_rules：列出自定义 allow/block 过滤规则。
• create_filter_rule：创建或更新一条自定义 allow/block 过滤规则。

适用边界与注意点

前提是 oo CLI 已安装、已登录，且 ZeroBounce 已连接。不要主动执行 oo auth login 或打开连接 URL；只有命令因认证或连接错误失败时，才回退到一次性初始化。

读取类 action（get/list）可直接运行。写入类会改变 ZeroBounce 状态：对 create_filter_rule，运行前必须与用户确认精确 payload 和影响。删除或移除类操作具有破坏性，必须先确认目标并取得明确批准。

凭证由 OOMOL 注入，但 ZeroBounce 侧仍会消耗 credit；关注用量时用 get_credit_balance 和 get_api_usage 观察。该技能聚焦邮箱验证与活动分析，不是通用数据管道或邮件发送工具。