SalesTouch Docs
Tutti gli strumenti MCP
Sola letturaEstrazione

Cerca persone in Sales Navigator

scrape_sales_navigator_people

Cerca ed estrai lead Sales Navigator con filtri v2 espliciti, una ricerca salvata o recente, un URL nativo oppure aziende da un risultato precedente.

Quando usarlo

Crea ed estrai una ricerca di lead Sales Navigator da filtri v2 espliciti, una ricerca salvata/recente, un URL nativo o un precedente risultato di aziende.

Scope richiesti
linkedin:accesssalestouch:use
Esecuzione
Chiamata sincrona a uno strumento MCP

Requisiti

Fornisci esattamente una modalità di ricerca: url, filters o company_result_id (company_result_id può essere combinato con normali filtri per persone).
Risolvi i valori indicati con linkedin.sales_navigator.search_parameters; non indovinare gli id del provider.
load_saved_search e load_recent_search sostituiscono i filtri normali; usali da soli.
Usa save_search con un nome per salvare la ricerca strutturata corrente in Sales Navigator.
Usa la modalità URL per un filtro nativo LinkedIn non esposto dallo schema strutturato v2.
L’account selezionato deve avere accesso a Sales Navigator.

Esempio

Chiedi al tuo agente

Trova 100 direttori HR nelle aziende del mio precedente risultato aziende di Sales Navigator.

Argomenti dello strumento
{
  "company_result_id": "scrape_companies_123",
  "filters": {
    "current_job_title": {
      "include": [
        {
          "query": "Human Resources Director"
        }
      ]
    }
  },
  "limit": 100,
  "preview_limit": 20
}
Envelope della risposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: Un risultato di persone salvato con anteprima, impaginazione ed esportazioni JSONL/CSV firmate.

Parametri

account_id
string

ID, nome utente, e-mail, handle o URL dell’account SalesTouch collegato.

url
string

URL di ricerca nativa di Sales Navigator. Usa la modalità URL per i filtri nativi assenti dal contratto v2 strutturato; non combinarla con filtri o company_result_id.

filters
object

Filtri espliciti di Sales Navigator v2. Risolvi gli ID di riferimento con linkedin_sales_navigator_search_parameters. load_saved_search e load_recent_search ognuno sostituisce i filtri ordinari e non devono essere combinati tra loro.

company_result_id
string

ID risultato azienda Sales Navigator salvato per limitare le aziende attuali.

limit
integer

Numero massimo di risultati da estrarre.

preview_limit
integer

Numero massimo di elementi di anteprima da restituire direttamente. Valore predefinito: 20.

Gli alias sono mostrati separatamente perché i client MCP inviano un oggetto JSON piatto. Usa un solo alias per ogni gruppo obbligatorio, non tutti gli alias.

Errori comuni

insufficient_scope

Ricollega l’MCP e approva l’autorizzazione LinkedIn richiesta.

paid_plan_required

Usa un workspace SalesTouch con accesso all’MCP LinkedIn.

trial_payment_method_required

Aggiungi un metodo di pagamento nella fatturazione SalesTouch per attivare la prova e l’accesso all’MCP LinkedIn.

sales_navigator_required

Seleziona o collega un account LinkedIn con accesso Sales Navigator attivo.

search_parameter_not_resolved

Esamina i candidati restituiti e riprova il filtro con l’id del candidato desiderato.

deprecated_filter_v2

Esegui la ricerca nativa equivalente di Sales Navigator tramite URL perché questo filtro precedente non è presente nel contratto strutturato v2.

filter_not_expressible_v2

Usa un URL di ricerca nativo di Sales Navigator per mantenere l’intento esatto del filtro.

In questa pagina

Quando usarloRequisitiEsempioParametriErrori comuniStrumenti correlati