# Abilità Agente di Ricerca Persone

> Abilità Agente di Ricerca Persone per la generazione e l'arricchimento di lead B2B. Trova, qualifica e arricchisci professionisti, figure pubbliche, candidati e dati aziendali per vendite, recruiting e ricerca.

- Canonical: https://nanoskill.ai/it/skills/people-search
- Markdown: https://nanoskill.ai/it/skills/people-search.md
- Author: LessieAI
- Published: 2026-05-31T01:39:27.046Z
- Updated: 2026-07-25T04:21:32.916Z
- Language: it
- Source type: github
- Popularity signal: 22

## Sources

- https://github.com/LessieAI/lessie-skill

## Install

```shell
npx skills add https://github.com/LessieAI/lessie-skill/tree/main/people-search
```

## About

L'abilità Lessie di Ricerca e Arricchimento Persone consente agli utenti di trovare, qualificare e arricchire in modo efficiente informazioni su individui e organizzazioni. Che tu abbia bisogno di generare elenchi mirati di lead B2B, individuare candidati ideali per il recruiting o condurre ricerche di background approfondite, questa abilità semplifica il processo sfruttando database completi e intelligenza web.

Questa potente abilità offre due modalità di ricerca: una modalità B2B per professionisti basata su titoli di lavoro, aziende e anzianità, e una modalità KOL (Key Opinion Leader) per identificare influencer e figure pubbliche sulle principali piattaforme di social media. Fornisce inoltre solide capacità di ricerca aziendale, consentendo di approfondire specificità del settore, round di finanziamento, stack tecnologici e attività di assunzione.

Progettato con trasparenza, Lessie opera su un sistema basato su crediti, garantendo che tu sia sempre consapevole dei costi prima di qualsiasi azione. Include opzioni flessibili per sbloccare le informazioni di contatto, con ri-sblocchi per individui precedentemente trovati spesso gratuiti. L'abilità integra anche strumenti di ricerca web generale e di recupero per esigenze di ricerca più ampie, rendendola una risorsa versatile per l'intelligence aziendale e l'outreach.

## Key features

- **Doppia modalità di ricerca (B2B e KOL)**: Utilizza la modalità B2B per cercare database professionali per titoli di lavoro, aziende e anzianità, oppure la modalità KOL per trovare influencer e personaggi pubblici su piattaforme social in base al pubblico e al numero di follower.
- **Arricchimento Completo delle Persone**: Arricchisci i contatti conosciuti con profili dettagliati che includono email, telefono, cronologia lavorativa, link social e conteggio dei follower, migliorando la profondità dei tuoi dati di contatto.
- **Ricerca e Approfondimenti Aziendali**: Ricerca aziende per settore, finanziamenti, stack tecnologico e attività di assunzione, fornendo una visione olistica delle organizzazioni target.
- **Utilizzo Basato su Crediti con Conferma**: Gestisci il tuo budget in modo efficace con un sistema di crediti trasparente. La funzionalità conferma i costi prima di eseguire qualsiasi azione che consuma crediti, prevenendo addebiti imprevisti.
- **Opzioni Flessibili di Sblocco dei Contatti**: Sblocca gli indirizzi email per le persone da ricerche precedenti senza costi aggiuntivi per i ri-sblocchi, oppure sblocca i contatti tramite handle espliciti della piattaforma per lead esterni.

## Use cases

- **Generare liste di lead B2B**: Crea rapidamente liste di lead mirate cercando professionisti in base a titolo, azienda, posizione e anzianità, ideale per team di vendita e marketing.
- **Reperire Candidati per il Reclutamento**: Trova e qualifica in modo efficiente potenziali candidati per il reclutamento cercando database professionali e arricchendo i loro profili con informazioni di contatto essenziali.
- **Eseguire Ricerche di Background sul Web**: Conduci ricerche di background approfondite su individui o organizzazioni utilizzando strumenti integrati di ricerca e recupero web per raccogliere informazioni complete.
- **Identificare Opinion Leader Chiave (KOL)**: Scopri influencer e personaggi pubblici per pubblico, numero di follower o argomento dei contenuti su varie piattaforme social per campagne di marketing.

## Skill definition

# 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:

```bash
npm install -g @lessie/cli
```

Oppure usalo senza installare:

```bash
npx @lessie/cli --version
```

Autorizzazione al primo utilizzo:

```bash
lessie auth
```

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

Verifica la connessione:

```bash
lessie status
```

### Modalità B: MCP Server

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

```json
{
  "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:
   ```bash
   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:
   ```bash
   lessie --version 2>/dev/null || npx @lessie/cli --version 2>/dev/null
   ```
2. Ottieni l'ultima versione pubblicata:
   ```bash
   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:

| Strumento | Costo |
|------|------|
| `find-people` | **20 crediti** per ricerca |
| `enrich-people` | 1 credito × numero di persone (addebitato solo per corrispondenze riuscite) |
| `review-people` | 1 credito × numero di persone |
| `enrich-org` | 1 credito |
| `find-orgs` | 1 credito |
| `job-postings` | 1 credito |
| `company-news` | 1 credito |
| `web-search` | 1 credito |
| `web-fetch` | 1 credito |
| `unlock_emails` | **3 crediti** per ogni persona appena sbloccata (tariffa corrente; controlla `price_per_unlock` nella risposta per il valore in tempo reale). Le persone già sbloccate (in qualsiasi tua ricerca precedente) sono gratuite. I tentativi falliti non vengono addebitati |
| `unlock_email_by_handle` | **3 crediti** per sblocco riuscito (tariffa corrente; controlla `price_per_unlock` nella risposta per il valore in tempo reale). `not_found` e `failed` sono gratuiti. **Non idempotente** — eseguire di nuovo sullo stesso handle comporta un nuovo addebito |

**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](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

| Strumento | Comando CLI | Quando usarlo |
|------|-------------|-------------|
| `find_people` | `lessie find-people` | Scopri persone tramite un **compito in linguaggio naturale**. Passa la richiesta dell'utente testualmente tramite `--query`. L'agente sceglie le fonti (B2B / KOL / web), le parole chiave e si ferma automaticamente. **Limite massimo: 3 chiamate allo strumento + 60s di budget per richiesta.** Se la risposta ha `partial: true`, l'agente ha raggiunto il budget — i risultati sono quelli raccolti prima del timeout |
| `enrich_people` | `lessie enrich-people` | Arricchisci persone note con profili completi. **Due percorsi**: B2B (tramite linkedin_url o nome+dominio → email, telefono, storico lavorativo) e KOL (tramite nome utente twitter/instagram/tiktok/youtube → conteggio follower, link social). Massimo 10 per chiamata |
| `review_people` | `lessie review-people` | Qualifica in profondità candidati **ambigui** tramite ricerca web — salta per corrispondenze o mancate corrispondenze ovvie |

### Sblocco contatti

| Strumento | Comando CLI | Quando usarlo |
|------|-------------|-------------|
| `unlock_emails` | `lessie unlock-emails` | Sblocca gli indirizzi email per le persone da un risultato `find_people` precedente. **Idempotente per utente**: le persone che hai già sbloccato (in qualsiasi ricerca) costano 0. Accetta `search_id` + `person_ids` (1–50) |
| `unlock_email_by_handle` | `lessie unlock-email-by-handle` | Sblocca un'email tramite un `(piattaforma, handle)` esplicito, **senza una ricerca precedente**. Accetta una lista di `{piattaforma, handle}` (1–10). **NON idempotente** — chiamate ripetute sullo stesso handle riaddebitano. Usalo solo quando l'handle non è in nessun `find_people` che hai eseguito |

**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

| Strumento | Comando CLI | Quando usarlo |
|------|-------------|-------------|
| `find_organizations` | `lessie find-orgs` | Scopri aziende per nome, parola chiave, posizione, dimensione, finanziamenti |
| `enrich_organization` | `lessie enrich-org` | Ottieni il profilo completo per domini aziendali noti — settore, dipendenti, finanziamenti, stack tecnologico |
| `get_company_job_postings` | `lessie job-postings` | Visualizza offerte di lavoro attive (necessita di `organization_id` da enrich) |
| `search_company_news` | `lessie company-news` | Trova articoli di notizie recenti (necessita di `organization_id` da enrich) |

### Ricerca web

| Strumento | Comando CLI | Quando usarlo |
|------|-------------|-------------|
| `web_search` | `lessie web-search` | Ricerca web generica; i risultati in cache rendono gratuito il successivo `web_fetch` |
| `web_fetch` | `lessie web-fetch` | Estrai informazioni specifiche da un URL tramite riassunto AI |

## Riferimenti dettagliati

- **Esempi di comandi CLI e chiamate MCP**: Vedi [riferimenti/cli-reference.md](riferimenti/cli-reference.md)
- **Modelli di flusso di lavoro** (risoluzione del dominio, ricerca aziendale, ricerca+qualifica): Vedi [riferimenti/workflow-patterns.md](riferimenti/workflow-patterns.md)
- **Albero decisionale per la risoluzione del dominio**: Vedi [riferimenti/domain-resolution.md](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

## FAQ

### Che cos'è la funzionalità Lessie Ricerca e Arricchimento Persone?

La funzionalità Lessie Ricerca e Arricchimento Persone è uno strumento progettato per aiutare gli utenti a trovare, qualificare e arricchire informazioni su persone e aziende. Supporta vari casi d'uso come la generazione di lead B2B, il reperimento di candidati e la ricerca di background.

### Come installo la CLI di Lessie?

Puoi installare la CLI di Lessie globalmente usando npm con il comando: \`npm install -g @lessie/cli\`. In alternativa, puoi usare \`npx @lessie/cli --version\` per usarla senza un'installazione globale.

### Questa funzionalità supporta sia le ricerche B2B che KOL?

Sì, la funzionalità supporta sia la modalità B2B per database professionali (basati su LinkedIn) che la modalità KOL per piattaforme social (Instagram, YouTube, TikTok, Twitter/X) per trovare influencer e personaggi pubblici.

### Come gestisce Lessie l'utilizzo dei crediti e i prezzi?

Lessie è un servizio basato su crediti. I nuovi account ricevono crediti di prova gratuiti, e puoi acquistarne altri su lessie.ai/pricing. L'agente confermerà sempre il costo stimato prima di eseguire qualsiasi azione che consuma crediti.

### Posso sbloccare gli indirizzi email per le persone che ho già cercato?

Sì, se la persona proviene da un risultato precedente di \`find\_people\`, usando \`unlock\_emails\` non ti verrà addebitato di nuovo per i contatti già sbloccati. Se il contatto proviene da fuori Lessie, usa \`unlock\_email\_by\_handle\`.

### Che tipo di informazioni aziendali posso ricercare?

Puoi arricchire domini aziendali conosciuti per ottenere profili completi che includono settore, numero di dipendenti, dettagli sui finanziamenti, stack tecnologico, annunci di lavoro attivi e articoli di notizie recenti.