---
name: contact-enrichment-dach
description: >-
  Strukturiert Recherche und Anreicherung von Geschäftskontakten (DACH) ähnlich Clay:
  Felder, erlaubte Quellen, CRM/mytalentscout-kontakte-Mapping, DSGVO-Rahmen.
  Nutzen bei Kontaktdaten, Ansprechpartner, E-Mail/Telefon recherchieren, Lead-Enrichment,
  Impressum, LinkedIn-URL, Apollo/Clearbit-artige Workflows ohne Scraping-Evasion.
---

# Kontakt-Anreicherung DACH (persönlich — Clay-orientiert)

**Gespiegelt für:** Cursor (`~/.cursor/skills/…`) und Claude Code (`~/.claude/skills/…`). Bei Änderungen **beide Dateien** aktualisieren.

## Ziel

Wichtige **Geschäftskontaktdaten** zuverlässig und **compliance-orientiert** sammeln — vergleichbar mit **Clay** (Orchestrierung + Anbieter), aber **ohne** Anleitung zum Umgehen von Plattform-Schutz oder Nutzungsbedingungen.

## Zielfelder (Priorität)

| Priorität | Feld | Hinweis |
|-----------|------|---------|
| 1 | Name, Rolle/Titel | Aus Impressum, Pressemitteilung, Podcast, Interview |
| 2 | **Geschäftliche** E-Mail / zentrale Nummer | Nur wenn **öffentlich** oder über **lizenzierten** Anbieter mit Rechtsgrundlage |
| 3 | LinkedIn-Profil-URL | Öffentlich sichtbar; keine Automatisierung gegen ToS |
| 4 | Firma, Domain, Standort | Zur Zuordnung und Dublettenprüfung |
| 5 | **Quelle + Datum** (Pflicht) | Jede gespeicherte Aussage nachvollziehbar machen (siehe unten) |

## Pflicht: Herkunft bei jedem Kontakt-Datensatz festhalten

Immer dokumentieren (z. B. Feld `notiz` in SQLite oder CRM-Feld „Quelle“):

- **Was** wurde übernommen (z. B. E-Mail, Telefon, LinkedIn-URL).
- **Woher** (konkrete **URL**, oder **Anbietername** inkl. Produkt/API, oder „manuell Website XY“).
- **Wann** recherchiert (Datum).
- Optional: **Vertrauensgrad** (verifiziert / öffentlich sichtbar / nur Muster / unklar).

Ohne diese Angaben keine Speicherung als „faktisch sicher“ ausweisen.

## Erlaubte Wege (Default)

1. **Website der Firma**: Impressum, Team-Seite, Presse, Karriere („Kontakt Recruiting“).
2. **Lizenzierte Daten-/Enrichment-APIs** (z. B. Anbieter mit Vertrag und Zweckbindung) — nur mit dokumentierter Rechtsgrundlage; **Quelle = Anbieter + Abrufdatum**.
3. **Manuelle** Suche in **öffentlichen** Profilen (kein Mass-Scraping).
4. **KI-Recherche** (z. B. Anthropic Web Search) nur mit Hinweis: **belegbare URLs** im Output; **Quelle = URL laut Modellantwort**, vom Nutzer **stichprobenartig prüfen**.

## Nicht unterstützt (Skill darf nicht raten)

- CAPTCHA/Login umgehen, Bot-Evasion, „versteckte“ APIs sozialer Netzwerke.
- **E-Mail erraten** (z. B. `vorname.nachname@` ohne Verifikation) als „sicheren“ Kontakt ausgeben.
- Private oder nicht-öffentliche Daten beschaffen.

## Mapping: myTalentscout `kontakte`-Tabelle

Projekt **scraper**, Tabelle `kontakte` (Schema: `src/db/jobscraper-schema.ts`), u. a.:

- `name`, `rolle`, `typ` (z. B. Entscheider, HR)
- `linkedin`, `email_muster` (nur als **Muster/Hinweis**, wenn nicht verifiziert)
- `telefon`, `notiz` (**hier: Quelle, Datum, Vertrauensgrad** zentral eintragen)

Beim Befüllen: **Verifiziert** vs. **unklar** in `notiz` kennzeichnen.

## Workflow (Checkliste)

- [ ] Firma + Zielrolle klären (z. B. „Head of Engineering“).
- [ ] Zuerst **eigene Website** / Impressum → **Quelle notieren**.
- [ ] Dann **eine** zusätzliche öffentliche Spur (Presse, Event, Podcast) → **Quelle notieren**.
- [ ] LinkedIn nur **URL** notieren, wenn öffentlich auffindbar → **Quelle = Profil-URL**.
- [ ] E-Mail/Telefon: nur **verifiziert** oder **Anbieter mit Vertrag** — sonst leer lassen oder `email_muster` mit Disclaimer + **Quelle**.
- [ ] Eintrag mit **Quelle + Datum** abschließen.

## DSGVO / UWG (Kurz)

- Nur **berufliche** Daten im B2B-Kontext; Zweck **Transparenz** und **Interessenabwägung** / Vertrag / Einwilligung je nach Kanal klären.
- Bei **Cold Outreach**: Wettbewerbsrecht und Opt-out beachten; keine irreführenden Angaben.
- **Keine Rechtsberatung** — verbindlich: Fachanwalt / Datenschutz.

## Nähe zu Clay

**Clay** = Workflows + viele Integrationen ([clay.com](https://www.clay.com) — **nur Produktreferenz**, kein Übernahme von deren Texten oder APIs). Dieser Skill = **Regeln, Felder und Quellenpflicht**; technische Anbindung (HTTP, n8n) separat nach **jeweiligem Anbieter-Vertrag und Doku**.

---

## Quellen / Herkunft dieser Skill-Inhalte

| Inhalt | Herkunft |
|--------|----------|
| Spalten / Tabelle `kontakte` | Auszug aus dem Repo **scraper**: `src/db/jobscraper-schema.ts` (vom KI-Assistenten eingelesen). |
| Workflow „Clay-ähnlich“ | **Nutzeranfrage** in Cursor + allgemein bekannte **Lead-Enrichment-Praxis** (Orchestrierung, Anbieter, manuelle Recherche). **Clay** als **Analogie**, nicht als inhaltliche Quelle. |
| Apollo / Clearbit | **Beispielnamen** für die Kategorie „lizenzierte B2B-Datenanbieter“ — **keine** Zitate aus AGB/Dokumentation dieser Anbieter. |
| DSGVO / UWG (Kurzabschnitt) | **Oberflächliche Merkhilfe**; **kein** Ersatz für Rechtsquellen (EU-Datenschutz-Grundverordnung, BGB, UWG — verbindlich nur mit juristischer Prüfung). |
| Regeln „keine Evasion“ | Wie beim Partner-Skill **mytalentscout-sales-agent-prompts** + Nutzerabstimmung in Cursor. |
| Diese Quellen-Tabelle | Vom **KI-Assistenten** ergänzt auf **explizite Nutzeranfrage** („Quelle dazu, woher du die Daten hast“). |

**Hinweis:** Für **rechtlich sichere** Verarbeitung personenbezogener Daten immer **eigene Rechtsberatung** und **aktuellen Anbieter-Vertrag** zugrunde legen.