Come estrarre un profilo LinkedIn con gli agenti IA

Per estrarre un profilo LinkedIn con un agente IA, fornisci all’agente l’URL completo del profilo LinkedIn e chiedigli di usare lo strumento linkedin_lookup_profile di SalesTouch. Il risultato contiene dati strutturati del profilo che l’agente può verificare, riassumere, confrontare o formattare per il workflow successivo.

Questo approccio è ideale per cercare una persona nel momento in cui servono i dati. Non devi creare uno scraper Python, mantenere selettori, eseguire un’estensione del browser o copiare ogni campo manualmente.

Il modo più rapido per estrarre un profilo LinkedIn

Una volta collegato SalesTouch, il workflow effettivo richiede un solo prompt:

Usa SalesTouch per cercare questo profilo LinkedIn:
https://www.linkedin.com/in/example/

Chiama linkedin_lookup_profile prima di rispondere.

Restituisci nome completo, headline, ruolo attuale, azienda attuale,
località, URL LinkedIn canonico e tutti i campi non disponibili.
Usa solo il risultato dello strumento. Non dedurre le informazioni mancanti.

L’agente chiama SalesTouch, riceve i dati disponibili del profilo e formatta la risposta. Chiedere all’agente di controllare l’identità, segnalare i campi mancanti o preparare un’esportazione fa parte del prompt, non è un passaggio separato del prodotto.

Quando possibile, usa l’URL completo linkedin.com/in/. Un URL completo è meno ambiguo di un nome e più affidabile di un risultato di ricerca, uno screenshot o un reindirizzamento abbreviato.

Cos’è SalesTouch e perché ti serve?

Un agente IA può ragionare sul testo, ma incollare un URL LinkedIn in una chat non gli fornisce accesso live al profilo. Serve uno strumento capace di eseguire la ricerca.

SalesTouch è un MCP LinkedIn in hosting per agenti IA. MCP è la connessione che permette a Claude, Codex e altri agenti compatibili di scoprire e chiamare strumenti esterni. In questo workflow:

1. Il tuo agente IA comprende la richiesta e decide cosa fare con il risultato.
2. SalesTouch fornisce gli strumenti LinkedIn autenticati e restituisce dati strutturati.
3. Il tuo account LinkedIn collegato determina quali informazioni del profilo sono disponibili.

Questa separazione è utile perché non incolli la password LinkedIn o i cookie di sessione in un prompt. Colleghi LinkedIn dentro SalesTouch, quindi autorizzi l’agente a usare l’MCP SalesTouch.

Quali dati di un profilo LinkedIn puoi estrarre?

La chiamata linkedin_lookup_profile restituisce dati normalizzati del profilo, non uno screenshot o l’HTML grezzo della pagina. In base al profilo e a ciò cui può accedere l’account LinkedIn collegato, il risultato può includere:

• nome completo e headline
• ruolo e azienda attuali
• località
• URL canonico del profilo LinkedIn
• identificatori del profilo LinkedIn
• altri campi pubblici disponibili del profilo

I campi esatti possono variare. Il prompt deve dire all’agente di contrassegnare un valore assente come non disponibile invece di indovinarlo.

Questa chiamata non è un servizio di arricchimento dei contatti. Non promette un indirizzo email, un numero di telefono, dati privati del profilo o qualsiasi campo non disponibile per l’account collegato.

Aggiungi il contesto di azienda, post o conversazioni

La ricerca del profilo deve rimanere focalizzata sulla persona. Se ti serve un dossier di ricerca più ricco, chiedi all’agente di combinarla con un’altra chiamata SalesTouch:

Si tratta di chiamate separate, non di opzioni nascoste in linkedin_lookup_profile. Il workflow è così più preciso: richiedi solo il contesto necessario e mantieni ogni fonte visibile nel risultato.

Configura SalesTouch una sola volta

Se non hai mai usato SalesTouch, completa questa configurazione iniziale prima di eseguire i prompt della guida:

1. Crea un account SalesTouch.
2. Collega dentro SalesTouch l’account LinkedIn che deve eseguire le ricerche.
3. Aggiungi l’MCP remoto SalesTouch al tuo client IA. Usa la guida di configurazione per Claude o la guida di configurazione per Codex.

L’endpoint MCP in hosting è https://www.salestouch.io/api/mcp. Il client IA autorizza la connessione e scopre gli strumenti SalesTouch disponibili.

Per controllare la configurazione, chiedi all’agente di elencare gli account LinkedIn collegati o gli strumenti SalesTouch utilizzabili. Dovresti vedere linkedin_lookup_profile. Se lo strumento manca, aggiorna la connessione MCP o avvia una nuova conversazione dopo averla collegata.

Come funziona la chiamata di ricerca del profilo

La ricerca del profilo è volutamente semplice. Ha un input obbligatorio e uno facoltativo.

La chiamata è di sola lettura. Restituisce contenuto testuale MCP con un JSON formattato contenente i dati disponibili del profilo. L’agente può quindi trasformare la risposta nell’output richiesto.

La ricerca del profilo non accetta:

• un limit per i post
• un’opzione che aggiunge automaticamente dati aziendali o dei post
• un’espressione cron o un valore scheduled_for
• un’opzione nativa di esportazione CSV o JSONL

Per i post, usa linkedin_lookup_profile_posts con lo stesso identificatore del profilo e un limit facoltativo da 1 a 100. Per i dettagli aziendali, usa linkedin_lookup_company con URL, handle o identificatore dell’azienda. Per la ricorrenza, il client IA o l’host di automazione riesegue il prompt in base alla pianificazione.

Casi d’uso e prompt per estrarre profili LinkedIn

Scegli un prompt in base alla decisione o al risultato di cui hai bisogno. Ogni esempio usa la stessa ricerca del profilo in un workflow reale diverso.

Qualifica rapidamente un profilo

Usalo prima di accettare un lead, preparare una chiamata o decidere se una persona corrisponde al tuo profilo target.

Usa SalesTouch per cercare questo profilo LinkedIn:
https://www.linkedin.com/in/example/

Chiama linkedin_lookup_profile prima di rispondere.

Restituisci un breve riepilogo di qualificazione con:
1. Nome completo e headline.
2. Ruolo e azienda attuali.
3. Località.
4. Due fatti utili per comprendere il contesto professionale della persona.
5. Una riga separata "Dati mancanti".

Conferma prima che l’URL e l’identità restituiti corrispondano al mio input.
Separa i fatti recuperati dalla tua analisi. Non dedurre informazioni mancanti
e non eseguire azioni di scrittura su LinkedIn.

Crea un dossier di ricerca su profilo, azienda e contenuti

Usalo quando un profilo di base non basta. Il prompt aggiunge esplicitamente il contesto aziendale e i post recenti tramite chiamate separate.

Cerca questa persona con SalesTouch:
https://www.linkedin.com/in/example/

1. Chiama linkedin_lookup_profile per la persona.
2. Chiama linkedin_lookup_profile_posts per lo stesso profilo con limit 10.
3. Se il risultato del profilo contiene un URL LinkedIn, un handle o un
   identificatore risolvibile dell’azienda attuale, chiama
   linkedin_lookup_company per quell’azienda.
4. Se non è disponibile un identificatore aziendale risolvibile, segnala
   il limite e non indovinarne uno.

Restituisci quattro sezioni:
- Profilo verificato
- Azienda attuale
- Temi recenti nei post della persona
- Dati mancanti o non disponibili

Indica la fonte SalesTouch usata per ogni sezione. Distingui i fatti recuperati
dalla tua analisi. Non inviare messaggi e non eseguire azioni di scrittura su LinkedIn.

Questo workflow può rivelare un contesto professionale che una sola chiamata al profilo non può fornire. Mantiene inoltre chiara la provenienza, perché ogni sezione corrisponde a uno strumento dedicato.

Crea una riga CSV pronta per il CRM

Usalo quando vuoi incollare o salvare un record verificato in un foglio di calcolo o CRM. L’agente crea il CSV dal risultato del profilo.

Usa SalesTouch per chiamare linkedin_lookup_profile per:
https://www.linkedin.com/in/example/

Verifica che l’identità restituita corrisponda all’URL di input. Poi restituisci
esattamente due righe di CSV valido usando questa intestazione:
full_name,headline,current_role,current_company,location,linkedin_url,linkedin_id

Regole:
- Racchiudi ogni valore tra virgolette doppie.
- Esegui l’escape delle virgolette doppie secondo le regole CSV.
- Lascia vuoto un campo non disponibile.
- Non dedurre né arricchire i dati mancanti.
- Restituisci solo l’intestazione e una riga di dati, senza blocco Markdown o commenti.

Se il tuo agente può creare file, aggiungi: Salva il risultato come linkedin-profile.csv e dammi il file. Il file viene comunque generato dall’agente, non esportato nativamente da linkedin_lookup_profile.

Restituisci JSON rigoroso per un altro agente o un’API

Usa JSON quando un altro sistema elaborerà il record e uno schema stabile conta più della leggibilità.

Usa SalesTouch per chiamare linkedin_lookup_profile per:
https://www.linkedin.com/in/example/

Restituisci un oggetto JSON valido con esattamente queste chiavi:
full_name
headline
current_role
current_company
location
linkedin_url
linkedin_identifiers
unavailable_fields
unavailable_fields
source_tool

Usa null per uno scalare non disponibile e un array vuoto per una lista non disponibile.
Imposta source_tool su "linkedin_lookup_profile". Non dedurre dati mancanti.
Restituisci solo JSON, senza blocchi Markdown o commenti.

Monitora un profilo ogni settimana

Usalo quando il client IA supporta attività ricorrenti. Il client gestisce la pianificazione e chiede a SalesTouch di eseguire una nuova ricerca a ogni esecuzione.

Crea un’attività ricorrente chiamata "Controllo settimanale del profilo LinkedIn".

Pianificazione: ogni lunedì alle 09:00 Europe/Paris.

A ogni esecuzione:
1. Chiama linkedin_lookup_profile di SalesTouch per:
   https://www.linkedin.com/in/example/
2. Verifica l’identità restituita e normalizza nome completo, headline,
   ruolo attuale, azienda attuale, località e URL LinkedIn canonico.
3. Confronta il risultato con l’ultima esecuzione riuscita.
4. Segnala solo le modifiche confermate con i valori precedenti e nuovi.
5. Alla prima esecuzione, salva il risultato come riferimento.
6. Se la cronologia non può essere salvata o recuperata, segnala il limite
   invece di affermare che nulla è cambiato.

Usa solo dati SalesTouch. Non dedurre fatti mancanti, inviare messaggi
o eseguire azioni di scrittura su LinkedIn.

Non aggiungere parametri di pianificazione alla ricerca SalesTouch. La ricorrenza è una funzione del client IA o dell’host di automazione, che riesegue il prompt e attiva una nuova chiamata SalesTouch.

Scegli il formato di output o esportazione corretto

Il formato giusto dipende da ciò che avviene dopo la ricerca.

Per un profilo, linkedin_lookup_profile restituisce una risposta strutturata tramite MCP. Non crea un link di esportazione. Chiedi all’agente di convertire la risposta in JSON, CSV o in un file salvato.

Per i casi d’uso in massa, gli strumenti scrape_* di SalesTouch usano un flusso diverso. Salvano un dataset, restituiscono un’anteprima limitata e un result_id, e forniscono link firmati per esportazioni CSV e JSONL. Usa scrape_result_page con il result_id per leggere altre pagine senza forzare l’intero dataset nel contesto dell’agente.

Come deve apparire un risultato verificato

Una risposta riuscita deve rendere visibili sia la fonte sia ogni incertezza. Prima di riutilizzare i dati, controlla che:

1. La chiamata allo strumento sia terminata correttamente.
2. Il nome e l’URL canonico restituiti corrispondano alla persona prevista.
3. Ruolo, azienda e località provengano dalla risposta dello strumento.
4. I campi mancanti siano esplicitamente contrassegnati come non disponibili.
5. L’analisi sia separata dai fatti recuperati.
6. Non siano stati aggiunti dettagli di contatto non supportati.

Quando combini più chiamate, verifica inoltre che l’azienda corrisponda al ruolo attuale e che i post appartengano al membro risolto. Un risultato parziale resta utile se l’agente indica chiaramente quale chiamata o campo non era disponibile.

Un profilo o un’estrazione in massa?

Usa linkedin_lookup_profile quando conosci già la persona e ti serve contesto aggiornato per ricerca, qualificazione, personalizzazione o monitoraggio.

Usa uno strumento di estrazione in massa quando la fonte è una ricerca di persone, una ricerca Sales Navigator, un gruppo, un elenco di connessioni, il pubblico che ha interagito con un post o un’altra fonte multi-record. Gli strumenti in massa sono progettati per risultati salvati, paginazione ed esportazioni scaricabili.

Non trasformare per impostazione predefinita un’attività su una persona in un’estrazione in massa. La chiamata più piccola è più veloce da controllare, più semplice da verificare e mantiene il workflow allineato alla decisione immediata.

Perché SalesTouch è il modo migliore per farlo

SalesTouch offre all’agente IA un’interfaccia controllata per gli strumenti, invece di chiederti di incollare credenziali in un prompt, eseguire uno script di scraping sconosciuto o esporre i cookie del browser a un’estensione.

Le protezioni pratiche sono:

• la password LinkedIn e i cookie di sessione restano fuori dal prompt dell’agente
• la connessione MCP viene autorizzata separatamente
• linkedin_lookup_profile è una chiamata tipizzata di sola lettura
• le azioni di scrittura usano strumenti separati e devono richiedere un’intenzione esplicita
• l’account collegato limita ciò cui gli strumenti possono accedere
• i prompt possono vietare deduzioni e azioni di scrittura su LinkedIn

Nessun metodo di automazione LinkedIn è privo di rischi. Il Contratto con l’utente di LinkedIn e le indicazioni sul software vietato limitano scraping e automazione non autorizzati. SalesTouch non annulla queste regole e non implica l’approvazione di LinkedIn.

Usa i dati del profilo per uno scopo legittimo e proporzionato. Evita di raccogliere informazioni sensibili, non dedurre caratteristiche protette, riduci al minimo la conservazione e verifica le leggi e le condizioni della piattaforma applicabili al workflow.

Errori comuni e come risolverli

L’agente non vede gli strumenti SalesTouch

La connessione MCP manca o non è aggiornata. Ricollega SalesTouch nel client IA, avvia una nuova conversazione e chiedi all’agente di elencare gli strumenti SalesTouch disponibili.

Non è disponibile alcun account LinkedIn

Collega prima LinkedIn dentro SalesTouch. La connessione MCP permette all’agente di raggiungere SalesTouch, mentre la connessione LinkedIn fornisce a SalesTouch un account per eseguire la ricerca.

Viene restituita la persona sbagliata

Riprova con l’URL canonico completo linkedin.com/in/. Evita un semplice nome quando più persone potrebbero condividerlo. Chiedi all’agente di confrontare l’URL canonico restituito prima di continuare.

Alcuni campi sono vuoti

La disponibilità varia in base al profilo e all’account collegato. Considera i dati mancanti come non disponibili. Non chiedere all’agente di colmare i vuoti con supposizioni.

L’agente afferma di avere esportato un CSV nativo

Per la ricerca di un singolo profilo, il CSV è una trasformazione dell’agente. I link CSV e JSONL nativi appartengono ai risultati in massa scrape_*. Chiedi all’agente di indicare quale meccanismo ha creato il file.

Domande frequenti

ChatGPT, Claude o Codex possono estrarre da soli un profilo LinkedIn?

Non da un semplice URL. L’agente ha bisogno di uno strumento collegato che possa accedere a LinkedIn. SalesTouch fornisce lo strumento tramite il suo MCP in hosting, mentre l’agente gestisce ragionamento e output.

La ricerca del profilo restituisce indirizzi email o numeri di telefono?

Nessun contatto è garantito. linkedin_lookup_profile restituisce le informazioni del profilo disponibili tramite l’account collegato. Considera l’arricchimento dei contatti un workflow separato, con fonti e regole proprie.

Posso recuperare anche i post LinkedIn di una persona?

Sì. Chiedi all’agente di chiamare separatamente linkedin_lookup_profile_posts. Fornisci l’identificatore del membro e, facoltativamente, un limite da 1 a 100. I risultati vengono restituiti dal più recente e possono includere post più vecchi di 30 giorni, quando disponibili.

Posso recuperare dettagli sull’azienda della persona?

Sì. Usa linkedin_lookup_company con un URL, un handle o un identificatore risolvibile dell’azienda su LinkedIn. Non dedurre un identificatore aziendale dal nome quando il risultato del profilo non fornisce informazioni sufficienti.

SalesTouch può monitorare il profilo ogni settimana?

SalesTouch esegue la nuova ricerca a ogni esecuzione. La pianificazione ricorrente appartiene al client IA o all’host di automazione. Salva un primo riferimento e definisci cosa fare quando la cronologia precedente non è disponibile.

La ricerca è di sola lettura?

Sì. linkedin_lookup_profile, linkedin_lookup_profile_posts e linkedin_lookup_company sono operazioni di lettura. Non inviano inviti né messaggi.

Posso esportare il risultato in CSV?

Per un profilo, chiedi all’agente di formattare o salvare una riga CSV. Per un risultato in massa scrape_*, usa i link firmati nativi per l’esportazione CSV o JSONL restituiti insieme al dataset salvato.

Estrai il tuo primo profilo LinkedIn

Il workflow affidabile più semplice è questo: collega SalesTouch una volta, fornisci all’agente un URL completo del profilo, richiedi l’output adatto al caso d’uso e integra nel prompt la verifica della fonte.

Inizia dal prompt di qualificazione. Aggiungi dati aziendali, post recenti, un formato di esportazione o una pianificazione ricorrente solo quando la decisione successiva lo richiede.