BillionVerify ist jetzt ein Vercel-Connect-Connector

BillionVerify ist jetzt in Vercel Connect gelistet. Öffnen Sie vercel.com/connect/billionverify oder suchen Sie in Ihrem Vercel-Dashboard unter Connect nach „BillionVerify“ und fügen Sie Ihren BillionVerify API-Schlüssel einmalig zu einem Connector hinzu. Danach kann jedes von Ihnen verknüpfte Vercel-Projekt E-Mail-Adressen zur Laufzeit verifizieren: Ihr Code fragt Vercel Connect nach dem Schlüssel, wenn er ihn benötigt, sodass der Schlüssel niemals in einer Umgebungsvariablen oder Ihrem Quellcode gespeichert ist.

Der BillionVerify Vercel-Connector funktioniert mit derselben REST API, denselben Credits und derselben Verifizierungshistorie, die Sie bereits verwenden. Er ist das Vercel-Gegenstück zu unserem Claude-Connector: Claude-Nutzer verifizieren Adressen, indem sie im Chat danach fragen, und Vercel-Entwickler verifizieren sie über Registrierungsformulare, Hintergrundaufgaben und KI-Agenten, die sie auf Vercel bereitstellen.

Warum Vercel Connect für die E-Mail-Verifizierung verwenden

Die meisten Teams fügen E-Mail-Verifizierung hinzu, indem sie einen API-Schlüssel in die Umgebungsvariablen jedes Projekts einfügen. Das funktioniert, bis Sie mehrere Projekte, Vorschau- und Produktionsumgebungen sowie einige Personen haben, die diese Variablen lesen können. Das Rotieren des Schlüssels bedeutet dann, jede Kopie finden zu müssen.

Vercel Connect verschiebt den Schlüssel auf Teamebene an einen einzigen Ort:

• Ein Schlüssel, viele Projekte. Sie speichern Ihren BillionVerify API-Schlüssel einmal im Connector. Jedes Projekt, das Sie damit verknüpfen, kann ihn verwenden, und keines davon behält eine eigene Kopie.
• Sie entscheiden, wer ihn verwenden kann. Ein Connector beantwortet Token-Anfragen nur von den Projekten und Umgebungen, die Sie damit verknüpfen. Siehe Projektverknüpfungen in der Vercel-Dokumentation.
• Anfragen werden protokolliert. Jeder Connector verfügt über einen Observability-Tab, der Token-Anfragen nach Projekt, Umgebung und Subjekt aufzeichnet.
• Die Rotation erfordert nur eine Änderung. Erstellen Sie einen neuen Schlüssel in BillionVerify, aktualisieren Sie den Connector, und jedes verknüpfte Projekt übernimmt ihn.

Für KI-Agenten ist das wichtiger als für eine klassische Webanwendung. Ein Agent, der Tools aufrufen kann, sollte keine unverarbeiteten Zugangsdaten aus seiner Umgebung lesen können. Mit Vercel Connect fordert der Code des Agenten den Schlüssel genau in dem Moment an, in dem er BillionVerify aufruft, und der Schlüssel ist niemals Bestandteil des Deployments.

So finden Sie BillionVerify in Vercel Connect

Es gibt zwei Möglichkeiten, den BillionVerify-Vercel-Connector aufzurufen. Beide führen zur gleichen Einrichtung.

Über das öffentliche Vercel-Connect-Verzeichnis

Öffnen Sie vercel.com/connect/browse und geben Sie „billionverify“ in das Suchfeld ein, oder gehen Sie direkt zu vercel.com/connect/billionverify. Der Eintrag zeigt die Verbindungsmethode (API Key) und eine kurze Beschreibung: E-Mail-Adressen einzeln, in Stapeln oder durch den Upload einer Datei im Bulk-Verfahren verifizieren.

Über Ihr Vercel-Dashboard

Wenn Sie bereits bei Vercel angemeldet sind, öffnen Sie Connect im Dashboard Ihres Teams, geben Sie „billionverify“ in das Suchfeld ein und wählen Sie BillionVerify unter All Connectors aus. Dies ist der schnellste Weg, wenn Sie ein Projekt einrichten, das Sie bereits auf Vercel bereitstellen.

So fügen Sie den BillionVerify-Connector zu Ihrem Vercel-Projekt hinzu

Der Connector verwendet einen API-Schlüssel aus Ihrem BillionVerify-Konto. Wenn Sie noch kein Konto haben, melden Sie sich zuerst bei billionverify.com an; mit dem kostenlosen Tarif erhalten Sie an jedem Tag, an dem Sie Ihr Konto nutzen, 20 Credits – bis zu 600 pro Monat – ohne Kreditkarte.

Schritt 1: Erstellen Sie einen BillionVerify API-Schlüssel

Melden Sie sich an und öffnen Sie die Seite API-Schlüssel in Ihrem BillionVerify-Dashboard. Erstellen Sie einen Schlüssel und geben Sie ihm einen Namen, der angibt, wo er verwendet wird, zum Beispiel „vercel-production“, damit Sie ihn später in Ihrem Nutzungsverlauf erkennen können.

Schritt 2: Konfigurieren Sie die Verbindung in Vercel

Klicken Sie in Vercel Connect auf BillionVerify, um Add Connection zu öffnen, und füllen Sie anschließend den Schritt Configure aus:

• Name. Vercel schlägt einen zufälligen Namen wie chestnut-fence vor. Ersetzen Sie ihn durch etwas, das Sie wiedererkennen, zum Beispiel billionverify-prod. Zusammen mit dem Dienst bildet er die Connector-ID, die Ihr Code verwendet: billionverify/billionverify-prod.
• UID (optional). Lassen Sie das Feld leer; Vercel generiert die UID aus dem Dienst- und Connector-Namen.
• Shared API Keys oder Per-User API Keys. Bei Shared wird ein Schlüssel auf dem Connector für alle Nutzer Ihrer App gespeichert. Bei Per-User wird jeder Ihrer Nutzer aufgefordert, beim Autorisieren seinen eigenen BillionVerify-Schlüssel anzugeben. Im nächsten Abschnitt wird erklärt, wann Sie welche Option auswählen sollten.
• Key. Fügen Sie den API-Schlüssel aus Schritt 1 ein.
• Scope and Expiration (optional). Legen Sie einen Ablauf fest, wenn Ihr Team die Schlüssel nach einem Zeitplan wechselt; andernfalls behalten Sie die Standardwerte bei.

Klicken Sie auf Create Connector, um den Connector zu speichern.

Schritt 3: Verknüpfen Sie die Projekte, die ihn verwenden dürfen

Verknüpfen Sie den Connector mit den Vercel-Projekten und Umgebungen, die E-Mail-Verifizierungen durchführen dürfen, zum Beispiel mit der Produktions- und Vorschauumgebung Ihrer Web-App, aber nicht mit einem internen Tool, das keinen Grund hat, BillionVerify aufzurufen. Ein nicht verknüpftes Projekt erhält statt eines Schlüssels eine Fehlermeldung.

Bevorzugen Sie das Terminal? Verwenden Sie die Vercel CLI

Die gleiche Einrichtung funktioniert über die Vercel CLI. Führen Sie sie in dem Projekt aus, das den Connector verwenden wird:

vercel link
vercel connect create billionverify --name billionverify-prod
vercel env pull

vercel env pull lädt ein kurzlebiges Entwicklungs-Token in .env.local herunter, sodass getToken auch funktioniert, wenn Sie die App auf Ihrem eigenen Computer ausführen. Diese Datei enthält ein Vercel-Token, nicht Ihren BillionVerify-Schlüssel.

Gemeinsame API-Schlüssel oder benutzerbezogene API-Schlüssel?

Wähle gemeinsame API-Schlüssel, wenn dein eigenes Produkt die Verifizierung übernimmt: ein Anmeldeformular, das Wegwerf-Adressen ablehnt, ein nächtlicher Job, der neue Leads bereinigt, oder ein interner Agent, den dein Team verwendet. Alle Verifizierungen nutzen dein BillionVerify-Konto und deine Credits.

Wähle benutzerbezogene API-Schlüssel, wenn du ein Produkt für andere Personen entwickelst, die eigene BillionVerify-Konten haben, zum Beispiel ein CRM-Add-on, ein Cold-E-Mail-Tool oder eine Agent-Vorlage. Jeder Nutzer bringt während der Autorisierung seinen eigenen Schlüssel mit, sodass seine Verifizierungen seine eigenen Credits verwenden und in seiner eigenen BillionVerify-Historie angezeigt werden.

BillionVerify aus deinem Code aufrufen

Installiere das Vercel Connect SDK in deinem Projekt:

npm install @vercel/connect

Fordere anschließend den Schlüssel mit getToken an und sende ihn im Header BV-API-KEY. Hier ist ein Next.js-Routen-Handler, der eine Adresse mit einer Live-SMTP-Prüfung überprüft:

// 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);
}

Das data-Objekt der Antwort enthält status (valid, invalid, catchall, role, disposable oder unknown), is_deliverable, is_disposable, is_catchall, is_role und einen reason. Ein Anmeldeformular blockiert normalerweise ungültige und einmalig verwendbare Adressen, akzeptiert gültige Adressen und lässt Catch-all- sowie unbekannte Adressen mit einer Markierung durch, damit du beobachten kannst, wie sie sich verhalten.

Das SDK speichert den Schlüssel im Arbeitsspeicher zwischen und verwendet ihn wieder. Daher wird Vercel Connect nicht für jede von dir überprüfte Adresse erneut aufgerufen.

Einen Batch oder eine ganze Datei überprüfen

Derselbe Schlüssel funktioniert für jeden BillionVerify-Endpunkt:

• POST /v1/verify/single überprüft wie oben eine einzelne Adresse.
• POST /v1/verify/bulk überprüft bis zu 50 Adressen in einer Anfrage. Sende {"emails": [...], "check_smtp": true}.
• POST /v1/verify/file lädt eine CSV-Datei für einen Hintergrundauftrag hoch. Frage den Status mit GET /v1/verify/file/{id} ab und lade die Ergebnisse über GET /v1/verify/file/{id}/results herunter.

Ein gängiges Muster auf Vercel ist ein Cron-Job, der die neuen Leads des Tages sammelt, sie in Gruppen von 50 an /v1/verify/bulk sendet und den Status in deiner Datenbank speichert. Anfrage- und Antwortdetails findest du in der API-Referenz.

Benutzerbezogene Schlüssel im Code

Mit Per-User API Keys übergibst du die ID des angemeldeten Benutzers als Subject:

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

Wenn dieser Benutzer noch keinen Schlüssel bereitgestellt hat, löst das SDK UserAuthorizationRequiredError aus. Fange den Fehler ab und zeige in deiner Benutzeroberfläche einen Schritt „Dein BillionVerify-Konto verbinden“ an. Die anderen Fehlerklassen sind in der Token-Dokumentation von Vercel aufgeführt.

BillionVerify in AI-Agenten auf Vercel verwenden

Wenn du einen Agenten auf Vercel entwickelst, gib ihm ein „E-Mail verifizieren“-Tool, dessen Code getToken und anschließend BillionVerify aufruft – genau wie der Route-Handler oben. Das Modell entscheidet, wann eine Adresse verifiziert wird; der Schlüssel bleibt in Vercel Connect und erscheint niemals im Prompt, in der Tool-Ausgabe oder in der Umgebung des Agenten.

Derselbe API-Schlüssel ermöglicht auch unsere anderen Agent-Integrationen:

• MCP-Server. BILLIONVERIFY_API_KEY=your-key npx billionverify-mcp führt unseren MCP-Server lokal mit denselben 11 Tools wie die gehostete Version aus. Die Einrichtung für jeden Client findest du im MCP-Leitfaden.
• Agent-Skill. Coding-Agenten können den BillionVerify-Skill mit npx skills add BillionVerify/billionverify-skill installieren. Mehr dazu unter Agent Skills.

So funktionieren Credits

Die Verifizierung über den Vercel-Connector kostet genauso viel wie eine Verifizierung an anderer Stelle in BillionVerify: ein Credit für ein eindeutiges Ergebnis. Unbekannte, Wegwerf- und schlecht formatierte Adressen sind kostenlos; ebenso die erneute Prüfung derselben Adresse innerhalb von 24 Stunden. Catch-all-Adressen werden als Catch-all gemeldet und nicht als gültig gezählt, sodass Sie selbst entscheiden, wie Sie mit ihnen umgehen.

Vercel berechnet eigene Token-Anfragen separat gemäß den Preisen für Vercel Connect. Da das SDK den Schlüssel zwischenspeichert, deckt eine Token-Anfrage normalerweise viele Verifizierungen ab.

BillionVerify ist auch in Claude

Anfang dieses Monats wurde BillionVerify in Claudes Konnektorenverzeichnis aufgenommen. Wenn Sie oder Ihr Team mit Claude arbeiten, können Sie BillionVerify dort mit Ihrem Konto verbinden – ganz ohne API-Schlüssel – und Claude im Chat bitten, eine Adresse zu überprüfen oder eine Liste mit bis zu 50 Einträgen zu bereinigen. Lesen Sie BillionVerify ist jetzt in Claudes Konnektorenverzeichnis, um die Einrichtung vorzunehmen.

Claude ist für die Überprüfung von Adressen während Ihrer Arbeit gedacht. Der Vercel-Konnektor ist für die Prüfungen vorgesehen, die Ihre eigenen Apps und Agenten selbstständig durchführen.

Häufig gestellte Fragen

Was ist der BillionVerify-Vercel-Connector?

Der Connector ist der Eintrag von BillionVerify in Vercel Connect. Du speicherst deinen BillionVerify API-Schlüssel einmal in einem Connector. Die Vercel-Projekte, die du damit verknüpfst, können diesen Schlüssel zur Laufzeit abrufen, um die BillionVerify E-Mail-Verifizierungs-API aufzurufen.

Muss ich meinen API-Schlüssel weiterhin in Umgebungsvariablen hinterlegen?

Nein. Der Schlüssel befindet sich im Connector. Dein Code ruft ihn mit getToken aus @vercel/connect ab. Dadurch wird deine Bereitstellung automatisch gegenüber Vercel Connect authentifiziert.

Kostet die E-Mail-Verifizierung über Vercel extra?

Nicht auf Seiten von BillionVerify. Die Verifizierungen verwenden die Credits deines BillionVerify-Kontos zum normalen Tarif. Vercel berechnet Gebühren für eigene Token-Anfragen gemäß der Vercel-Connect-Preisgestaltung.

Sollte ich Shared API Keys oder Per-User API Keys wählen?

Shared API Keys, wenn deine eigene App Adressen mit deinem Konto verifiziert. Per-User API Keys, wenn du ein Produkt entwickelst, dessen Nutzer jeweils ein eigenes BillionVerify-Konto haben und für ihre eigenen Verifizierungen bezahlen sollen.

Kann ich den Connector außerhalb einer Vercel-Bereitstellung verwenden?

Ja. Für die lokale Entwicklung stellt vercel env pull dir ein Entwicklungs-Token bereit. In anderen Umgebungen, etwa bei externem CI, kannst du mit der Option vercelToken ein Vercel-Zugriffstoken an getToken übergeben. Du kannst die BillionVerify API auch direkt mit deinem Schlüssel aufrufen – ohne Vercel Connect.

Funktioniert der Vercel-Connector mit dem gehosteten MCP-Server?

Der gehostete MCP-Server unter mcp.billionverify.com meldet dich per OAuth an – genau das nutzt der Claude-Connector. Der Vercel-Connector enthält einen API-Schlüssel, der mit der REST API, dem npm-Paket billionverify-mcp und dem Agent-Skill funktioniert.

BillionVerify in Vercel Connect hinzufügen

Öffne vercel.com/connect/billionverify, füge deinen BillionVerify API-Schlüssel ein, verknüpfe dein Projekt und verifiziere die nächste Anmeldung oder den nächsten Lead, bevor er deine Liste erreicht.