BillionVerify теперь — коннектор Vercel Connect

Теперь BillionVerify доступен в Vercel Connect. Откройте vercel.com/connect/billionverify или найдите «BillionVerify» в разделе Connect на панели управления Vercel и один раз добавьте свой ключ BillionVerify API в коннектор. После этого любой подключённый вами проект Vercel сможет проверять адреса электронной почты во время выполнения: ваш код запрашивает ключ у Vercel Connect, когда он нужен, поэтому ключ никогда не хранится в переменной окружения или исходном коде.

Коннектор BillionVerify для Vercel работает с теми же REST API, кредитами и историей проверок, которыми вы уже пользуетесь. Это аналог нашего коннектора Claude для Vercel: пользователи Claude проверяют адреса, задавая вопросы в чате, а разработчики Vercel проверяют их через формы регистрации, фоновые задачи и AI-агентов, которых они разворачивают в Vercel.

Зачем использовать Vercel Connect для проверки email

Большинство команд добавляют проверку email, вставляя API key в переменные окружения каждого проекта. Это работает, пока у вас несколько проектов, preview- и production-окружения и несколько людей, которые могут читать эти переменные. При ротации ключа приходится искать каждую его копию.

Vercel Connect перемещает ключ в одно место на уровне команды:

Один ключ — много проектов. Вы один раз сохраняете свой BillionVerify API key в коннекторе. Каждый подключённый к нему проект может его использовать, и ни один из них не хранит собственную копию.
Вы выбираете, кто может его использовать. Коннектор отвечает на запросы токена только от проектов и окружений, которые вы к нему подключили. См. ссылки на проекты в документации Vercel.
Запросы регистрируются. На каждом коннекторе есть вкладка Observability, где фиксируются запросы токенов по проекту, окружению и субъекту.
Ротация — одно изменение. Создайте новый ключ в BillionVerify, обновите коннектор — и каждый подключённый проект получит его.

Для AI-агентов это важнее, чем для классического веб-приложения. Агент, который может вызывать инструменты, не должен иметь возможности читать исходные учётные данные из своего окружения. С Vercel Connect код агента запрашивает ключ в момент вызова BillionVerify, и ключ никогда не становится частью развёртывания.

Как найти BillionVerify в Vercel Connect

Есть два способа открыть коннектор BillionVerify в Vercel. Оба ведут к одной и той же настройке.

Из публичного каталога Vercel Connect

Откройте vercel.com/connect/browse и введите «billionverify» в поле поиска или сразу перейдите на страницу vercel.com/connect/billionverify. В карточке указаны способ подключения (ключ API) и краткое описание: проверка адресов электронной почты по одному, пакетами или с помощью загрузки файла.

Коннектор BillionVerify для Vercel в каталоге Vercel Connect, найденный по запросу billionverify на vercel.com/connect/browse

Из панели управления Vercel

Если вы уже вошли в Vercel, откройте Connect на панели управления своей команды, введите «billionverify» в поле поиска и выберите BillionVerify в разделе «Все коннекторы». Это самый быстрый способ, если вы настраиваете проект, который уже развёрнут в Vercel.

Коннектор BillionVerify для Vercel в поиске коннекторов панели управления Vercel в разделе «Все коннекторы»

Как добавить коннектор BillionVerify в проект Vercel

Коннектор использует API-ключ из вашей учётной записи BillionVerify. Если у вас ещё нет учётной записи, сначала зарегистрируйтесь на billionverify.com; бесплатный план даёт 20 кредитов за каждый день использования учётной записи — до 600 в месяц, без банковской карты.

Шаг 1: Создайте API-ключ BillionVerify

Войдите в систему и откройте страницу API-ключей в панели управления BillionVerify. Создайте ключ и назовите его так, чтобы было понятно, где он используется, например «vercel-production», — так его будет проще распознать позже в истории использования.

Шаг 2: Настройте подключение в Vercel

Нажмите BillionVerify в Vercel Connect, чтобы открыть Add Connection, затем заполните шаг Configure:

Name. Vercel предлагает случайное имя, например chestnut-fence. Замените его на узнаваемое, например billionverify-prod. Вместе с сервисом оно образует идентификатор коннектора, который использует ваш код: billionverify/billionverify-prod.
UID (необязательно). Оставьте поле пустым, и Vercel создаст UID из названия сервиса и коннектора.
Shared API Keys или Per-User API Keys. Shared сохраняет один ключ в коннекторе для всех пользователей вашего приложения. Per-User предлагает каждому пользователю указать собственный ключ BillionVerify при авторизации. В следующем разделе объясняется, какой вариант выбрать.
Key. Вставьте API-ключ из шага 1.
Scope and Expiration (необязательно). Установите срок действия, если ваша команда регулярно меняет ключи; в противном случае оставьте значения по умолчанию.

Нажмите Create Connector, чтобы сохранить его.

Диалог Add Connection коннектора BillionVerify для Vercel с вариантами Shared API Keys и Per-User API Keys и полем Key

Шаг 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 и ваши кредиты.

Выбирайте API-ключи для каждого пользователя, если вы создаёте продукт для других людей, у которых есть собственные аккаунты BillionVerify, например дополнение для CRM, инструмент для холодных рассылок или шаблон агента. Каждый пользователь добавляет собственный ключ при авторизации, поэтому его проверки используют его собственные кредиты и отображаются в его собственной истории BillionVerify.

Вызов BillionVerify из вашего кода

Установите Vercel Connect SDK в свой проект:

npm install @vercel/connect

Затем запросите ключ с помощью getToken и передайте его в заголовке BV-API-KEY. Ниже приведён обработчик маршрута Next.js, который проверяет один адрес с помощью активной проверки SMTP:

// 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 и неизвестные пропускает с флагом, чтобы можно было отслеживать их поведение.

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-задача, которая собирает новые лиды за день, отправляет их на /v1/verify/bulk группами по 50 и записывает статус обратно в базу данных. Подробности запросов и ответов приведены в справочнике API.

Пользовательские ключи в коде

При использовании Per-User API Keys передайте ID вошедшего в систему пользователя в качестве subject:

const apiKey = await getToken('billionverify/billionverify-prod', {
  subject: { type: 'user', id: session.user.id },
});

Если этот пользователь ещё не предоставил ключ, SDK выдаст UserAuthorizationRequiredError. Перехватите эту ошибку и покажите в интерфейсе шаг «Подключите свою учётную запись BillionVerify». Остальные классы ошибок перечислены в документации Vercel по токенам.

Используйте BillionVerify в AI-агентах на Vercel

Если вы создаёте агента на Vercel, добавьте ему инструмент «проверить email», код которого вызывает getToken, а затем BillionVerify — точно так же, как обработчик маршрута выше. Модель решает, когда проверять адрес; ключ хранится в Vercel Connect и никогда не появляется в промпте, выводе инструмента или окружении агента.

Этот же API-ключ также обеспечивает работу других интеграций с агентами:

MCP-сервер. BILLIONVERIFY_API_KEY=your-key npx billionverify-mcp запускает наш MCP-сервер локально с теми же 11 инструментами, что и размещённая версия. Настройка для каждого клиента приведена в руководстве по MCP.
Навык агента. Кодирующие агенты могут установить навык BillionVerify с помощью npx skills add BillionVerify/billionverify-skill. Подробнее — в разделе Навыки агентов.

Как работают кредиты

Проверка через коннектор Vercel стоит столько же, сколько проверка в любом другом месте BillionVerify: один кредит за определённый результат. Неизвестные, одноразовые и неправильно отформатированные адреса бесплатны, как и повторная проверка того же адреса в течение 24 часов. Адреса catch-all отображаются как catch-all и не считаются действительными, поэтому вы сами решаете, как с ними поступать.

Vercel отдельно оплачивает собственные запросы токенов согласно тарифам Vercel Connect. Поскольку SDK кэширует ключ, одного запроса токена обычно хватает для множества проверок.

BillionVerify теперь доступен и в Claude

Ранее в этом месяце BillionVerify появился в каталоге коннекторов Claude. Если вы или ваша команда работаете в Claude, вы можете подключить BillionVerify там к своему аккаунту без API-ключа и попросить Claude проверить адрес или очистить список до 50 адресов прямо в чате. Инструкции по настройке смотрите в статье BillionVerify появился в каталоге коннекторов Claude.

Claude предназначен для проверки адресов во время работы. Коннектор Vercel — для проверок, которые ваши собственные приложения и агенты выполняют самостоятельно.

Часто задаваемые вопросы

Что такое коннектор BillionVerify для Vercel?

Это список BillionVerify в Vercel Connect. Вы один раз сохраняете свой API-ключ BillionVerify в коннекторе, после чего связанные с ним проекты Vercel могут запрашивать этот ключ во время выполнения для вызова API проверки email-адресов BillionVerify.

Нужно ли по-прежнему добавлять API-ключ в переменные окружения?

Нет. Ключ хранится в коннекторе. Ваш код получает его с помощью getToken из @vercel/connect, который автоматически аутентифицирует ваше развёртывание в Vercel Connect.

Взимается ли дополнительная плата за проверку email-адресов через Vercel?

Со стороны BillionVerify — нет. Проверки используют кредиты в вашем аккаунте BillionVerify по обычному тарифу. Vercel взимает плату за собственные запросы токенов согласно тарифам Vercel Connect.

Что выбрать: Shared API Keys или Per-User API Keys?

Shared API Keys — если ваше собственное приложение проверяет адреса с помощью вашего аккаунта. Per-User API Keys — если вы создаёте продукт, пользователи которого имеют собственные аккаунты BillionVerify и должны оплачивать свои проверки.

Можно ли использовать коннектор за пределами развёртывания Vercel?

Да. Для локальной разработки команда vercel env pull предоставляет токен разработки. В других окружениях, например во внешнем CI, можно передать токен доступа Vercel в getToken с параметром vercelToken. Также можно напрямую вызывать API BillionVerify с вашим ключом, без Vercel Connect.

Работает ли коннектор Vercel с размещённым MCP-сервером?

Размещённый MCP-сервер по адресу mcp.billionverify.com выполняет вход с помощью OAuth — именно это использует коннектор Claude. Коннектор Vercel хранит API-ключ, который работает с REST API, npm-пакетом billionverify-mcp и навыком агента.

Добавьте BillionVerify в Vercel Connect

Откройте vercel.com/connect/billionverify, вставьте свой ключ API BillionVerify, подключите проект и проверьте следующую регистрацию или лид до того, как он попадёт в ваш список.