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 會在團隊層級將金鑰集中到一個位置：
- 一把金鑰，多個專案。 你只需在連接器上儲存一次 BillionVerify API 金鑰。你連結到它的每個專案都能使用該金鑰，而且不會各自保留複本。
- 由你選擇誰可以使用。 連接器只會回應來自你連結之專案與環境的權杖請求。請參閱 Vercel 文件中的專案連結。
- 請求都會記錄。 每個連接器都有一個可觀測性分頁，會依專案、環境與主體記錄權杖請求。
- 輪替只需編輯一次。 在 BillionVerify 中建立新的金鑰、更新連接器，所有已連結的專案都會取得新金鑰。
對 AI 代理程式而言，這比傳統網頁應用程式更加重要。能夠呼叫工具的代理程式不應該能從其環境中讀取原始憑證。使用 Vercel Connect 時，代理程式的程式碼會在呼叫 BillionVerify 的當下請求金鑰，而金鑰永遠不會成為部署的一部分。
如何在 Vercel Connect 中找到 BillionVerify
有兩種方式可以進入 BillionVerify Vercel 連接器。兩者都會導向相同的設定流程。
從公開的 Vercel Connect 目錄
開啟 vercel.com/connect/browse，在搜尋框中輸入「billionverify」，或直接前往 vercel.com/connect/billionverify。該項目會顯示連線方式（API Key）及簡短說明：一次驗證一個電子郵件地址、批次驗證，或透過大量檔案上傳進行驗證。
從您的 Vercel 儀表板
如果您已登入 Vercel，請在團隊的儀表板中開啟 Connect，在搜尋欄位中輸入「billionverify」，然後從 All Connectors 中選取 BillionVerify。當您要設定已在 Vercel 上部署的專案時，這是最快捷的方式。
如何將 BillionVerify 連接器新增至您的 Vercel 專案
此連接器會使用您 BillionVerify 帳號中的 API 金鑰。如果您還沒有帳號，請先在 billionverify.com 註冊；免費方案每天使用帳號時可獲得 20 個額度，每月最多 600 個，且不需要信用卡。
步驟 1：建立 BillionVerify API 金鑰
登入並在您的 BillionVerify 控制面板中開啟 API Keys 頁面。建立金鑰，並為其命名以說明使用位置，例如 vercel-production，方便您稍後在使用記錄中辨識。
步驟 2：在 Vercel 中設定連線
在 Vercel Connect 中點選 BillionVerify 以開啟 Add Connection，然後填寫 Configure 步驟：
- 名稱。 Vercel 會建議一個隨機名稱，例如
chestnut-fence。請將其替換為您能辨識的名稱，例如billionverify-prod。它會與服務名稱共同組成程式碼所使用的連接器 ID：billionverify/billionverify-prod。 - UID（選填）。 保持空白，Vercel 會根據服務與連接器名稱產生 UID。
- Shared API Keys 或 Per-User API Keys。 Shared 會在連接器上儲存一個金鑰，供您應用程式的所有使用者使用。Per-User 會要求每位使用者在授權時提供自己的 BillionVerify 金鑰。下一節會說明何時選擇哪一種。
- Key。 貼上步驟 1 中的 API 金鑰。
- Scope and Expiration（選填）。 如果您的團隊會按照排程輪替金鑰，請設定到期時間；否則保留預設值。
點選 Create Connector 以儲存。
步驟 3：連結可能使用它的專案
將連接器連結至應獲准驗證電子郵件的 Vercel 專案與環境，例如您網頁應用程式的 production 與 preview，但不要連結至沒有理由呼叫 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 帳號和點數。
當您為擁有自己 BillionVerify 帳號的其他人建立產品時，請選擇 每位使用者的 API 金鑰，例如 CRM 外掛程式、冷開發電子郵件工具或代理程式範本。每位使用者會在授權期間提供自己的金鑰，因此他們的驗證會使用自己的點數，並顯示在各自的 BillionVerify 歷程中。
從你的程式碼呼叫 BillionVerify
在你的專案中安裝 Vercel Connect SDK：
npm install @vercel/connect
接著使用 getToken 請求金鑰，並將其傳送至 BV-API-KEY 標頭。以下是一個使用即時 SMTP 檢查單一地址的 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。註冊表單通常會封鎖無效和一次性地址、接受有效地址，並讓 catch-all 和 unknown 地址帶有標記通過，以便你觀察它們的行為。
SDK 會將金鑰快取在記憶體中並重複使用，因此不會在你驗證每個地址時都再次呼叫 Vercel Connect。
驗證批次地址或整個檔案
相同的金鑰適用於每個 BillionVerify 端點：
POST /v1/verify/single會檢查一個地址，如上所示。POST /v1/verify/bulk會在單一請求中檢查最多 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 參考。
程式碼中的每位使用者 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 上建立代理程式，請為它提供一個「驗證電子郵件」工具，讓其程式碼呼叫 getToken，接著呼叫 BillionVerify，完全比照上方的路由處理常式。模型會決定何時驗證地址；金鑰會留在 Vercel Connect 中，絕不會出現在提示、工具輸出或代理程式的環境中。
同一個 API 金鑰也能驅動我們其他的代理程式整合：
- MCP 伺服器。
BILLIONVERIFY_API_KEY=your-key npx billionverify-mcp會在本機執行我們的 MCP 伺服器，提供與託管版本相同的 11 個工具。每個用戶端的設定方式都列於 MCP 指南 中。 - 代理程式技能。 程式碼代理程式可以使用
npx skills add BillionVerify/billionverify-skill安裝 BillionVerify 技能。詳情請參閱 Agent Skills。
Credits 的運作方式
透過 Vercel connector 進行驗證的費用，與在 BillionVerify 的其他位置進行驗證相同：確定結果每筆需 1 個 credit。未知、一次性及格式錯誤的地址免費，在 24 小時內再次檢查相同地址也免費。Catch-all 地址會被回報為 catch-all，不會計入有效地址，因此您可以自行決定如何處理。
Vercel 會根據 Vercel Connect 定價，另外針對其自身的 token 請求收費。由於 SDK 會快取金鑰，通常 1 次 token 請求即可涵蓋多次驗證。
BillionVerify 也已加入 Claude
本月稍早，BillionVerify 已列入 Claude 的連接器目錄。如果您或您的團隊使用 Claude，現在可以透過帳號在其中連接 BillionVerify，不需要 API 金鑰，並在聊天中請 Claude 驗證地址，或清理最多 50 筆的清單。請閱讀 BillionVerify 現已加入 Claude 的連接器目錄 了解設定方式。
Claude 適合在您工作時檢查地址。Vercel 連接器則適合讓您自己的應用程式與代理程式自行執行檢查。
常見問題
什麼是 BillionVerify Vercel 連接器？
這是 BillionVerify 在 Vercel Connect 上的服務項目。您只需在連接器上儲存一次 BillionVerify API 金鑰，與其連結的 Vercel 專案就能在執行階段請求該金鑰，以呼叫 BillionVerify 電子郵件驗證 API。
我仍然需要將 API 金鑰放入環境變數嗎？
不需要。金鑰會儲存在連接器上。您的程式碼會透過 @vercel/connect 的 getToken 取得金鑰，而該函式會自動驗證您的部署與 Vercel Connect 的連線。
透過 Vercel 驗證電子郵件需要額外付費嗎？
BillionVerify 方面不需要。驗證會使用您 BillionVerify 帳戶中的額度，並依照正常費率計算。Vercel 會根據其 Vercel Connect 定價，針對自己的權杖請求收費。
我應該選擇 Shared API Keys 還是 Per-User API Keys？
如果是您自己的應用程式使用您的帳戶驗證地址，請選擇 Shared API Keys。如果您正在建立一項產品，而每位使用者都有自己的 BillionVerify 帳戶，並應自行支付驗證費用，請選擇 Per-User API Keys。
我可以在 Vercel 部署環境之外使用連接器嗎？
可以。在本機開發時，vercel env pull 會提供開發權杖。在其他環境中，例如外部 CI，您可以使用 vercelToken 選項，將 Vercel 存取權杖傳遞給 getToken。您也可以直接使用金鑰呼叫 BillionVerify API，而不使用 Vercel Connect。
Vercel 連接器能與代管的 MCP 伺服器搭配使用嗎？
位於 mcp.billionverify.com 的代管 MCP 伺服器會透過 OAuth 登入，這也是 Claude 連接器所使用的方式。Vercel 連接器則持有 API 金鑰，可與 REST API、billionverify-mcp npm 套件及代理程式技能搭配使用。
在 Vercel Connect 中新增 BillionVerify
開啟 vercel.com/connect/billionverify，貼上您的 BillionVerify API 金鑰，連結您的專案，並在下一筆註冊或潛在客戶進入您的名單前完成驗證。