---
title: Müügivihje toimik
description: Eric Siu oskus potentsiaalse kliendi taustatoimiku koostamiseks.
category: Marketing
sublabel: Strateegia
author: Eric Siu
tags: 
license: MIT
source: https://github.com/ericosiu/ai-marketing-skills
---

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`:

| Muutuja | Kirjeldus |
|----------|-------------|
| `LEAD_SOURCE_API_KEY` | Inimeste/ettevõtete otsingu API |
| `EMAIL_VALIDATION_API_KEY` | E-posti kinnitamise teenus |
| `EMAIL_VALIDATION_API_URL` | E-posti kinnitamise lõpp-punkt |
| `CAMPAIGN_TOOL_API_KEY` | Väljamineva kampaania platvorm |
| `CRM_API_KEY` | CRM API võti |
| `CRM_BASE_URL` | CRM API baas-URL |
| `BUILTWITH_API_KEY` | BuiltWith tehnoloogia tuvastus (tasuta tase töötab) |

## Töövoog 1: Kontouuring

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

### Kogu parameetrid

| Parameeter | Kohustuslik | Näide |
|-----------|----------|---------|
| Domeen | Jah | acme.com |
| Ettevõtte nimi | Ei | Acme Corp |
| Kontakti nimi | Ei | Jane Doe |
| Kontakti amet | Ei | VP Marketing |

### Käivita uuring

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

Partiiuuringuks:
```bash
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`:
```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

```bash
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

| Parameeter | Kohustuslik | Näide |
|-----------|----------|---------|
| Ametid | Jah | VP Marketing, CMO |
| Tööstusharud | Jah | Marketing, SaaS |
| Ettevõtte suurus | Jah | 11-50, 51-200 |
| Asukohad | Jah | United States |
| Kampaania ID | Jah | Campaign UUID |
| Maht | Jah | 500 |

### Käivita torujuhe

```bash
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

```bash
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