AI Guides

統合方法	最適な用途	セットアップの複雑さ	ユースケース
MCPサーバー	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 キー付きローカル stdio サーバーしかサポートしない場合は、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

# AI解析用のJSON出力
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の信頼度	リスク評価