AI Guides

集成方式	最适合	设置复杂度	使用场景
MCP Server	Claude Desktop/Code 用户	低	自然语言验证
AI SDK	自定义 AI 应用	中	构建 AI 驱动的应用
代理技能	AI 代理框架	中	自动化工作流
CLI 工具	终端用户、脚本	低	开发工作流、自动化

快速开始

选项 1：面向 ChatGPT 和 Claude 用户的远程 MCP（推荐）

如果你的客户端支持基于 HTTP 的远程 MCP，请使用 BillionVerify 的托管端点：

https://mcp.billionverify.com/mcp

对于 Claude Code，请运行：

claude mcp add --transport http billionverify https://mcp.billionverify.com/mcp

然后在 Claude Code 中运行 /mcp，并在浏览器里完成 OAuth。

如果你的客户端只支持带 API key 的本地 stdio Server，请改用 BillionVerify CLI 或 REST API。

方式 2: AI SDK 工具用于开发者

构建自定义 AI 应用?将邮箱验证添加为工具:

import { tool } from 'ai';
import { z } from 'zod';

const verifyEmailTool = tool({
  description: 'Verify if an email address is valid and deliverable',
  parameters: z.object({
    email: z.string().email(),
  }),
  execute: async ({ email }) => {
    const response = await fetch(
      'https://api.billionverify.com/v1/verify/single',
      {
        method: 'POST',
        headers: {
          'BV-API-KEY': process.env.BV_API_KEY,
          'Content-Type': 'application/json',
        },
        body: JSON.stringify({ email }),
      },
    );
    return response.json();
  },
});

方式 3: CLI 用于终端用户

# 安装
npm install -g billionverify

# 配置
bv config set api-key YOUR_API_KEY

# 验证
bv verify john@example.com

# JSON 输出供 AI 解析
bv verify john@example.com --json

支持的 AI 平台

兼容 MCP 的客户端

客户端	状态	描述
Claude Desktop	支持	Mac/Windows 桌面应用
Claude Code	支持	CLI 编程助手
Cursor	支持	AI 代码编辑器
Zed	支持	高性能编辑器
Cline (VS Code)	支持	VS Code AI 扩展
Continue	支持	开源 AI 助手

AI SDK 和框架

框架	集成方式
Vercel AI SDK	工具调用
LangChain	自定义工具
OpenAI Functions	函数调用
Anthropic Tools	工具使用
CrewAI	工具定义
AutoGPT	插件

CLI 工具

工具	描述
Claude Code	Anthropic 的 CLI 助手
Gemini CLI	Google 的终端 AI
Codex CLI	OpenAI 代码生成
OpenCode	开源 AI 助手
Droid	开发者终端助手

价值场景

场景	描述	价值
销售线索清理	AI 验证 CRM 潜在客户邮箱	提高送达率
注册表单	实时阻止无效/一次性邮箱	减少虚假注册
数据迁移	批量验证导入的历史数据	确保数据质量
营销活动	发送前验证邮箱列表	降低退信率
开发测试	AI 助手验证测试邮箱	提高开发效率

API 快速参考

用于 AI 集成,使用以下 API 端点:

单个验证

curl -X POST https://api.billionverify.com/v1/verify/single \
  -H "BV-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

响应:

{
  "email": "test@example.com",
  "status": "valid",
  "result": {
    "deliverable": true,
    "disposable": false,
    "role": false
  },
  "score": 0.95
}

关键响应字段

字段	描述	AI 解读
`status`	valid、invalid、unknown	主要决策字段
`deliverable`	能否接收邮件	可以发送吗?
`disposable`	临时邮箱	阻止注册?
`role`	info@、support@ 等	共享邮箱警告
`score`	0-1 置信度	风险评估