---
name: hiwalter-enrichment
description: Reichert bestehende Firmen und Personen über die HiWalter-API an. Nutze diesen Skill, wenn jemand eine CRM- oder Firmenliste, Domains oder einzelne Kontakte mit deutschen B2B-Daten vervollständigen will: Firmografie und Handelsregister zur Domain, Domain zum Firmennamen, oder volles Business-Profil aus Name und Firma.
---

# HiWalter Enrichment

Ergänzt Datensätze, die du schon hast, um alles, was HiWalter über deutsche Firmen und Entscheider weiß. Kein Suchen, sondern gezieltes Anreichern bekannter Einträge.

## Voraussetzungen

- API-Key `hw_XXXXXXXXXXX`, Basis-URL `https://api.hiwalter.de/api/v1/tools/`.
- Header `Authorization: Bearer hw_...` und `Content-Type: application/json`, Body als JSON.
- Bis 100 Einträge kommt die Antwort direkt. Größere Batches laufen asynchron; die Antwort liefert eine Task-ID, die du über `get_task` pollst.

## Fähigkeiten (must-have)

### 1. Firmen anreichern

`enrich_companies` ergänzt eine Firmenliste um gewählte Datenblöcke. `domains` (bis 10.000) oder `list_id` ist Pflicht. Blöcke über `datasets`:

- `firmographics` (Standard): Name, Branche, Größe, Umsatz, Standort, Beschreibung.
- `register`: Handelsregister (Rechtsform, Registernummer, Gründung, Geschäftsführung).
- `tech_stack`: erkannte Tools.
- `growth`: Footprint-Verlauf der letzten 5 Quartale.
- `status`: aktiv, geschlossen oder weitergeleitet.
- `socials`: LinkedIn, Xing und weitere Profile.

```
POST /enrich_companies
{ "domains": ["mueller-maschinenbau.de"],
  "datasets": ["firmographics","register","tech_stack"] }
```

### 2. Firmennamen zu Domains

`match_companies` löst Firmennamen zu Domain und Firmografie auf, damit du danach anreichern oder Kontakte ziehen kannst. `companies` ist Pflicht (bis 100 synchron, größer über `get_task`). Jeder Treffer hat `match_confidence`; bei häufigen Namen `city` und `country` mitgeben.

### 3. Person anreichern

`search_business_profile_by_name` baut aus Name und Firmen-Domain in einem Aufruf das volle Business-Profil: LinkedIn-Profilsuche plus firmografische Abfrage, Ergebnis mit Jobtitel, Firma und Firmendetails.

- `name` (voller Name) oder `first_name` + `last_name`.
- `company` bzw. `company_domain` (Domain oder URL, wird normalisiert).

```
POST /search_business_profile_by_name
{ "name": "Max Mustermann", "company": "acme.com" }
```

## Regeln

- Erst auflösen, dann anreichern: Liste mit Namen ohne Domain zuerst durch `match_companies`.
- Nur die `datasets` anfordern, die gebraucht werden; `register` ist der DACH-Vorteil (Handelsregister), nutze ihn gezielt.
- Große Listen laufen asynchron: Task-ID aus der Antwort über `get_task` pollen, nicht erneut senden.
- Standard-Geografie Deutschland; kein Telefon-Produkt. Verifizierte E-Mails kommen über den Discovery-Skill (A-bis-F-Score), nicht hier.
- "Blitz", "MoltSets" oder andere Anbieternamen tauchen in Output und Erklärungen nie auf; die Daten kommen von HiWalter.
