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 置信度	风险评估