BillionVerify は Vercel Connect に掲載されました。vercel.com/connect/billionverify を開くか、Vercel ダッシュボードの Connect で「BillionVerify」を検索し、BillionVerify API キーをコネクターに一度追加してください。その後、リンクした Vercel プロジェクトから実行時にメールアドレスを検証できます。コードが必要なときに Vercel Connect へキーを要求するため、キーが環境変数やソースコード内に保存されることはありません。
BillionVerify Vercel コネクターは、現在ご利用のものと同じ REST API、クレジット、検証履歴に対応しています。これは Claude コネクター の Vercel 版です。Claude ユーザーはチャットで尋ねてアドレスを検証し、Vercel 開発者は Vercel にデプロイしたサインアップフォーム、バックグラウンドジョブ、AI エージェントから検証できます。
メール検証に Vercel Connect を使う理由
ほとんどのチームは、各プロジェクトの環境変数に API キーを貼り付けてメール検証を追加します。これは、複数のプロジェクト、プレビュー環境と本番環境、そして環境変数を読み取れる複数のメンバーがいる場合に問題になります。キーをローテーションするには、すべてのコピーを探さなければなりません。
Vercel Connect は、チームレベルでキーを 1 か所に移動します。
- 1 つのキーを複数のプロジェクトで使用。 BillionVerify API キーをコネクタに 1 度保存するだけで済みます。リンクしたすべてのプロジェクトで使用でき、各プロジェクトが独自のコピーを保持することはありません。
- 使用者を選択できます。 コネクタは、リンクしたプロジェクトと環境からのトークンリクエストにのみ応答します。Vercel ドキュメントの プロジェクトリンク を参照してください。
- リクエストが記録されます。 各コネクタには Observability タブがあり、プロジェクト、環境、主体ごとにトークンリクエストを記録します。
- ローテーションは 1 回の編集で完了。 BillionVerify で新しいキーを作成し、コネクタを更新すると、リンクされたすべてのプロジェクトが新しいキーを取得します。
AI エージェントにとって、これは従来の Web アプリよりも重要です。ツールを呼び出せるエージェントが、環境から生の認証情報を読み取れる状態にすべきではありません。Vercel Connect を使うと、エージェントのコードは BillionVerify を呼び出す瞬間にキーをリクエストでき、キーがデプロイメントに含まれることはありません。
Vercel Connect で BillionVerify を見つける方法
BillionVerify Vercel コネクターにアクセスする方法は 2 つあります。どちらも同じ設定画面につながります。
公開 Vercel Connect ディレクトリから
vercel.com/connect/browse を開き、検索ボックスに「billionverify」と入力するか、vercel.com/connect/billionverify に直接アクセスします。リストには接続方法（API キー）と、「メールアドレスを 1 件ずつ、バッチで、または一括ファイルアップロードで検証できます」という簡単な説明が表示されます。
Vercel ダッシュボードから
Vercel にすでにサインインしている場合は、チームのダッシュボードで Connect を開き、検索フィールドに「billionverify」と入力して、「All Connectors」から BillionVerify を選択します。Vercel ですでにデプロイしているプロジェクトを設定する場合は、これが最も早い方法です。
Vercel プロジェクトに BillionVerify コネクターを追加する方法
このコネクターは、BillionVerify アカウントの API キーを使用します。まだアカウントをお持ちでない場合は、まず billionverify.com でサインアップ してください。無料プランでは、アカウントを使用する日に毎日 20 クレジット、月最大 600 クレジットを、クレジットカードなしで利用できます。
ステップ 1: BillionVerify API キーを作成する
サインインして、BillionVerify ダッシュボードの API キーページ を開きます。キーを作成し、「vercel-production」のように使用場所がわかる名前を付けてください。後で使用履歴から識別しやすくなります。
ステップ 2: Vercel で接続を設定する
Vercel Connect で BillionVerify をクリックして Add Connection を開き、Configure ステップの項目を入力します。
- Name。 Vercel は
chestnut-fenceのようなランダムな名前を提案します。billionverify-prodのように、識別しやすい名前に変更してください。サービス名と組み合わせて、コードが使用するコネクター ID が形成されます:billionverify/billionverify-prod。 - UID（任意）。 空のままにすると、Vercel がサービス名とコネクター名から生成します。
- Shared API Keys または Per-User API Keys。 Shared は、アプリのすべてのユーザー用に 1 つのキーをコネクターに保存します。Per-User は、認証時に各ユーザーへ自分の BillionVerify キーの入力を求めます。どちらを選ぶべきかは、次のセクションで説明します。
- Key。 ステップ 1 で作成した API キーを貼り付けます。
- Scope and Expiration（任意）。 チームがスケジュールに従ってキーをローテーションする場合は有効期限を設定し、それ以外の場合はデフォルトのままにします。
Create Connector をクリックして保存します。
ステップ 3: 使用を許可するプロジェクトをリンクする
メールを検証できるようにする Vercel プロジェクトと環境にコネクターをリンクします。たとえば、Web アプリの本番環境とプレビュー環境にはリンクしますが、BillionVerify を呼び出す理由のない社内ツールにはリンクしません。リンクされていないプロジェクトは、キーの代わりにエラーを受け取ります。
ターミナルを使いたい場合: Vercel CLI
同じ設定を Vercel CLI から行うこともできます。コネクターを使用するプロジェクトから実行します。
vercel link vercel connect create billionverify --name billionverify-prod vercel env pull
vercel env pull は有効期間の短い開発用トークンを .env.local にダウンロードするため、自分のマシンでアプリを実行するときも getToken が機能します。このファイルに保存されるのは Vercel トークンであり、BillionVerify キーではありません。
共有 API キーまたはユーザーごとの API キー？
共有 API キー は、自社製品で検証を行う場合に選択します。使い捨てアドレスを拒否する登録フォーム、新しいリードを毎晩クリーンアップするジョブ、チームが使用する内部エージェントなどが該当します。すべての検証で、お客様の BillionVerify アカウントとクレジットが使用されます。
ユーザーごとの API キー は、独自の BillionVerify アカウントを持つ他のユーザー向けに製品を構築する場合に選択します。たとえば、CRM アドオン、コールドメールツール、エージェントテンプレートなどです。各ユーザーは認証時に自分のキーを使用するため、検証には各自のクレジットが使われ、各自の BillionVerify 履歴に表示されます。
コードから BillionVerify を呼び出す
プロジェクトに Vercel Connect SDK をインストールします：
npm install @vercel/connect
次に、getToken でキーを取得し、BV-API-KEY ヘッダーで送信します。以下は、ライブ SMTP チェックで 1 件のアドレスを確認する Next.js のルートハンドラーです：
// app/api/verify-email/route.ts
import { getToken } from '@vercel/connect';
export async function POST(req: Request) {
const { email } = await req.json();
const apiKey = await getToken('billionverify/billionverify-prod', {
subject: { type: 'app' },
});
const res = await fetch('https://api.billionverify.com/v1/verify/single', {
method: 'POST',
headers: { 'BV-API-KEY': apiKey, 'Content-Type': 'application/json' },
body: JSON.stringify({ email, check_smtp: true }),
});
const body = await res.json();
return Response.json(body.data);
}
レスポンスの data オブジェクトには、status（valid、invalid、catchall、role、disposable、unknown のいずれか）、is_deliverable、is_disposable、is_catchall、is_role、および reason が含まれます。通常、登録フォームでは invalid と disposable のアドレスをブロックし、valid のアドレスを受け入れます。また、catch-all と unknown のアドレスはフラグ付きで通過させ、動作を監視できるようにします。
SDK はキーをメモリにキャッシュして再利用するため、検証するアドレスごとに Vercel Connect を再度呼び出すことはありません。
バッチまたはファイル全体を検証する
同じキーをすべての BillionVerify エンドポイントで使用できます：
POST /v1/verify/singleは、上記のように 1 件のアドレスを確認します。POST /v1/verify/bulkは、1 回のリクエストで最大 50 件のアドレスを確認します。{"emails": [...], "check_smtp": true}を送信します。POST /v1/verify/fileは、バックグラウンドジョブ用に CSV をアップロードします。GET /v1/verify/file/{id}をポーリングし、GET /v1/verify/file/{id}/resultsから結果をダウンロードします。
Vercel でよく使われるパターンは、cron ジョブでその日に追加された新しいリードを収集し、50 件ずつ /v1/verify/bulk に送信して、ステータスをデータベースに書き戻す方法です。リクエストとレスポンスの詳細は、API リファレンス に記載されています。
コードでユーザーごとのキーを使用する
Per-User API Keys では、サインインしているユーザーの ID を subject として渡します：
const apiKey = await getToken('billionverify/billionverify-prod', {
subject: { type: 'user', id: session.user.id },
});
そのユーザーがまだキーを提供していない場合、SDK は UserAuthorizationRequiredError をスローします。これを捕捉し、 UI に「BillionVerify アカウントを接続する」ステップを表示します。その他のエラークラスは、Vercel の トークンドキュメント に一覧されています。
Vercel で AI エージェントに BillionVerify を使用する
Vercel 上でエージェントを構築する場合は、上記の route handler と同様に、コードが getToken を呼び出してから BillionVerify を呼び出す「メールを検証」ツールを用意します。検証するタイミングはモデルが判断し、キーは Vercel Connect に保持されるため、プロンプト、ツール出力、エージェントの環境には決して表示されません。
同じ API キーで、他のエージェント統合も利用できます。
- MCP サーバー。
BILLIONVERIFY_API_KEY=your-key npx billionverify-mcpを実行すると、ホスト版と同じ 11 個のツールを備えた MCP サーバーをローカルで起動できます。各クライアントのセットアップ方法は MCP ガイドに記載されています。 - エージェントスキル。 コーディングエージェントには、
npx skills add BillionVerify/billionverify-skillで BillionVerify スキルをインストールできます。詳しくは エージェントスキルをご覧ください。
クレジットの仕組み
Vercel コネクタを通じた検証の料金は、BillionVerify の他の場所で検証する場合と同じです。確定した結果 1 件につき 1 クレジットが必要です。不明、使い捨て、形式が不適切なアドレスは無料で、24 時間以内に同じアドレスを再度チェックする場合も無料です。キャッチオールアドレスは有効と数えず、キャッチオールとして報告されるため、どのように扱うかを判断できます。
Vercel は、Vercel Connect の料金に従い、独自のトークンリクエストを別途請求します。SDK がキーをキャッシュするため、通常は 1 回のトークンリクエストで多数の検証に対応できます。
BillionVerify は Claude にも対応
今月初め、BillionVerify が Claude のコネクターディレクトリに掲載されました。あなたやチームが Claude で作業している場合、アカウントを使ってそこで BillionVerify に接続できます。API キーは不要で、チャットからアドレスの検証や、最大 50 件のリストのクリーンアップを Claude に依頼できます。設定方法は、BillionVerify が Claude のコネクターディレクトリに掲載されました をご覧ください。
Claude は作業中にアドレスを確認するためのものです。Vercel コネクターは、あなた自身のアプリやエージェントが独自に実行するチェック用です。
よくある質問
BillionVerify Vercel コネクタとは何ですか？
BillionVerify の Vercel Connect への掲載です。コネクタに BillionVerify API キーを 1 回保存すると、リンクした Vercel プロジェクトが実行時にそのキーを取得し、BillionVerify のメール検証 API を呼び出せます。
それでも環境変数に API キーを設定する必要がありますか？
いいえ。キーはコネクタに保存されます。コードでは @vercel/connect の getToken を使って取得でき、デプロイメントの Vercel Connect への認証は自動的に行われます。
Vercel 経由でメールを検証すると追加料金がかかりますか？
BillionVerify 側ではかかりません。検証には BillionVerify アカウントのクレジットが通常のレートで使用されます。Vercel は、Vercel Connect の料金体系に基づき、独自のトークンリクエストに対して料金を請求します。
共有 API キーとユーザーごとの API キーのどちらを選ぶべきですか？
自分のアプリで自分のアカウントを使ってアドレスを検証する場合は、共有 API キーを選択します。各ユーザーがそれぞれ自分の BillionVerify アカウントを持ち、自分の検証料金を支払う製品を構築する場合は、ユーザーごとの API キーを選択します。
Vercel デプロイメントの外部でコネクタを使用できますか？
はい。ローカル開発では、vercel env pull によって開発用トークンを取得できます。外部 CI などの他の環境では、vercelToken オプションを使って Vercel アクセストークンを getToken に渡せます。Vercel Connect を使わず、キーで BillionVerify API を直接呼び出すこともできます。
Vercel コネクタはホスト型 MCP サーバーと連携しますか？
mcp.billionverify.com のホスト型 MCP サーバーは OAuth でサインインします。これは Claude コネクタが使用する方式です。Vercel コネクタは API キーを保持し、REST API、billionverify-mcp npm パッケージ、エージェントスキルで利用できます。
Vercel Connect に BillionVerify を追加
vercel.com/connect/billionverify を開き、BillionVerify API キーを貼り付けてプロジェクトをリンクし、次のサインアップまたはリードがリストに追加される前に検証します。