Sola letturaEstrazione

Cerca aziende in Sales Navigator

scrape_sales_navigator_companies

Cerca ed estrai aziende Sales Navigator con filtri v2 espliciti, segnali, ricerche salvate o recenti oppure un URL nativo.

Quando usarlo

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

Scope richiesti

linkedin:accesssalestouch:use

Esecuzione

Chiamata sincrona a uno strumento MCP

Requisiti

Fornisci esattamente una modalità di ricerca: url o filters.

Usa i segnali v2 per assunzioni, collegamenti di primo grado, cambi di leadership ed eventi di finanziamento.

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 i filtri nativi deprecati, come technology, assenti dallo schema strutturato v2.

L’account selezionato deve avere accesso a Sales Navigator.

Esempio

Chiedi al tuo agente

Trova aziende Sales Navigator a Parigi che stanno assumendo e ampliando il reparto Engineering.

Argomenti dello strumento

{
  "filters": {
    "location": {
      "include": [
        {
          "query": "Paris"
        }
      ]
    },
    "spotlights": [
      "HIRING_ON_LINKEDIN"
    ],
    "department_headcount_growth": {
      "department": {
        "query": "Engineering"
      },
      "min": 1,
      "max": 100
    }
  },
  "limit": 1000,
  "preview_limit": 20
}

Envelope della risposta MCP

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Risultato atteso: Un risultato di aziende salvato che può essere esportato o riutilizzato come company_result_id.

Parametri

NomeTipoDescrizione

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.

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.