邮箱批量验证器(语法/MX/一次性域名)
批量验证邮箱地址:RFC 5322 语法 → DNS MX(含 A 记录兜底与 null MX)→ 一次性域名黑名单、角色账号、免费邮箱识别、+tag 检测。不做 SMTP 邮箱验证(与原 Actor 一致),需要邮箱级判断的地址返回 unknown/smtp_timeout。每地址一条扁平 JSON,11 项 checks 全量在场,永不 null,确定性评分
概览
批量验证邮箱地址,与 Apify Actor sumitr_mardy/email-verifier 同能力:
RFC 5322 语法 → DNS MX(A 记录兜底 / RFC 7505 null MX)→ 一次性域名黑名单 / 角色账号 / 免费邮箱 / +tag 检测。
不做 SMTP 邮箱级验证(与原 Actor 一致):需要邮箱级判断的地址返回 unknown/smtp_timeout,绝不猜测。
输入
| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
emails | string[] | [] | 要验证的邮箱地址 |
emailFileUrl | string | — | .txt(每行一个)或 .csv 文件 URL,文件中所有邮箱形态 token 都会被提取;与 emails 叠加 |
concurrency | integer 1–50 | 15 | 域名并行检查数(地址按域名分组,同域名只解析一次) |
verbose | boolean | false | 附带 raw 块(MX 列表、A 记录、缓存命中) |
输出(每地址一条,字段永不为 null)
email(原样回显)/normalized_email(小写、去 +tag、Gmail 折叠点号)/domainstatus(固定四值:deliverable/undeliverable/risky/unknown)+sub_status+scorechecks:11 项布尔全量在场(未执行为 false,原因在 sub_status)mx_record(最高优先级 MX)+verified_at+duration_mserror仅unknown/internal_error时出现;raw仅 verbose 时出现
状态 × 原因(本应用实际返回)
| status | sub_status | 分值 |
|---|---|---|
| undeliverable | invalid_syntax | 0 |
| undeliverable | no_mx_record(无 MX 无 A,或 null MX) | 0 |
| risky | disposable(一次性域名,终结性判断,不花 SMTP 预算) | 20 |
| risky | free_provider_unverifiable(Gmail/Outlook 等,域名级判断) | 55 |
| unknown | smtp_timeout(商业域名需邮箱级判断 / 解析器 SERVFAIL) | 30 |
| unknown | internal_error(单地址异常,附 error 字段) | 0 |
优先级:disposable 终结 → 免费邮箱按域名判定 → 角色账号只影响 checks.role_based → 商业域名统一 unknown/smtp_timeout。 解析器故障不是结论:SERVFAIL/超时 → unknown,绝不误判为 no_mx_record。
运行结束状态消息
包含 KPI:验证总数、status/sub_status 分布、域名数与缓存命中、unknown 率。
边界
- SMTP 邮箱级验证不做 → 永不返回 deliverable / mailbox_not_found / catch_all
- 一次性黑名单构建时内置公开 disposable-email-domains 列表(约 1 万域名),运行时尽力刷新
- MX 跨运行缓存为进程内实现(平台无 KV 存储),同一运行内同域名只解析一次
适用边界
不含 SMTP 邮箱级验证(本应用从不确认邮箱存在,绝不返回 deliverable/mailbox_not_found/catch_all,此设计与原 Actor 一致);商业域名上仅凭语法/MX/名单可判的结论会被给出,需邮箱级判断的返回 unknown/smtp_timeout(低分值 30);DNS 解析器故障(SERVFAIL/超时)记为 unknown 而不是误判为域名不存在;一次性域名黑名单构建时内置公开列表(约 1 万域名)并尽力运行时刷新;MX 跨运行缓存为进程内实现(无 KV 存储),同一运行内同域名只解析一次
- 适合用于
- 发信前批量过滤掉必然错误的地址:语法错误、无 MX、一次性域名
- 识别免费邮箱(Gmail/Outlook 等)与角色账号(info@/support@),做分层外联策略
- 清洗 Google Maps/网页抓取得到的线索邮箱,降低退信率
- 不要用于
- 需要确认某个邮箱真的存在(需 SMTP 邮箱级验证,本应用与原 Actor 均不做)
- 判断 catch-all 域名上的邮箱是否有效(同上)
- 给单个邮箱打'有效'标签——本应用对商业域名统一返回 unknown/smtp_timeout 而不是猜测
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1单地址异常只影响该地址:返回 unknown/internal_error 并附 error 字段,绝不中断运行、绝不丢记录
- 2emailFileUrl 不可达或超 10MB 时跳过该文件(记录日志),仅用 emails 数组继续
- 3emails 与 emailFileUrl 都没有地址时运行直接失败并提示,不产生任何记录
- 4DNS 解析器故障(SERVFAIL/超时)→ unknown/smtp_timeout,绝不误判为 no_mx_record
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 邮箱列表
emails选填array<string>要验证的邮箱地址列表示例["john@example.com","info@apify.com","someone@gmail.com","test@mailinator.com"] - 邮箱文件 URL
emailFileUrl选填string指向 .txt(每行一个)或 .csv 文件的 URL,文件中所有邮箱形态的 token 都会被提取;与 emails 数组叠加使用 - 并发数
concurrency选填integer域名并行检查数;地址先按域名分组,每个域名只解析一次范围1–50默认值15示例15 - 详细输出
verbose选填boolean为 true 时每条记录附带 raw 块(MX 列表、A 记录、缓存命中)。默认关闭以保持输出精简默认值false示例false
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 原始邮箱
emailstring输入原样回显(即使语法失败) - 归一化邮箱
normalized_emailstring小写;去掉 +tag;Gmail 折叠点号;无法解析时为空串,永不为 null - 域名
domainstring小写域名,或空串。永不为 null - 结论
statusstring固定四值之一:deliverable / undeliverable / risky / unknown(本应用不做 SMTP,故不返回 deliverable)示例undeliverable
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"email": "<email>",
"normalized_email": "<normalized_email>",
"domain": "<domain>",
"status": "undeliverable",
"sub_status": "invalid_syntax",
"score": 0,
"checks": "<checks>",
"mx_record": "<mx_record>",
"verified_at": "<verified_at>",
"duration_ms": 0,
"error": "<error>",
"raw": "<raw>"
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderByte/email-verifier",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。