Lessie — Personsøgning og -berigelse
Opsætning
Lessie understøtter to tilstande: CLI (standard, anbefalet) og MCP-server.
Tilstand A: CLI (standard)
Installer Lessie CLI-binæren:
npm install -g @lessie/cli
Eller brug uden at installere:
npx @lessie/cli --version
Førstegangsgodkendelse:
lessie auth
Dette åbner en browser til login/registrering. Token gemmes i ~/.lessie/oauth.json.
Bekræft forbindelse:
lessie status
Tilstand B: MCP-server
Tilføj til din MCP-konfiguration (Claude Code ~/.claude.json, Cursor ~/.cursor/mcp.json, Codex ~/.codex/config.toml osv.):
{
"mcpServers": {
"lessie": {
"command": "npx",
"args": ["-y", "@lessie/mcp-server"],
"env": {
"LESSIE_REMOTE_MCP_URL": "https://app.lessie.ai/mcp-server/mcp"
}
}
}
}
Afinstallation
- CLI:
npm uninstall -g @lessie/cli && rm -rf ~/.lessie/ - MCP: Fjern
"lessie"-posten fra din.jsonogrm -rf ~/.lessie/
Versionskontrol
Kør disse kontroller én gang i starten af hver session, før tilstandsregistrering. Begge kontroller er ikke-blokerende — hvis en kommando fejler (netværksfejl, timeout), så spring stille over og fortsæt.
Færdighedsversion
- Læs den aktuelle lokale version fra denne fils metadatafelt
versionovenfor. - Hent fjernversion:
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}' - Hvis fjernversionen er nyere end den lokale version → fortæl brugeren:
⬆️ En nyere version af færdigheden people-search er tilgængelig ({local} → {remote}). Kør denne kommando for at opdatere:
npx skills add LessieAI/lessie-skill -y -g - Hvis versionerne matcher, eller kontrollen fejler → spring over, sig intet.
CLI-version
- Hent lokal CLI-version:
lessie --version 2>/dev/null || npx @lessie/cli --version 2>/dev/null - Hent seneste publicerede version:
npm view @lessie/cli version 2>/dev/null - Hvis fjernversionen er nyere → fortæl brugeren:
⬆️ En nyere version af Lessie CLI er tilgængelig ({local} → {remote}). Kør denne kommando for at opdatere:
npm install -g @lessie/cli - Hvis versionerne matcher, eller en af kommandoerne fejler → spring over, sig intet.
Hurtig start
Efter opsætning, prøv at sige til Claude:
- "Find ingeniørledere hos Stripe i San Francisco"
- "Slå Sam Altmans kontaktoplysninger op"
- "Undersøg OpenAI — seneste nyheder og åbne jobopslag"
Tilstandsregistrering
Afgør, hvilken tilstand der skal bruges i starten af hver session:
- Kontrollér, om
lessieCLI er tilgængelig: kørlessie status - Hvis kommandoen lykkes → brug CLI-tilstand (kald værktøjer via Bash)
- Hvis kommandoen fejler (ikke fundet) → forsøg auto-installation:
npm install -g @lessie/cli - Efter installation, kør
lessie statusigen for at bekræfte - Hvis installationen lykkes → brug CLI-tilstand
- Hvis installationen fejler (ingen npm, adgang nægtet, netværksfejl osv.) → kontrollér, om MCP-værktøjer er tilgængelige (
authorize,use_lessie) - Hvis MCP-værktøjer er tilgængelige → brug MCP-tilstand
- Hvis ingen af delene → informér brugeren om, at installationen mislykkedes, og foreslå manuel installation eller MCP-opsætning
Kreditter og priser
Lessie er en kreditbaseret tjeneste.
Nye konti modtager gratis prøvekreditter. Se din saldo og køb flere på https://lessie.ai/pricing.
Agenten vil disambiguere virksomhedsnavne før søgning for at undgå at spilde kreditter på forkerte resultater.
Data og privatliv
- Datakilder: Kontakt- og virksomhedsoplysninger aggregeres fra offentligt tilgængelige kilder (virksomhedsfortegnelser, sociale profiler, virksomhedswebsteder).
- Forespørgselslogning: Søgeforespørgsler logges til forbedring af tjenesten og forebyggelse af misbrug. Ingen forespørgselsdata deles med tredjeparter.
- Databeskyttelse: Lessie overholder gældende databeskyttelsesforordninger. Brugere er ansvarlige for at anvende indhentede kontaktdata i overensstemmelse med lokale love (GDPR, CAN-SPAM osv.).
- Privatlivspolitik: https://lessie.ai/privacy
- Tjenestevilkår: https://lessie.ai/terms-of-service
Godkendelse
CLI-tilstand
- Kør
lessie statusfor at kontrollere tokenets gyldighed. - Hvis
authorized: false→ kørlessie authfor at åbne browser til login. - Efter brugeren har gennemført login, kør
lessie statusigen for at bekræfte.
MCP-tilstand
- Kald
authorizefor at kontrollere forbindelsesstatus. - Hvis allerede godkendt → fortsæt med at bruge værktøjer direkte.
- Hvis ikke godkendt →
authorizereturnerer en godkendelses-URL. Fortæl brugeren, at du skal åbne en browser til Lessie-login/registrering, og åbn den ved hjælp af den relevante systemkommando:- macOS:
open "<url>" - Linux:
xdg-open "<url>" - Windows:
start "<url>"
- macOS:
- Fortæl brugeren, at browseren er blevet åbnet, og at de skal gennemføre login/registrering.
- Når brugeren bekræfter, kald
authorizeigen for at verificere forbindelsen. - Hvis godkendelsen mislykkes (timeout, nægtet, portkonflikt), følg de diagnostiske hints, der returneres af
authorize, og prøv igen.
Informer altid brugeren, før browseren åbnes — omdiriger aldrig stille.
Regler for agentadfærd
KRITISK: Bekræft før hver kredit-spisende handling
Hvert Lessie-værktøjskald koster kreditter. Kreditomkostninger pr. værktøj:
| Værktøj | Omkostning |
|---|---|
find-people | 20 kreditter pr. søgning |
enrich-people | 1 kredit × antal personer (kun opkrævet for vellykkede matches) |
review-people | 1 kredit × antal personer |
enrich-org | 1 kredit |
find-orgs | 1 kredit |
job-postings | 1 kredit |
company-news | 1 kredit |
web-search | 1 kredit |
web-fetch | 1 kredit |
unlock_emails | 3 kreditter pr. ny-oplåst person (aktuel sats; tjek price_per_unlock i svaret for den aktive værdi). Allerede oplåste personer (på tværs af alle dine tidligere søgninger) er gratis. Mislykkede opslag opkræves ikke |
unlock_email_by_handle | 3 kreditter pr. vellykket oplåsning (aktuel sats; tjek price_per_unlock i svaret for den aktive værdi). not_found og failed er gratis. Ikke idempotent — genkørsel på det samme håndtag opkræver igen |
Før du udfører nogen kommando, SKAL du:
- Fortæl brugeren, hvad du er ved at gøre, og den estimerede omkostning (f.eks. "Jeg beriger 3 personer — dette koster ~3 kreditter").
- Vent på udtrykkelig bekræftelse før udførelse.
- Saml aldrig flere kredit-spisende kald uden at bekræfte den fulde plan først.
Undtagelse — spring bekræftelse over hvis brugeren eksplicit har sagt, at de ikke ønsker at blive spurgt (f.eks. "spørg mig ikke hver gang", "bare gør det", "spring bekræftelser over"). I så fald, fortsæt direkte, men log stadig, hvad du udførte, og de brugte kreditter efter hvert kald.
KRITISK: Rapporter kreditforbrug efter hvert kald
Efter hver samtaletur, der involverede ét eller flere Lessie-værktøjskald, tilføj en én-linjes opsummering af forbrugte kreditter. Format:
Brugte
<tool-name>, kostede <N> kredit(er).
Hvis flere værktøjer blev kaldt i samme tur, kombiner dem:
Brugte
web-search+enrich-org, kostede 2 kreditter i alt.
KRITISK: Læs referencer før første CLI-kald
Før du udfører nogen lessie CLI-kommando for første gang i en session, SKAL du læse references/cli-reference.md for at lære den nøjagtige parametersyntaks. Hvert værktøj har sit eget flag-sæt — find-people tager --query (NL), enrich-people tager --people (JSON), unlock-emails tager --search-id + --person-ids osv. Gæt ikke — læs afsnittet for det værktøj, du er ved at kalde.
Søgetilstandsdisambiguering (B2B vs KOL)
Lessie understøtter to søgetilstande med forskellige datakilder og resultattyper:
- B2B-tilstand: Søger i professionelle databaser (LinkedIn-baseret). Bedst til at finde personer efter jobtitel, virksomhed, anciennitet eller branche. Returnerer arbejds-e-mail, telefon, ansættelseshistorik.
- KOL-tilstand: Søger på sociale medieplatforme (Instagram, YouTube, TikTok, Twitter/X). Bedst til at finde influencers, indholdsskabere eller offentlige personer efter publikum, følgerantal eller indholdsemne. Returnerer sociale links, følgerantal.
Når brugerens hensigt er tvetydig — dvs. forespørgslen kunne rimeligvis målrette enten professionelle på LinkedIn eller skabere på sociale medier — SKAL du bede brugeren om at præcisere før søgning. Præsenter begge muligheder kort:
Eksempel på tvetydig forespørgsel: "Find personer med praktisk erfaring med hjerneovervågnings-søvnudstyr for at dele deres indsigter."
Dette kunne betyde:
- B2B: Produktchefer, ingeniører eller forskere hos søvnteknologivirksomheder (via LinkedIn)
- KOL: Sundheds-/teknologi-influencere, der har anmeldt eller brugt sådanne enheder (via sociale medier)
Spørg: "Dette kunne være LinkedIn-professionelle (PM'er, ingeniører hos søvntek-firmaer) eller sociale medie-skabere, der anmelder søvnudstyr. Hvilken retning foretrækker du — eller begge?"
Når hensigten er klar, fortsæt direkte:
- "Find CTO'er hos fintech-startups" → B2B (åbenlyst)
- "Find skønhedsinfluencere på Instagram med 100k+ følgere" → KOL (åbenlyst)
Enhedsdisambiguering
Når en bruger nævner et virksomhedsnavn, der kunne henvise til flere enheder (f.eks. "Manus" kunne være Manus AI, Manus Bio, Manus Plus osv.), disambiguér før søgning:
- Spørg brugeren, hvilken virksomhed de mener, eller præsenter de bedste kandidater og lad dem vælge.
- Hvis konteksten gør det entydigt (f.eks. brugeren tidligere diskuterede AI-agenter), angiv din antagelse og bekræft: "Mente du Manus AI (manus.im), AI-agentvirksomheden?"
- Antag aldrig stille én enhed over en anden — forkert domæne = spildte søgekreditter og irrelevante resultater.
Værktøjsoversigt
Personer
| Værktøj | CLI-kommando | Hvornår skal bruges |
|---|---|---|
find_people | lessie find-people | Opdag personer via en naturligt sprog-opgave. Giv brugerens forespørgsel ordret igennem --query. Agenten vælger kilder (B2B / KOL / web), nøgleord og stopper automatisk. Hårdt loft: 3 værktøjskald + 60s budget pr. forespørgsel. Hvis svaret har partial: true, ramte agenten budgettet — resultater er, hvad den indsamlede før timeout |
enrich_people | lessie enrich-people | Berig kendte personer med fulde profiler. To veje: B2B (via linkedin_url eller navn+domæne → e-mail, telefon, arbejdshistorik) og KOL (via twitter/instagram/tiktok/youtube brugernavn → følgerantal, sociale links). Maks 10 pr. kald |
review_people | lessie review-people | Dybdekvalificér tvetydige kandidater via web-research — spring over for åbenlyse matches/mismatches |
Kontaktoplåsning
| Værktøj | CLI-kommando | Hvornår skal bruges |
|---|---|---|
unlock_emails | lessie unlock-emails | Lås e-mailadresser op for personer fra et tidligere find_people resultat. Pr. bruger idempotent: personer du allerede har låst op (i en hvilken som helst søgning) koster 0. Tager search_id + person_ids (1–50) |
unlock_email_by_handle | lessie unlock-email-by-handle | Lås e-mail op ved et eksplicit (platform, håndtag), uden forudgående søgning. Tager en liste af {platform, handle} (1–10). IKKE idempotent — gentagne kald på det samme håndtag opkræver igen. Brug kun når håndtaget ikke er i nogen find_people du har kørt |
Beslutningsregel: hvis personen kom fra dit eget find_people resultat → brug unlock_emails (genoplåsninger er gratis). Hvis du fik håndtaget uden for lessie (en LinkedIn-URL, brugeren indsatte, en manuel omtale osv.) → brug unlock_email_by_handle.
Virksomheder
| Værktøj | CLI-kommando | Hvornår skal bruges |
|---|---|---|
find_organizations | lessie find-orgs | Opdag virksomheder efter navn, nøgleord, placering, størrelse, finansiering |
enrich_organization | lessie enrich-org | Få fuld profil for kendte virksomhedsdomæne(r) — branche, ansatte, finansiering, tech-stack |
get_company_job_postings | lessie job-postings | Se aktive jobopslag (kræver organization_id fra enrich) |
search_company_news | lessie company-news | Find seneste nyhedsartikler (kræver organization_id fra enrich) |
Web-research
| Værktøj | CLI-kommando | Hvornår skal bruges |
|---|---|---|
web_search | lessie web-search | Generel websøgning; cachelagrede resultater gør opfølgende web_fetch gratis |
web_fetch | lessie web-fetch | Udtræk specifikke oplysninger fra en URL via AI-opsummering |
Detaljerede referencer
- CLI-kommandoeksempler og MCP-kald: Se references/cli-reference.md
- Workflow-mønstre (domæneopløsning, virksomhedsresearch, søg+kvalificer): Se references/workflow-patterns.md
- Domæneopløsnings beslutningstræ: Se references/domain-resolution.md
Vigtige begrænsninger
enrich_people/enrich_organization: maks 10 pr. kald; opdel større lister i batchesfind_people: hårdt loft på 3 værktøjskald + 60s wall-clock budget pr. forespørgsel.target_count1-100 (standard 30). IKKE pagineret — hvis du har brug for flere, kør et nyt kald med en anden forespørgselfind_organizations: pagineret — brug--pagefor flere resultaterweb_searchcacher sideindhold; hvis et resultat harhas_content: true, er kald afweb_fetchpå den URL øjeblikkeligt- Nyttige nøgleord at inkludere i en
find-peopleforespørgsel: anciennitetsbetegnelser (owner,founder,c_suite,partner,vp,head,director,manager,senior,entry,intern) ogcurrentvspastfor at biasere ansættelsesnyhed. Agenten bruger disse direkte som filtre - For personberigelse forbedrer angivelse af
domain(virksomhedsdomæne) sammen med navn match-nøjagtigheden betydeligt - CLI-output er JSON på stdout, statusmeddelelser på stderr — parse stdout for data