Personsøk agentferdighet

Lessie — Person Søk & Berikelse

Oppsett

Lessie støtter to moduser: CLI (standard, anbefalt) og MCP Server.

Modus A: CLI (standard)

Installer Lessie CLI-binæren:

npm install -g @lessie/cli

Eller bruk uten installasjon:

npx @lessie/cli --version

Førstegangsautorisering:

lessie auth

Dette åpner en nettleser for innlogging/registrering. Tokenet bufres ved ~/.lessie/oauth.json.

Bekreft tilkobling:

lessie status

Modus B: MCP Server

Legg til i MCP-konfigurasjonen din (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"
      }
    }
  }
}

Avinstallering

• CLI: npm uninstall -g @lessie/cli && rm -rf ~/.lessie/
• MCP: Fjern oppføringen "lessie" fra din .json og rm -rf ~/.lessie/

Versjonssjekk

Kjør disse sjekkene én gang i starten av hver sesjon, før modusidentifikasjon. Begge sjekkene er ikke-blokkerende — hvis en kommando feiler (nettverksfeil, tidsavbrudd), hopp over lydløst og fortsett.

Ferdighetsversjon

1. Les gjeldende lokal versjon fra denne filens metadata version-felt over.
2. Hent fjernversjon:

   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. Hvis fjernversjonen er nyere enn den lokale versjonen → fortell brukeren:

   ⬆️ En nyere versjon av people-search-ferdigheten er tilgjengelig ({lokal} → {fjern}). Kjør denne kommandoen for å oppdatere:

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

4. Hvis versjonene samsvarer eller sjekken feiler → hopp over, si ingenting.

CLI-versjon

1. Hent lokal CLI-versjon:

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

2. Hent siste publiserte versjon:

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

3. Hvis fjernversjonen er nyere → fortell brukeren:

   ⬆️ En nyere versjon av Lessie CLI er tilgjengelig ({lokal} → {fjern}). Kjør denne kommandoen for å oppdatere:

   npm install -g @lessie/cli
   

4. Hvis versjonene samsvarer eller en av kommandoene feiler → hopp over, si ingenting.

Hurtigstart

Etter oppsett, prøv å si til Claude:

• "Finn Engineering Managers hos Stripe i San Francisco"
• "Slå opp Sam Altmans kontaktinformasjon"
• "Undersøk OpenAI — nyheter og åpne jobbannonser"

Modusidentifikasjon

Bestem hvilken modus som skal brukes ved starten av hver sesjon:

1. Sjekk om lessie CLI er tilgjengelig: kjør lessie status
2. Hvis kommandoen lykkes → bruk CLI-modus (kall verktøy via Bash)
3. Hvis kommandoen feiler (ikke funnet) → forsøk automatisk installasjon: npm install -g @lessie/cli
4. Etter installasjon, kjør lessie status igjen for å bekrefte
5. Hvis installasjonen lykkes → bruk CLI-modus
6. Hvis installasjonen feiler (ingen npm, tilgang nektet, nettverksfeil, osv.) → sjekk om MCP-verktøy er tilgjengelige (authorize, use_lessie)
7. Hvis MCP-verktøyene er tilgjengelige → bruk MCP-modus
8. Hvis ingen → informer brukeren om at installasjonen mislyktes og foreslå manuell installasjon eller MCP-oppsett

Kreditter & Priser

Lessie er en kredittbasert tjeneste.

Nye kontoer mottar gratis prøvekreditter. Se din saldo og kjøp mer på https://lessie.ai/pricing.

Agenten vil avklare firmanavn før søk for å unngå å kaste bort kreditter på feil resultater.

Data & Personvern

• Datakilder: Kontakt- og firmaopplysninger er aggregert fra offentlig tilgjengelige kilder (bedriftskataloger, sosiale profiler, firmanettsteder).
• Spørringslogging: Søkespørringer logges for tjenesteforbedring og misbruksforebygging. Ingen spørringsdata deles med tredjeparter.
• Datasamsvar: Lessie følger gjeldende personvernregelverk. Brukere er ansvarlige for å bruke innhentede kontaktdata i samsvar med lokale lover (GDPR, CAN-SPAM, osv.).
• Personvernerklæring: https://lessie.ai/privacy
• Tjenestevilkår: https://lessie.ai/terms-of-service

Autorisering

CLI-modus

1. Kjør lessie status for å sjekke token-gyldighet.
2. Hvis authorized: false → kjør lessie auth for å åpne nettleser for innlogging.
3. Etter at brukeren er ferdig med innlogging, kjør lessie status igjen for å bekrefte.

MCP-modus

1. Kall authorize for å sjekke tilkoblingsstatus.
2. Hvis allerede autorisert → fortsett å bruke verktøy direkte.
3. Hvis ikke autorisert → authorize returnerer en autorisasjons-URL. Fortell brukeren at du må åpne en nettleser for Lessie-innlogging/registrering, og åpne den ved å bruke den aktuelle systemkommandoen:
   • macOS: open "<url>"
   • Linux: xdg-open "<url>"
   • Windows: start "<url>"
4. Fortell brukeren at nettleseren er åpnet og at de må fullføre innlogging/registrering.
5. Etter at brukeren bekrefter, kall authorize igjen for å verifisere tilkoblingen.
6. Hvis autorisasjon mislykkes (tidsavbrudd, nektet, portkonflikt), følg diagnosesporene returnert av authorize og prøv på nytt.

Informer alltid brukeren før du åpner nettleseren — aldri omdiriger lydløst.

Regler for agentoppførsel

KRITISK: Bekreft før hver kredittforbrukende handling

Hvert kall til et Lessie-verktøy koster kreditter. Kredittkostnader per verktøy:

Før du utfører noen kommando, MÅ du:

1. Fortell brukeren hva du skal gjøre og den estimerte kostnaden (f.eks., "Jeg skal berike 3 personer — dette koster ~3 kreditter").
2. Vent på uttrykkelig bekreftelse før du utfører.
3. Aldri samle flere kredittforbrukende kall uten å bekrefte hele planen først.

Unntak — hopp over bekreftelse hvis brukeren uttrykkelig har sagt at de ikke vil bli spurt (f.eks., "ikke spør meg hver gang", "bare gjør det", "hopp over bekreftelser"). I så fall, fortsett direkte, men logg fortsatt hva du utførte og kredittene brukt etter hvert kall.

KRITISK: Rapporter kredittforbruk etter hvert kall

Etter hver samtalerunde som involverte ett eller flere Lessie-verktøykall, legg til en linjes oppsummering av forbrukte kreditter. Format:

Brukte <tool-name>, kostet <N> kreditt(er).

Hvis flere verktøy ble kalt i samme runde, kombiner dem:

Brukte web-search + enrich-org, kostet 2 kreditter totalt.

KRITISK: Les referanser før første CLI-kall

Før du utfører noen lessie CLI-kommando for første gang i en sesjon, MÅ du lese references/cli-reference.md for å lære den nøyaktige parametersyntaksen. Hvert verktøy har sitt eget flaggsett — find-people bruker --query (NL), enrich-people bruker --people (JSON), unlock-emails bruker --search-id + --person-ids, osv. Ikke gjett — les avsnittet for verktøyet du skal kalle.

Avklaring av søkemodus (B2B vs KOL)

Lessie støtter to søkemoduser med forskjellige datakilder og resultattyper:

• B2B-modus: Søker i profesjonelle databaser (LinkedIn-basert). Best for å finne personer etter stillingstitel, selskap, ansiennitet eller bransje. Returnerer arbeidsepost, telefon, ansettelseshistorikk.
• KOL-modus: Søker på sosiale medieplattformer (Instagram, YouTube, TikTok, Twitter/X). Best for å finne influencere, innholdsskapere eller offentlige personer etter publikum, antall følgere eller innholdstema. Returnerer sosiale lenker, antall følgere.

Når brukerens hensikt er tvetydig — dvs. spørringen med rimelighet kan være rettet mot enten profesjonelle på LinkedIn eller skapere på sosiale medier — MÅ du be brukeren avklare før søk. Presenter begge alternativene kortfattet:

Eksempel på tvetydig spørring: "Finn enkeltpersoner med praktisk erfaring med hjernemonitorerende søvnenheter for å dele sin innsikt."

Dette kan bety:

1. B2B: Produktledere, ingeniører eller forskere hos søvnteknologiselskaper (via LinkedIn)
2. KOL: Helse-/teknologiinfluencere som har anmeldt eller brukt slike enheter (via sosiale medier)

Spør: "Dette kan være LinkedIn-profesjonelle (PM-er, ingeniører hos søvnteknologiselskaper) eller sosiale medier-skapere som anmelder søvnenheter. Hvilken retning foretrekker du — eller begge?"

Når hensikten er klar, fortsett direkte:

• "Finn CTO-er hos fintech-startups" → B2B (åpenbart)
• "Finn skjønnhetsinfluencere på Instagram med 100k+ følgere" → KOL (åpenbart)

Avklaring av enheter

Når en bruker nevner et firmanavn som kan referere til flere enheter (f.eks., "Manus" kan være Manus AI, Manus Bio, Manus Plus, osv.), avklar før du søker:

1. Spør brukeren hvilket selskap de mener, eller presenter toppkandidatene og la dem velge.
2. Hvis konteksten gjør det entydig (f.eks., brukeren diskuterte tidligere AI-agenter), angi din antagelse og bekreft: "Mente du Manus AI (manus.im), AI-agent-selskapet?"
3. Aldri anta lydløst én enhet over en annen — feil domene = bortkastede søkekreditter og irrelevante resultater.

Verktøyoversikt

Personer

Lås opp kontakt

Beslutningsregel: hvis personen kom fra ditt eget find_people-resultat → bruk unlock_emails (gjenopplåsing er gratis). Hvis du fikk håndtaket utenfra lessie (en LinkedIn-URL som brukeren limte inn, en manuell omtale, osv.) → bruk unlock_email_by_handle.

Selskaper

Nettsøk

Detaljerte referanser

• CLI-kommandoeksempler & MCP-kalling: Se references/cli-reference.md
• Arbeidsflytmønstre (domeneløsning, selskapsundersøkelse, søk+kvalifiser): Se references/workflow-patterns.md
• Beslutningstre for domeneløsning: Se references/domain-resolution.md

Viktige begrensninger

• enrich_people / enrich_organization: maks 10 per kall; del opp større lister i batcher
• find_people: hardt tak på 3 verktøykall + 60s klokkebudsjett per forespørsel. target_count 1-100 (standard 30). IKKE paginert — hvis du trenger mer, kjør et nytt kall med en annen spørring
• find_organizations: paginert — bruk --page for flere resultater
• web_search bufrer sideinnhold; hvis et resultat har has_content: true, er web_fetch-kall på den URL-en umiddelbar
• Nyttige nøkkelord å inkludere i en find-people-spørring: ansiennitetsbegreper (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern) og current vs past for å favorisere ansettelsesnyhet. Agenten bruker disse direkte som filtre
• For personberikelse, oppgi domain (selskapsdomene) ved siden av navnet forbedrer treffnøyaktigheten betraktelig
• CLI-utskrift er JSON på stdout, statusmeldinger på stderr — pars stdout for data