Agentvaardigheid: Personen zoeken

Lessie — Personen zoeken en verrijken

Configuratie

Lessie ondersteunt twee modi: CLI (standaard, aanbevolen) en MCP-server.

Modus A: CLI (standaard)

Installeer de Lessie CLI-binary:

npm install -g @lessie/cli

Of gebruik zonder installatie:

npx @lessie/cli --version

Eerste autorisatie:

lessie auth

Dit opent een browser voor inloggen/registratie. Het token wordt opgeslagen in ~/.lessie/oauth.json.

Verifieer de verbinding:

lessie status

Modus B: MCP-server

Voeg toe aan je MCP-configuratie (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"
      }
    }
  }
}

Verwijderen

• CLI: npm uninstall -g @lessie/cli && rm -rf ~/.lessie/
• MCP: Verwijder de vermelding "lessie" uit je .json en voer rm -rf ~/.lessie/ uit

Versiecontrole

Voer deze controles eenmaal uit aan het begin van elke sessie, voor modusdetectie. Beide controles zijn niet-blokkerend — als een commando mislukt (netwerkfout, time-out), sla het dan stil over en ga verder.

Vaardigheidsversie

1. Lees huidige lokale versie uit het version-veld in de metadata van dit bestand hierboven.
2. Haal externe versie op:

   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. Als de externe versie nieuwer is dan de lokale versie → vertel de gebruiker:

   ⬆️ Er is een nieuwere versie van de people-search vaardigheid beschikbaar ({local} → {remote}). Voer dit commando uit om te updaten:

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

4. Als de versies overeenkomen of de controle mislukt → sla over, zeg niets.

CLI-versie

1. Haal lokale CLI-versie op:

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

2. Haal nieuwste gepubliceerde versie op:

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

3. Als de externe versie nieuwer is → vertel de gebruiker:

   ⬆️ Er is een nieuwere versie van Lessie CLI beschikbaar ({local} → {remote}). Voer dit commando uit om te updaten:

   npm install -g @lessie/cli
   

4. Als de versies overeenkomen of een van de commando's mislukt → sla over, zeg niets.

Snelle start

Na de configuratie, probeer tegen Claude te zeggen:

• "Vind technische managers bij Stripe in San Francisco"
• "Zoek de contactgegevens van Sam Altman op"
• "Onderzoek OpenAI — recent nieuws en openstaande vacatures"

Modusdetectie

Bepaal aan het begin van elke sessie welke modus te gebruiken:

1. Controleer of lessie CLI beschikbaar is: voer lessie status uit
2. Als het commando slaagt → gebruik CLI-modus (roep tools aan via Bash)
3. Als het commando mislukt (niet gevonden) → probeer automatisch te installeren: npm install -g @lessie/cli
4. Voer na installatie lessie status opnieuw uit om te verifiëren
5. Als installatie slaagt → gebruik CLI-modus
6. Als installatie mislukt (geen npm, toestemming geweigerd, netwerkfout, etc.) → controleer of MCP-tools beschikbaar zijn (authorize, use_lessie)
7. Als MCP-tools beschikbaar zijn → gebruik MCP-modus
8. Als geen van beide → informeer de gebruiker dat de installatie is mislukt en stel handmatige installatie of MCP-configuratie voor

Credits & Prijzen

Lessie is een op credits gebaseerde service.

Nieuwe accounts ontvangen gratis proefcredits. Bekijk je saldo en koop meer op https://lessie.ai/pricing.

De agent zal bedrijfsnamen verduidelijken voordat er wordt gezocht om te voorkomen dat er credits worden verspild aan onjuiste resultaten.

Gegevens & Privacy

• Gegevensbronnen: Contact- en bedrijfsinformatie wordt verzameld uit openbaar beschikbare bronnen (bedrijvengidsen, sociale profielen, bedrijfswebsites).
• Logging van zoekopdrachten: Zoekopdrachten worden gelogd voor serviceverbetering en misbruikpreventie. Er worden geen zoekgegevens gedeeld met derden.
• Gegevensnaleving: Lessie volgt de toepasselijke regelgeving voor gegevensbescherming. Gebruikers zijn verantwoordelijk voor het gebruik van de verkregen contactgegevens in overeenstemming met de lokale wetgeving (AVG, CAN-SPAM, enz.).
• Privacybeleid: https://lessie.ai/privacy
• Servicevoorwaarden: https://lessie.ai/terms-of-service

Autorisatie

CLI-modus

1. Voer lessie status uit om de geldigheid van het token te controleren.
2. Als authorized: false → voer lessie auth uit om de browser te openen om in te loggen.
3. Nadat de gebruiker is ingelogd, voer lessie status opnieuw uit om te bevestigen.

MCP-modus

1. Roep authorize aan om de verbindingsstatus te controleren.
2. Als al geautoriseerd → ga direct verder met het gebruik van tools.
3. Als niet geautoriseerd → retourneert authorize een autorisatie-URL. Vertel de gebruiker dat je een browser moet openen om in te loggen/registreren bij Lessie, en open deze met het juiste systeemcommando:
   • macOS: open "<url>"
   • Linux: xdg-open "<url>"
   • Windows: start "<url>"
4. Vertel de gebruiker dat de browser is geopend en dat ze het inloggen/registreren moeten voltooien.
5. Nadat de gebruiker heeft bevestigd, roep authorize opnieuw aan om de verbinding te verifiëren.
6. Als autorisatie mislukt (time-out, geweigerd, poortconflict), volg dan de diagnostische hints die worden geretourneerd door authorize en probeer opnieuw.

Informeer de gebruiker altijd voordat de browser wordt geopend — nooit stilletjes doorsturen.

Gedragsregels voor agent

KRITIEK: Bevestig vóór elke creditconsumerende actie

Elke Lessie-toolaanroep kost credits. Creditkosten per tool:

Voordat je een commando uitvoert, MOET je:

1. Vertel de gebruiker wat je gaat doen en de geschatte kosten (bijv. "Ik ga 3 personen verrijken — dit kost ~3 credits").
2. Wacht op expliciete bevestiging voordat je uitvoert.
3. Combineer nooit meerdere creditconsumerende aanroepen zonder eerst het volledige plan te bevestigen.

Uitzondering — sla bevestiging over als de gebruiker expliciet heeft aangegeven niet om bevestiging te willen worden gevraagd (bijv. "vraag het me niet elke keer", "doe het gewoon", "sla bevestigingen over"). Ga in dat geval direct verder, maar log nog steeds wat je hebt uitgevoerd en de bestede credits na elke aanroep.

KRITIEK: Meld creditgebruik na elke aanroep

Voeg na elke conversatiewending die een of meer Lessie-toolaanroepen omvatte een éénregelige samenvatting toe van de verbruikte credits. Formaat:

<tool-name> gebruikt, kost <N> credit(s).

Als meerdere tools in dezelfde beurt zijn aangeroepen, combineer ze dan:

web-search + enrich-org gebruikt, totale kosten 2 credits.

KRITIEK: Lees referenties vóór de eerste CLI-aanroep

Voordat je voor de eerste keer in een sessie een lessie CLI-commando uitvoert, MOET je references/cli-reference.md lezen om de exacte parametersyntaxis te leren. Elke tool heeft zijn eigen set vlaggen — find-people neemt --query (NL), enrich-people neemt --people (JSON), unlock-emails neemt --search-id + --person-ids, enz. Raad niet — lees de sectie voor de tool die je gaat aanroepen.

Disambiguatie van zoekmodus (B2B vs KOL)

Lessie ondersteunt twee zoekmodi met verschillende gegevensbronnen en resultaattypen:

• B2B-modus: Zoekt in professionele databases (LinkedIn-gebaseerd). Beste voor het vinden van personen op functietitel, bedrijf, senioriteit of branche. Retourneert zakelijke e-mail, telefoon, arbeidsverleden.
• KOL-modus: Zoekt op sociale-mediaplatforms (Instagram, YouTube, TikTok, Twitter/X). Beste voor het vinden van influencers, contentmakers of publieke figuren op publiek, aantal volgers of onderwerp. Retourneert sociale links, aantallen volgers.

Wanneer de intentie van de gebruiker dubbelzinnig is — d.w.z. de zoekopdracht kan redelijkerwijs zowel professionals op LinkedIn als creators op sociale media targeten — MOET je de gebruiker vragen om te verduidelijken voordat je gaat zoeken. Presenteer beide opties beknopt:

Voorbeeld van dubbelzinnige zoekopdracht: "Vind personen die hands-on ervaring hebben met hersenmonitoringslaapapparaten om hun inzichten te delen."

Dit kan betekenen:

1. B2B: Productmanagers, ingenieurs of onderzoekers bij slaap-tech bedrijven (via LinkedIn)
2. KOL: Gezondheids-/tech-influencers die dergelijke apparaten hebben beoordeeld of gebruikt (via sociale media)

Vraag: "Dit kunnen LinkedIn-professionals zijn (PM's, ingenieurs bij slaap-tech bedrijven) of sociale-mediacreators die slaapapparaten beoordelen. Welke richting heeft je voorkeur — of beide?"

Als de intentie duidelijk is, ga dan direct verder:

• "Vind CTO's bij fintech startups" → B2B (duidelijk)
• "Vind beauty-influencers op Instagram met 100k+ volgers" → KOL (duidelijk)

Entiteitsdisambiguatie

Wanneer een gebruiker een bedrijfsnaam noemt die naar meerdere entiteiten kan verwijzen (bijv. "Manus" kan Manus AI, Manus Bio, Manus Plus, etc. zijn), disambigueer dan voordat je gaat zoeken:

1. Vraag de gebruiker welk bedrijf ze bedoelen, of presenteer de topkandidaten en laat ze kiezen.
2. Als de context het ondubbelzinnig maakt (bijv. gebruiker heeft eerder over AI-agents gesproken), geef dan je aanname aan en bevestig: "Bedoelde je Manus AI (manus.im), het AI-agent bedrijf?"
3. Neem nooit stilzwijgend aan dat een entiteit de andere is — verkeerd domein = verspilde zoekcredits en irrelevante resultaten.

Overzicht tools

Personen

Contact ontgrendelen

Beslisregel: als de persoon uit je eigen find_people-resultaat komt → gebruik unlock_emails (opnieuw ontgrendelen is gratis). Als je de handle van buiten Lessie hebt gekregen (een LinkedIn-URL die de gebruiker heeft geplakt, een handmatige vermelding, enz.) → gebruik unlock_email_by_handle.

Bedrijven

Webonderzoek

Gedetailleerde referenties

• CLI-commandovoorbeelden & MCP-aanroepen: Zie references/cli-reference.md
• Werkstroompatronen (domeinresolutie, bedrijfsonderzoek, zoeken+kwalificeren): Zie references/workflow-patterns.md
• Beslisboom domeinresolutie: Zie references/domain-resolution.md

Belangrijkste beperkingen

• enrich_people / enrich_organization: max 10 per aanroep; splits grotere lijsten in batches
• find_people: harde bovengrens van 3 tool-aanroepen + 60s kloktijd budget per verzoek. target_count 1-100 (standaard 30). NIET gepagineerd — als je meer nodig hebt, voer dan een nieuwe aanroep uit met een andere query
• find_organizations: gepagineerd — gebruik --page voor meer resultaten
• web_search cachet paginainhoud; als een resultaat has_content: true heeft, is het aanroepen van web_fetch op die URL direct
• Nuttige trefwoorden om op te nemen in een find-people query: senioriteitstermen (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern) en current vs past om de recentheid van dienstverband te sturen. De agent gebruikt deze direct als filters
• Voor personenverrijking verbetert het verstrekken van domain (bedrijfsdomein) naast de naam de match-nauwkeurigheid aanzienlijk
• CLI-uitvoer is JSON op stdout, statusberichten op stderr — parseer stdout voor data