name: lead-dossier description: > Mitmeallikaline kontouuring, kaskaadrigastamine ja müügivihjete torujuhe. Ühendab veebisaidi kraapimise, tehnoloogiapinu tuvastamise, CRM-rigastamise, värbamise/uudiste signaalid struktureeritud dossier'iteks. Sisaldab täielikku müügivihjete hankimise torujuhet: otsi → kinnita → dedupeeri → laadi üles. Päästikud: "research account", "build dossier", "enrich leads", "lead pipeline", "source leads", "prospect research", "account intel", "cascade enrichment", "lead scoring", "find leads", "verify emails", "upload leads".

Müügivihje dossier'i oskus

Mitmeallikaline kontouuringu ja müügivihjete rigastamise torujuhe tehisaru kodeerimisabilistele.

Eeltingimused

• Python 3.9+ koos installitud requests-iga
• API võtmed seadistatud keskkonnamuutujatena (vt .env.example)
• Valikuline: CRM-juurdepääs kontakti/ettevõtte rigastamiseks

Keskkonnamuutujad

Kõik API võtmed seadistatakse keskkonnamuutujate kaudu. Kopeeri .env.example failiks .env:

Töövoog 1: Kontouuring

Kasuta, kui palutakse uurida ettevõtet või ehitada potentsiaalse kliendi dossier.

Kogu parameetrid

Käivita uuring

python3 scripts/account-researcher.py --domain acme.com --company "Acme Corp"

Partiiuuringuks:

python3 scripts/account-researcher.py prospects.json

Tulemused on 7 päeva vahemälus kataloogis data/account-research/.

Väljundvorming

Mootor toodab struktureeritud JSON dossier'i koos: - Veebisaidi analüüsiga (pealkiri, kirjeldus, kehatükk, turunduslüngad) - Tehnoloogiapinuga (CRM, turundustööriistad, ettevõttesignaalid) - Värbamissignaalidega (kasvuindikaatorid) - Uudiste/rahastamise signaalidega - 3–5-lauselise uurimisbriefsiga

Töövoog 2: Kaskaadrigastamine

Kasuta, kui rikastad potentsiaalsete klientide nimekirja kinnitatud e-posti aadressidega.

Valmista konfiguratsioon

Loo data/enrichment-config.json:

{
  "email_validation_api_key": "YOUR_KEY",
  "email_validation_api_url": "https://api.your-provider.com/v1/people/email-finder",
  "email_validation_timeout_seconds": 10,
  "fallback_tag": "linkedin-outreach-only"
}

Käivita rigastamine

python3 scripts/cascade-enricher.py input.json output.json

Waterfall-loogika: 1. E-post peamisest allikast olemas? → Valmis 2. Proovi e-posti otsija API-d → Leitud? → Valmis 3. LinkedIni URL olemas? → Märgi varuvariandiks 4. Mitte midagi → Märgi kontaktita

Töövoog 3: Täielik müügivihjete torujuhe

Kasuta, kui hangid, kinnitad ja laadid müügivihjeid otsast lõpuni.

Kogu parameetrid

Käivita torujuhe

python3 scripts/lead-pipeline.py \
  --source-api-key "$LEAD_SOURCE_API_KEY" \
  --validation-api-key "$EMAIL_VALIDATION_API_KEY" \
  --campaign-api-key "$CAMPAIGN_TOOL_API_KEY" \
  --titles "VP Marketing,CMO,Head of Growth" \
  --industries "Marketing,Advertising" \
  --company-size "11,50" \
  --locations "United States" \
  --campaign-id "CAMPAIGN_UUID" \
  --volume 500 \
  --output-dir ./data/pipeline-runs/

Valikulised lipud: - --exclude-file /path/to/burned-emails.csv — täiendav välistusnimekiri - --dry-run — käivita kõik peale lõpliku üleslaadimise - --keywords "SaaS,B2B" — täiendavad otsingumärksõnad

Vaata väljund üle

Torujuhe salvestab JSON käivituslogi väljundkataloogi koos täieliku statistikaga: - Hangitud arv, kinnitusmäär, dedupe'i statistika, üleslaadimise tulemused - Töödeldud müügivihjete täielik nimekiri

Töövoog 4: Reaalajas müügivihjete rigastamine

Kasuta sissetulevate müügivihjete rikastamiseks webhookidest, vormidest või CRM päästikutest.

Käivita rikastaja

python3 scripts/lead-enricher.py [--dry-run] [--backfill N]

Rikastaja: 1. Parsib sissetulevad müügivihje andmed (veebivormid, häälagendi kõned jne) 2. Otsib kontakti ja ettevõtte CRM-ist 3. Käivitab kontouuringu konteksti jaoks 4. Ehitab rikastatud müügivihje kaardi kõigi saadaolevate andmetega

Ohutusreeglid

1. Ära kunagi laadi üles kinnitamata müügivihjeid — iga e-post peab läbima valideerimise
2. Alati dedupeeri — kontrolli olemasolevaid kontakte enne üleslaadimist
3. Logi kõik — iga käivitus toodab auditeeritava JSON-logi
4. Piirmäärateadlik — sisseehitatud viivitused ja eksponentsiaalne backoff
5. Idempotentne — uuesti käivitamine on ohutu; duplikaadid püüab dedupe'i samm
6. Turvaväravad — skaneeri kogu sissetulev veebisisu enne töötlemist

Tõrkeotsing

• Otsingu API ei tagasta tulemusi: Kontrolli ameti/tööstusharu kirjaviisi; proovi laiemaid kriteeriume
• E-posti valideerimise 429-d: Skript käsitleb backoffiga; kui püsib, vähenda mahtu
• Kampaaniatööriista vaiksed tõrked: Mõned API-d blokeerivad vaikides kõrgetel päringumääradel; skriptidel on partiiviivitused
• Vahemälu vananenud: Kustuta failid data/account-research/ kataloogist, et sundida värskendust