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 키를 붙여 넣어 이메일 인증을 추가합니다. 프로젝트가 여러 개이고, preview 및 production 환경이 있으며, 해당 변수를 읽을 수 있는 사람이 몇 명 생기기 전까지는 이 방식이 작동합니다. 이후 키를 교체하려면 모든 복사본을 찾아야 합니다.
Vercel Connect는 키를 팀 수준의 한곳으로 이동합니다.
- 키 하나로 여러 프로젝트 사용. 커넥터에 BillionVerify API 키를 한 번 저장하면 됩니다. 연결한 모든 프로젝트가 키를 사용할 수 있으며, 각 프로젝트는 자체 복사본을 보관하지 않습니다.
- 사용자를 직접 선택. 커넥터는 연결한 프로젝트와 환경에서 들어오는 토큰 요청에만 응답합니다. Vercel 문서에서 프로젝트 연결을 확인하세요.
- 요청이 기록됩니다. 각 커넥터에는 프로젝트, 환경 및 주제별 토큰 요청을 기록하는 Observability 탭이 있습니다.
- 한 번의 수정으로 교체. 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"를 입력한 다음, 모든 커넥터에서 BillionVerify를 선택하세요. Vercel에서 이미 배포 중인 프로젝트를 설정할 때 가장 빠른 방법입니다.
Vercel 프로젝트에 BillionVerify 커넥터를 추가하는 방법
커넥터는 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 키를 제공하도록 요청합니다. 어떤 경우에 무엇을 선택해야 하는지는 다음 섹션에서 설명합니다.
- 키. 1단계에서 만든 API 키를 붙여 넣습니다.
- Scope 및 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 레퍼런스에서 확인할 수 있습니다.
코드에서 사용자별 키 사용
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개가 사용됩니다. 알 수 없음, 일회용 및 형식이 잘못된 주소는 무료이며, 24시간 이내에 동일한 주소를 다시 확인하는 것도 무료입니다. Catch-all 주소는 유효한 주소로 계산되지 않고 catch-all로 보고되므로, 처리 방식을 직접 결정할 수 있습니다.
Vercel은 Vercel Connect 가격에 따라 자체 토큰 요청에 별도로 요금을 부과합니다. SDK가 키를 캐시하므로 일반적으로 토큰 요청 1회로 여러 건을 검증할 수 있습니다.
BillionVerify는 Claude에도 있습니다
이달 초 BillionVerify는 Claude의 커넥터 디렉터리에 등록되었습니다. 여러분이나 팀이 Claude에서 작업한다면 계정으로 BillionVerify를 연결할 수 있으며, API 키 없이 채팅에서 Claude에게 주소를 검증하거나 최대 50개까지 목록을 정리하도록 요청할 수 있습니다. 설정 방법은 BillionVerify가 이제 Claude의 커넥터 디렉터리에 등록되었습니다에서 확인하세요.
Claude는 작업 중 주소를 확인할 때 사용합니다. Vercel 커넥터는 여러분의 앱과 에이전트가 자체적으로 실행하는 확인 작업을 위한 것입니다.
FAQ
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에 전달할 수 있습니다. 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 키를 붙여넣은 다음 프로젝트를 연결하세요. 목록에 추가되기 전에 다음 가입자 또는 리드를 확인할 수 있습니다.