dev-trace

Was macht dev-trace?

Wandelt eine E-Mail in ein strukturiertes öffentliches Profil um, indem ein fester Wasserfall öffentlicher Quellen durchlaufen wird, wobei jede Ebene nur dann aktiviert wird, wenn ihr API-Schlüssel vorhanden ist. Nur öffentliche Daten – unterhalb der Konfidenzschwelle werden Kandidaten zurückgegeben, anstatt zu raten. Keine Abhängigkeiten (Node 18+); bringen Sie Ihre eigenen API-Schlüssel mit.

So wird es ausgeführt

node scripts/dev-trace.mjs <email> [--pretty] [--json <path>] [--max-depth N] [--deep] [--tier low|medium|high] [--no-bio] [--bio-mode fast|balanced|deep|max]

• --pretty – menschenlesbares JSON (verwenden Sie dies, wenn Sie es dem Benutzer anzeigen).
• --json <path> – schreibt das rohe Objekt in eine Datei anstatt nach stdout.
• --max-depth N – stoppt nach Tiefe N (0–4) für die schnellen Ebenen. Standard 4.
• --deep – führt auch Tiefe 5 (SixtyFour) aus. Langsam (Minuten) und teuer; erfordert SIXTYFOUR_API_KEY.
• --tier low|medium|high – SixtyFour-Recherchetiefe (Standard low). Höher = gründlicher, langsamer, mehr Credits.
• --no-bio – überspringt den Tabstack /research Bio-Schritt (standardmäßig aktiviert, wenn ein Name aufgelöst wurde und TABSTACK_API_KEY gesetzt ist).
• --bio-mode fast|balanced|deep|max – Recherchetiefe für die Biografie (Standard fast).

Der Wasserfall

Tiefe	Ebene	Quelle	Schlüssel	Läuft
0	validieren	Syntax + MX + wegwerfbar	keiner	immer, kostenlos
1	oberfläche	Gravatar + Domain-Scrape	keiner	immer, kostenlos
1	verifizieren	Hunter-E-Mail-Verifizierung	HUNTER_API_KEY	wenn Schlüssel
2	profil	GitHub-Identität + ICP-Grundlagen	GITHUB_TOKEN (empfohlen)	immer, kostenlos
3	angereichert	Tabstack Web/Unternehmen	TABSTACK_API_KEY	wenn Schlüssel
4	tief	Hunter-Personenanreicherung	HUNTER_API_KEY	wenn Schlüssel
5	am tiefsten	SixtyFour Personen-Intelligenz (LinkedIn-Suche)	SIXTYFOUR_API_KEY	nur mit --deep

HUNTER_API_KEY schaltet sowohl die Verifizierung (Tiefe 1, 0,5 Credits/Aufruf) als auch die Personenanreicherung (Tiefe 4, 0,2 Credits/Aufruf) frei – beachten Sie, dass die Verifizierung mehr kostet als die Anreicherung. Tiefe 5 (SixtyFour) ist der optionale Tiefgang: Sie läuft nur mit --deep, dauert Minuten (asynchrone Web-Recherche) und verankert sich auf der E-Mail selbst sowie allen vorgelagerten Namen/Unternehmen/LinkedIn. Sie überspringt nur wegwerfbare oder unzustellbare E-Mails (protokolliert in meta).

Schlüssel

Kopieren Sie .env.example in .env in dieses Fertigkeitsverzeichnis und fügen Sie alle Schlüssel hinzu, die Sie haben (die Engine liest .env aus dem Fertigkeitsstamm oder scripts/). Alle sind optional; die Validierungs-, Oberflächen- und GitHub-Ebenen laufen ohne. Eine Ebene, deren Schlüssel fehlt, wird stillschweigend übersprungen. Schlüssel werden nie mit der Fertigkeit gebündelt (.env ist in gitignore).

Kosten- und Nutzungsrichtlinie (für den Agenten)

Die Fertigkeit ist so aufgebaut, dass Sie ein nützliches Profil kostenlos erhalten, und jeder kostenpflichtige Anbieter ist Opt-in – geben Sie nur dann Geld aus, wenn ein Lead es wert ist.

Kostenstufen, günstigste zuerst:

• 🟢 Kostenlos, kein Konto – validieren, Oberfläche (Gravatar + Domain), GitHub-Identität. Ohne Schlüssel ausführen.
• 🟢 Kostenloser Schlüssel, optional – GITHUB_TOKEN (kostenlos zu generieren) erhöht nur das Rate-Limit und die Zuverlässigkeit von GitHub.
• 🟢 Kostenloses Konto, reicht weit – Tabstack (TABSTACK_API_KEY): Unternehmensanreicherung (Tiefe 3) + die zitierte /research-Biografie. Ein kostenloses Tabstack-Konto deckt viel ab, bevor Sie jemals bezahlen.
• 🟡 Gemessene Credits, kostenlose Stufe dann bezahlt – Hunter (HUNTER_API_KEY): E-Mail-Verifizierung (0,5 Credits) + Personenanreicherung (0,2 Credits).
• 🔴 Premium, echte $$$$ – SixtyFour (SIXTYFOUR_API_KEY, --deep): tiefste Personen- + LinkedIn-Suche. Die Notfall-Ebene für hochwertige Ziele.

Details pro Ebene:

Ebene	Kosten	Läuft
1 verifizieren (Hunter)	0,5 Hunter-Credits	wenn HUNTER_API_KEY vorhanden
3 Tabstack Unternehmen	Tabstack-Credits	wenn TABSTACK_API_KEY vorhanden
4 Hunter Person	0,2 Hunter-Credits	wenn HUNTER_API_KEY vorhanden
Biografie (Tabstack /research)	Tabstack-Credits (fast am günstigsten)	wenn ein Name aufgelöst wurde
5 SixtyFour	teuer – siehe unten	nur mit --deep

Richtlinie: Standardmäßig kostenlose + günstige Ebenen verwenden. Für eine schnelle kostenlose Suche führt --max-depth 2 nur die kostenlosen Ebenen aus.

SixtyFour (--deep) ist teuer und ratenbegrenzt. Die genauen Kosten hängen von Ihrem SixtyFour-Plan ab; beim Einstiegsplan (~100 Credits/Monat, 0,24 $/Credit) maß ein medium Personen-Intelligence-Abruf ~20 Credits (~4,80 $, ~2,5 Min.), d.h. etwa 5 Abrufe/Monat. Behandeln Sie jede --deep-Ausführung als knappe Ressource:

• Führen Sie --deep niemals aus, um „gründlich zu sein“. Nur bei einem wirklich hochwertigen Ziel.
• Erst nachdem die günstigeren Ebenen (Hunter-Personenanreicherung, die /research-Biografie) zu kurz gekommen sind.
• Bestätigen Sie mit dem Benutzer, bevor Sie einen SixtyFour-Abruf ausgeben, und standardmäßig --tier low – erhöhen Sie die Stufe niemals unaufgefordert.
• Erzwungen, nicht nur empfohlen: --deep weigert sich auszuführen, es sei denn, ein Mensch hat die Kosten akzeptiert, entweder über DEV_TRACE_ALLOW_DEEP=1 in der Umgebung oder eine interaktive Bestätigung. Es kann nicht autonom ausgelöst werden. DEV_TRACE_MAX_DEPTH=N begrenzt die Tiefe für den unbeaufsichtigten Gebrauch. Siehe die README „Unbeaufsichtigte / autonome Agenten“.

--bio-mode über fast und die Tiefen 3/4 verbrauchen normale Credits – in Ordnung, wenn relevant, aber erhöhen Sie --bio-mode nicht unaufgefordert.

Biografie (Tabstack /research)

Nach den Identitätsebenen, wenn ein Name aufgelöst wurde und TABSTACK_API_KEY gesetzt ist, synthetisiert ein Tabstack /research-Aufruf eine zitierte professionelle bio in das Profil, mit Quell-URLs in meta.bio_sources. Standardmodus fast (am günstigsten); erhöhen mit --bio-mode oder überspringen mit --no-bio. Benötigt einen Namen, daher läuft es ohne einen Hunter/GitHub-Treffer nur zusammen mit --deep (das den Namen über SixtyFour liefert).

Wenn Sie Ergebnisse weiterleiten: melden Sie, welche Tiefen ausgeführt wurden (meta.depths_run) und welche Schlüssel mehr freischalten würden. Erfinden Sie keine Felder, die die Ablaufverfolgung nicht zurückgegeben hat.

Ausgabe

{
  "meta": { "email": "...", "depths_run": [0,1,2], "match_status": "probable", "generated_at": "..." },
  "profile": { "<field>": { "value": "...", "confidence": 0.85, "sources": ["github"], "conflict": null } }
}

• Jedes Feld ist umschlossen mit value, confidence (0–1), sources und conflict (null oder der konkurrierende Wert, wenn Ebenen uneins sind).
• meta.match_status: verified (bestätigte Identität + zustellbar), probable (Identität gefunden, unbestätigt), unverified_candidates (unterhalb der Schwelle).
• Fehlgeschlagene oder ratenbegrenzte Ebenen werden in meta.errors / meta.rate_limited aufgezeichnet; der Wasserfall bricht bei einer Ebene nie ab.

Hinweise

• Erzeugt nur das Profil. Die Aufbereitung in einen CRM-Datensatz, ein Briefing oder ein anderes Ergebnis ist ein separater Folgeschritt.
• Eigenständig und verteilbar: keine Abhängigkeiten (Node 18+), kein externes Klonen oder Build erforderlich.
• Nur öffentliche Daten; keine erfundenen Profile. Unterhalb der Konfidenzschwelle werden Kandidaten anstelle eines Werts zurückgegeben.