Abilità Agente di Ricerca Persone

Lessie — Ricerca e Arricchimento Persone

Configurazione

Lessie supporta due modalità: CLI (predefinita, consigliata) e MCP Server.

Modalità A: CLI (predefinita)

Installa il binario della CLI di Lessie:

npm install -g @lessie/cli

Oppure usalo senza installare:

npx @lessie/cli --version

Autorizzazione al primo utilizzo:

lessie auth

Questo apre un browser per il login/registrazione. Il token viene salvato in cache in ~/.lessie/oauth.json.

Verifica la connessione:

lessie status

Modalità B: MCP Server

Aggiungi alla configurazione MCP (Claude Code ~/.claude.json, Cursor ~/.cursor/mcp.json, Codex ~/.codex/config.toml, ecc.):

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

Disinstallazione

• CLI: npm uninstall -g @lessie/cli && rm -rf ~/.lessie/
• MCP: Rimuovi la voce "lessie" dal tuo .json e esegui rm -rf ~/.lessie/

Controllo versione

Esegui questi controlli una volta all'inizio di ogni sessione, prima del rilevamento della modalità. Entrambi i controlli non sono bloccanti — se un comando fallisce (errore di rete, timeout), saltalo silenziosamente e procedi.

Versione della skill

1. Leggi la versione locale corrente dal campo metadata version sopra in questo file.
2. Ottieni la versione remota:

   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. Se la versione remota è più recente di quella locale → informa l'utente:

   ⬆️ È disponibile una versione più recente della skill people-search ({locale} → {remota}). Esegui questo comando per aggiornare:

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

4. Se le versioni coincidono o il controllo fallisce → salta, non dire nulla.

Versione CLI

1. Ottieni la versione locale della CLI:

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

2. Ottieni l'ultima versione pubblicata:

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

3. Se la versione remota è più recente → informa l'utente:

   ⬆️ È disponibile una versione più recente di Lessie CLI ({locale} → {remota}). Esegui questo comando per aggiornare:

   npm install -g @lessie/cli
   

4. Se le versioni coincidono o uno dei comandi fallisce → salta, non dire nulla.

Avvio rapido

Dopo la configurazione, prova a dire a Claude:

• "Trova Engineering Manager a Stripe a San Francisco"
• "Cerca le informazioni di contatto di Sam Altman"
• "Fai una ricerca su OpenAI — notizie recenti e offerte di lavoro aperte"

Rilevamento della modalità

Determina quale modalità usare all'inizio di ogni sessione:

1. Verifica se la CLI lessie è disponibile: esegui lessie status
2. Se il comando riesce → usa la modalità CLI (chiama gli strumenti tramite Bash)
3. Se il comando fallisce (non trovato) → tenta l'installazione automatica: npm install -g @lessie/cli
4. Dopo l'installazione, esegui di nuovo lessie status per verificare
5. Se l'installazione riesce → usa la modalità CLI
6. Se l'installazione fallisce (nessun npm, permesso negato, errore di rete, ecc.) → verifica se sono disponibili gli strumenti MCP (authorize, use_lessie)
7. Se gli strumenti MCP sono disponibili → usa la modalità MCP
8. Se nessuno dei due → informa l'utente che l'installazione è fallita e suggerisci l'installazione manuale o la configurazione MCP

Crediti e Prezzi

Lessie è un servizio basato su crediti.

I nuovi account ricevono crediti di prova gratuiti. Visualizza il tuo saldo e acquista altri crediti su https://lessie.ai/pricing.

L'agente disambiguerà i nomi delle aziende prima di cercare per evitare di sprecare crediti con risultati errati.

Dati e Privacy

• Fonti dei dati: Le informazioni di contatto e aziendali sono aggregate da fonti pubblicamente disponibili (directory aziendali, profili social, siti web aziendali).
• Registrazione delle query: Le query di ricerca vengono registrate per migliorare il servizio e prevenire abusi. Nessun dato delle query viene condiviso con terze parti.
• Conformità dei dati: Lessie segue le normative applicabili sulla protezione dei dati. Gli utenti sono responsabili dell'utilizzo dei dati di contatto recuperati nel rispetto delle leggi locali (GDPR, CAN-SPAM, ecc.).
• Informativa sulla privacy: https://lessie.ai/privacy
• Termini di servizio: https://lessie.ai/terms-of-service

Autorizzazione

Modalità CLI

1. Esegui lessie status per verificare la validità del token.
2. Se authorized: false → esegui lessie auth per aprire il browser per il login.
3. Dopo che l'utente ha completato il login, esegui di nuovo lessie status per confermare.

Modalità MCP

1. Chiama authorize per controllare lo stato della connessione.
2. Se già autorizzato → procedi a utilizzare direttamente gli strumenti.
3. Se non autorizzato → authorize restituisce un URL di autorizzazione. Di' all'utente che devi aprire un browser per il login/registrazione a Lessie e aprilo usando il comando di sistema appropriato:
   • macOS: open "<url>"
   • Linux: xdg-open "<url>"
   • Windows: start "<url>"
4. Di' all'utente che il browser è stato aperto e che deve completare il login/registrazione.
5. Dopo che l'utente conferma, chiama di nuovo authorize per verificare la connessione.
6. Se l'autorizzazione fallisce (timeout, rifiutata, conflitto di porta), segui i suggerimenti diagnostici restituiti da authorize e riprova.

Informa sempre l'utente prima di aprire il browser — non reindirizzare mai in modo silenzioso.

Regole di comportamento dell'agente

CRITICO: Conferma prima di ogni azione che consuma crediti

Ogni chiamata agli strumenti di Lessie costa crediti. Costo in crediti per strumento:

Prima di eseguire qualsiasi comando, DEVI:

1. Dire all'utente cosa stai per fare e il costo stimato (es., "Arricchirò 3 persone — questo costa ~3 crediti").
2. Attendere una conferma esplicita prima di eseguire.
3. Non raggruppare mai più chiamate che consumano crediti senza aver prima confermato il piano completo.

Eccezione — salta la conferma se l'utente ha esplicitamente detto che non vuole essere avvisato (es., "non chiedermelo ogni volta", "fallo e basta", "salta le conferme"). In tal caso, procedi direttamente ma registra comunque cosa hai eseguito e i crediti spesi dopo ogni chiamata.

CRITICO: Segnala l'utilizzo dei crediti dopo ogni chiamata

Dopo ogni turno di conversazione che ha coinvolto una o più chiamate agli strumenti di Lessie, aggiungi un riepilogo su una riga dei crediti consumati. Formato:

Usato <nome-strumento>, costo <N> credito/i.

Se sono stati chiamati più strumenti nello stesso turno, combinali:

Usato web-search + enrich-org, costo 2 crediti totali.

CRITICO: Leggi i riferimenti prima della prima chiamata CLI

Prima di eseguire qualsiasi comando lessie CLI per la prima volta in una sessione, DEVI leggere riferimenti/cli-reference.md per apprendere la sintassi esatta dei parametri. Ogni strumento ha il proprio set di flag — find-people accetta --query (NL), enrich-people accetta --people (JSON), unlock-emails accetta --search-id + --person-ids, ecc. Non tirare a indovinare — leggi la sezione per lo strumento che stai per chiamare.

Disambiguazione della modalità di ricerca (B2B vs KOL)

Lessie supporta due modalità di ricerca con diverse fonti di dati e tipi di risultati:

• Modalità B2B: Cerca nei database professionali (basati su LinkedIn). Ideale per trovare persone per titolo di lavoro, azienda, seniority o settore. Restituisce email di lavoro, telefono, storico lavorativo.
• Modalità KOL: Cerca nelle piattaforme di social media (Instagram, YouTube, TikTok, Twitter/X). Ideale per trovare influencer, creatori di contenuti o figure pubbliche per pubblico, numero di follower o argomento dei contenuti. Restituisce link social, conteggio follower.

Quando l'intento dell'utente è ambiguo — ovvero, la query potrebbe ragionevolmente riguardare sia professionisti su LinkedIn sia creatori sui social media — DEVI chiedere all'utente di chiarire prima di cercare. Presenta entrambe le opzioni in modo conciso:

Esempio di query ambigua: "Trova persone che hanno esperienza pratica con dispositivi per il monitoraggio del sonno cerebrale per condividere le loro opinioni."

Questo potrebbe significare:

1. B2B: Product manager, ingegneri o ricercatori in aziende di tecnologia del sonno (via LinkedIn)
2. KOL: Influencer di salute/tecnologia che hanno recensito o usato tali dispositivi (via social media)

Chiedi: "Potrebbero essere professionisti LinkedIn (PM, ingegneri in aziende di tecnologia del sonno) o creatori di social media che recensiscono dispositivi per il sonno. Quale direzione preferisci — o entrambe?"

Quando l'intento è chiaro, procedi direttamente:

• "Trova CTO in startup fintech" → B2B (ovvio)
• "Trova influencer di bellezza su Instagram con oltre 100k follower" → KOL (ovvio)

Disambiguazione delle entità

Quando un utente menziona un nome di azienda che potrebbe riferirsi a più entità (es., "Manus" potrebbe essere Manus AI, Manus Bio, Manus Plus, ecc.), disambigua prima di cercare:

1. Chiedi all'utente a quale azienda si riferisce, oppure presenta i principali candidati e lascia che scelga.
2. Se il contesto lo rende inequivocabile (es., l'utente ha discusso in precedenza di agenti AI), dichiara la tua ipotesi e conferma: "Intendevi Manus AI (manus.im), l'azienda di agenti AI?"
3. Non presumere mai silenziosamente un'entità rispetto a un'altra — dominio sbagliato = crediti di ricerca sprecati e risultati irrilevanti.

Panoramica degli strumenti

Persone

Sblocco contatti

Regola decisionale: se la persona proviene dal tuo stesso risultato find_people → usa unlock_emails (i ri-sblocchi sono gratuiti). Se hai ottenuto l'handle da fuori Lessie (un URL LinkedIn incollato dall'utente, una menzione manuale, ecc.) → usa unlock_email_by_handle.

Aziende

Ricerca web

Riferimenti dettagliati

• Esempi di comandi CLI e chiamate MCP: Vedi riferimenti/cli-reference.md
• Modelli di flusso di lavoro (risoluzione del dominio, ricerca aziendale, ricerca+qualifica): Vedi riferimenti/workflow-patterns.md
• Albero decisionale per la risoluzione del dominio: Vedi riferimenti/domain-resolution.md

Vincoli chiave

• enrich_people / enrich_organization: massimo 10 per chiamata; dividi liste più grandi in lotti
• find_people: limite massimo di 3 chiamate allo strumento + 60s di orologio a parete per richiesta. target_count 1-100 (predefinito 30). NON impaginato — se hai bisogno di più, esegui una nuova chiamata con una query diversa
• find_organizations: impaginato — usa --page per più risultati
• web_search memorizza nella cache il contenuto della pagina; se un risultato ha has_content: true, chiamare web_fetch su quell'URL è istantaneo
• Parole chiave utili da includere in una query find-people: termini di seniority (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern) e current vs past per favorire la recenza dell'impiego. L'agente li utilizza direttamente come filtri
• Per l'arricchimento delle persone, fornire domain (dominio aziendale) insieme al nome migliora notevolmente la precisione della corrispondenza
• L'output della CLI è JSON su stdout, messaggi di stato su stderr — analizza stdout per i dati