Personensuche-Agentenfähigkeit

Lessie — Personensuche & Datenanreicherung

Einrichtung

Lessie unterstützt zwei Modi: CLI (Standard, empfohlen) und MCP-Server.

Modus A: CLI (Standard)

Installieren Sie das Lessie-CLI-Binärprogramm:

npm install -g @lessie/cli

Oder verwenden Sie es ohne Installation:

npx @lessie/cli --version

Erstmalige Autorisierung:

lessie auth

Dies öffnet einen Browser für Login/Registrierung. Das Token wird unter ~/.lessie/oauth.json zwischengespeichert.

Verbindung prüfen:

lessie status

Modus B: MCP-Server

Fügen Sie dies in Ihre MCP-Konfiguration ein (Claude Code ~/.claude.json, Cursor ~/.cursor/mcp.json, Codex ~/.codex/config.toml, etc.):

{
  "mcpServers": {
    "lessie": {
      "command": "npx",
      "args": ["-y", "@lessie/mcp-server"],
      "env": {
        "LESSIE_REMOTE_MCP_URL": "https://app.lessie.ai/mcp-server/mcp"
      }
    }
  }
}

Deinstallation

• CLI: npm uninstall -g @lessie/cli && rm -rf ~/.lessie/
• MCP: Entfernen Sie den Eintrag "lessie" aus Ihrer .json und führen Sie rm -rf ~/.lessie/ aus.

Versionsprüfung

Führen Sie diese Prüfungen zu Beginn jeder Sitzung einmal durch, vor der Modus-Erkennung. Beide Prüfungen sind nicht blockierend — falls ein Befehl fehlschlägt (Netzwerkfehler, Timeout), überspringen Sie ihn stillschweigend und fahren Sie fort.

Skill-Version

1. Lesen Sie die aktuelle lokale Version aus dem Metadatenfeld version dieser Datei oben.
2. Holen Sie die entfernte Version:

   curl -sf --max-time 5 https://raw.githubusercontent.com/LessieAI/lessie-skill/main/people-search/SKILL.md | head -5 | grep 'version:' | head -1 | awk '{print $2}'
   

3. Wenn die entfernte Version neuer ist als die lokale → sagen Sie dem Benutzer:

   ⬆️ Eine neuere Version der Personensuche-Skill ist verfügbar ({local} → {remote}). Führen Sie diesen Befehl aus, um zu aktualisieren:

   npx skills add LessieAI/lessie-skill -y -g
   

4. Wenn die Versionen übereinstimmen oder die Prüfung fehlschlägt → überspringen Sie, sagen Sie nichts.

CLI-Version

1. Erhalten Sie die lokale CLI-Version:

   lessie --version 2>/dev/null || npx @lessie/cli --version 2>/dev/null
   

2. Erhalten Sie die neueste veröffentlichte Version:

   npm view @lessie/cli version 2>/dev/null
   

3. Wenn die entfernte Version neuer ist → sagen Sie dem Benutzer:

   ⬆️ Eine neuere Version der Lessie-CLI ist verfügbar ({local} → {remote}). Führen Sie diesen Befehl aus, um zu aktualisieren:

   npm install -g @lessie/cli
   

4. Wenn die Versionen übereinstimmen oder einer der Befehle fehlschlägt → überspringen Sie, sagen Sie nichts.

Schnellstart

Nach der Einrichtung versuchen Sie, Claude zu sagen:

• "Finde Engineering Manager bei Stripe in San Francisco"
• "Suche nach Sam Altmans Kontaktdaten"
• "Recherchiere OpenAI — aktuelle Nachrichten und offene Stellen"

Moduserkennung

Bestimmen Sie, welcher Modus zu Beginn jeder Sitzung verwendet werden soll:

1. Überprüfen Sie, ob die lessie CLI verfügbar ist: führen Sie lessie status aus.
2. Wenn der Befehl erfolgreich ist → verwenden Sie CLI-Modus (Tools über Bash aufrufen).
3. Wenn der Befehl fehlschlägt (nicht gefunden) → versuchen Sie die automatische Installation: npm install -g @lessie/cli.
4. Führen Sie nach der Installation erneut lessie status aus, um zu überprüfen.
5. Wenn die Installation erfolgreich ist → verwenden Sie CLI-Modus.
6. Wenn die Installation fehlschlägt (kein npm, Berechtigung verweigert, Netzwerkfehler, etc.) → überprüfen Sie, ob MCP-Tools verfügbar sind (authorize, use_lessie).
7. Wenn MCP-Tools verfügbar sind → verwenden Sie MCP-Modus.
8. Wenn beides nicht möglich ist → informieren Sie den Benutzer, dass die Installation fehlgeschlagen ist, und schlagen Sie die manuelle Installation oder MCP-Einrichtung vor.

Credits & Preise

Lessie ist ein Credit-basierter Dienst.

Neue Konten erhalten kostenlose Test-Credits. Sehen Sie Ihr Guthaben ein und kaufen Sie weitere unter https://lessie.ai/pricing.

Der Agent klärt Firmennamen vor der Suche, um keine Credits durch falsche Ergebnisse zu verschwenden.

Daten & Datenschutz

• Datenquellen: Kontakt- und Unternehmensinformationen werden aus öffentlich zugänglichen Quellen aggregiert (Geschäftsverzeichnisse, soziale Profile, Unternehmenswebsites).
• Suchprotokollierung: Suchanfragen werden zur Verbesserung des Dienstes und zur Missbrauchsprävention protokolliert. Keine Abfragedaten werden an Dritte weitergegeben.
• Daten-Compliance: Lessie befolgt geltende Datenschutzbestimmungen. Benutzer sind dafür verantwortlich, abgerufene Kontaktdaten in Übereinstimmung mit lokalen Gesetzen (DSGVO, CAN-SPAM, etc.) zu verwenden.
• Datenschutzerklärung: https://lessie.ai/privacy
• Nutzungsbedingungen: https://lessie.ai/terms-of-service

Autorisierung

CLI-Modus

1. Führen Sie lessie status aus, um die Token-Gültigkeit zu prüfen.
2. Wenn authorized: false → führen Sie lessie auth aus, um den Browser für den Login zu öffnen.
3. Nachdem der Benutzer den Login abgeschlossen hat, führen Sie erneut lessie status aus, um zu bestätigen.

MCP-Modus

1. Rufen Sie authorize auf, um den Verbindungsstatus zu prüfen.
2. Wenn bereits autorisiert → fahren Sie direkt mit der Nutzung der Tools fort.
3. Wenn nicht autorisiert → authorize gibt eine Autorisierungs-URL zurück. Sagen Sie dem Benutzer, dass Sie einen Browser für Lessie Login/Registrierung öffnen müssen, und öffnen Sie ihn mit dem entsprechenden Systembefehl:
   • macOS: open "<url>"
   • Linux: xdg-open "<url>"
   • Windows: start "<url>"
4. Sagen Sie dem Benutzer, dass der Browser geöffnet wurde und er den Login/Registrierung abschließen muss.
5. Nachdem der Benutzer bestätigt hat, rufen Sie erneut authorize auf, um die Verbindung zu überprüfen.
6. Wenn die Autorisierung fehlschlägt (Timeout, abgelehnt, Port-Konflikt), folgen Sie den Diagnosehinweisen von authorize und versuchen Sie es erneut.

Informieren Sie den Benutzer immer, bevor Sie den Browser öffnen — niemals stillschweigend weiterleiten.

Verhaltensregeln für den Agenten

KRITISCH: Vor jeder Credit-verbrauchenden Aktion bestätigen

Jeder Lessie-Tool-Aufruf kostet Credits. Credit-Kosten pro Tool:

Bevor Sie einen Befehl ausführen, MÜSSEN Sie:

1. Sagen Sie dem Benutzer, was Sie tun werden, und die geschätzten Kosten (z.B. "Ich werde 3 Personen anreichern — das kostet ca. 3 Credits").
2. Warten Sie auf ausdrückliche Bestätigung, bevor Sie ausführen.
3. Fassen Sie niemals mehrere Credit-verbrauchende Aufrufe zusammen, ohne zuvor den gesamten Plan zu bestätigen.

Ausnahme — Bestätigung überspringen, wenn der Benutzer ausdrücklich gesagt hat, dass er nicht gefragt werden möchte (z.B. "Frag mich nicht jedes Mal", "Mach einfach", "Bestätigungen überspringen"). Fahren Sie in diesem Fall direkt fort, protokollieren Sie aber dennoch, was Sie ausgeführt haben und welche Credits verbraucht wurden, nach jedem Aufruf.

KRITISCH: Credit-Verbrauch nach jedem Aufruf melden

Nach jeder Konversationsrunde, die einen oder mehrere Lessie-Tool-Aufrufe umfasste, fügen Sie eine einzeilige Zusammenfassung der verbrauchten Credits an. Format:

Verwendet <tool-name>, Kosten <N> Credit(s).

Wenn mehrere Tools in derselben Runde aufgerufen wurden, fassen Sie sie zusammen:

Verwendet web-search + enrich-org, insgesamt 2 Credits.

KRITISCH: Referenzen vor dem ersten CLI-Aufruf lesen

Bevor Sie einen lessie-CLI-Befehl zum ersten Mal in einer Sitzung ausführen, MÜSSEN Sie references/cli-reference.md lesen, um die genaue Parameter-Syntax zu lernen. Jedes Tool hat seinen eigenen Satz an Flags — find-people erwartet --query (NL), enrich-people erwartet --people (JSON), unlock-emails erwartet --search-id + --person-ids, etc. Raten Sie nicht — lesen Sie den Abschnitt für das Tool, das Sie aufrufen möchten.

Suchmodus-Unterscheidung (B2B vs KOL)

Lessie unterstützt zwei Suchmodi mit unterschiedlichen Datenquellen und Ergebnistypen:

• B2B-Modus: Durchsucht professionelle Datenbanken (LinkedIn-basiert). Am besten geeignet, um Personen nach Jobtitel, Unternehmen, Seniorität oder Branche zu finden. Liefert Arbeits-E-Mail, Telefon, Beschäftigungsverlauf.
• KOL-Modus: Durchsucht Social-Media-Plattformen (Instagram, YouTube, TikTok, Twitter/X). Am besten geeignet, um Influencer, Content-Ersteller oder öffentliche Persönlichkeiten nach Zielgruppe, Followeranzahl oder Inhaltsthema zu finden. Liefert soziale Links, Followerzahlen.

Wenn die Absicht des Benutzers mehrdeutig ist — d.h. die Anfrage könnte vernünftigerweise sowohl auf Fachleute auf LinkedIn als auch auf Ersteller in sozialen Medien abzielen — MÜSSEN Sie den Benutzer um Klärung bitten, bevor Sie suchen. Präsentieren Sie beide Optionen prägnant:

Beispiel für eine mehrdeutige Anfrage: "Finde Personen, die praktische Erfahrung mit Gehirnüberwachungs-Schlafgeräten haben, um ihre Erkenntnisse zu teilen."

Dies könnte bedeuten:

1. B2B: Produktmanager, Ingenieure oder Forscher bei Sleep-Tech-Unternehmen (über LinkedIn)
2. KOL: Gesundheits-/Technik-Influencer, die solche Geräte bewertet oder verwendet haben (über soziale Medien)

Fragen Sie: "Das könnten LinkedIn-Fachleute (PMs, Ingenieure bei Sleep-Tech-Unternehmen) oder Social-Media-Ersteller sein, die Schlafgeräte testen. Welche Richtung bevorzugen Sie — oder beide?"

Wenn die Absicht klar ist, fahren Sie direkt fort:

• "Finde CTOs bei Fintech-Startups" → B2B (offensichtlich)
• "Finde Beauty-Influencer auf Instagram mit 100k+ Followern" → KOL (offensichtlich)

Entitätsdisambiguierung

Wenn ein Benutzer einen Firmennamen erwähnt, der sich auf mehrere Entitäten beziehen könnte (z.B. "Manus" könnte Manus AI, Manus Bio, Manus Plus usw. sein), disambiguieren Sie vor der Suche:

1. Fragen Sie den Benutzer, welches Unternehmen er meint, oder präsentieren Sie die wahrscheinlichsten Kandidaten und lassen Sie ihn wählen.
2. Wenn der Kontext es eindeutig macht (z.B. der Benutzer hat zuvor über KI-Agenten gesprochen), geben Sie Ihre Annahme an und bestätigen Sie: "Meinten Sie Manus AI (manus.im), das KI-Agenten-Unternehmen?"
3. Nehmen Sie niemals stillschweigend eine Entität an statt einer anderen — falsche Domain = verschwendete Such-Credits und irrelevante Ergebnisse.

Tools-Übersicht

Personen

Kontaktentsperrung

Entscheidungsregel: Wenn die Person aus Ihrem eigenen find_people-Ergebnis stammt → verwenden Sie unlock_emails (erneute Entsperrungen sind kostenlos). Wenn Sie den Handle von außerhalb von Lessie erhalten haben (eine vom Benutzer eingefügte LinkedIn-URL, eine manuelle Erwähnung, etc.) → verwenden Sie unlock_email_by_handle.

Unternehmen

Web-Recherche

Detaillierte Referenzen

• CLI-Befehlsbeispiele & MCP-Aufruf: Siehe references/cli-reference.md
• Workflow-Muster (Domänenauflösung, Unternehmensrecherche, Suche+Qualifizierung): Siehe references/workflow-patterns.md
• Entscheidungsbaum für Domänenauflösung: Siehe references/domain-resolution.md

Wichtige Einschränkungen

• enrich_people / enrich_organization: maximal 10 pro Aufruf; teilen Sie größere Listen in Stapel auf
• find_people: harte Obergrenze von 3 Tool-Aufrufen + 60s Wanduhr-Zeitbudget pro Anfrage. target_count 1-100 (Standard 30). NICHT paginiert — wenn Sie mehr benötigen, starten Sie einen neuen Aufruf mit einer anderen Abfrage
• find_organizations: paginiert — verwenden Sie --page für weitere Ergebnisse
• web_search speichert Seiteninhalte zwischen; wenn ein Ergebnis has_content: true hat, ist der Aufruf von web_fetch auf diese URL sofort
• Nützliche Schlüsselwörter für eine find-people-Abfrage: Begriffe für Seniorität (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern) und current gegenüber past, um die Aktualität der Beschäftigung zu gewichten. Der Agent verwendet diese direkt als Filter
• Bei der Personenanreicherung verbessert die Angabe von domain (Unternehmensdomain) zusammen mit dem Namen die Treffergenauigkeit erheblich
• CLI-Ausgabe ist JSON auf stdout, Statusmeldungen auf stderr — parsen Sie stdout für Daten