SalesTouch Docs
Tous les outils MCP
Lecture seuleExtraction

Rechercher des personnes dans Sales Navigator

scrape_sales_navigator_people

Recherchez et extrayez des leads Sales Navigator avec des filtres v2 explicites, une recherche enregistrée ou récente, une URL native ou des entreprises issues d’un résultat précédent.

Quand l’utiliser

Construisez et extrayez une recherche de leads Sales Navigator à partir de filtres v2 explicites, d’une recherche enregistrée/récente, d’une URL native ou d’un résultat d’entreprises antérieur.

Scopes requis
linkedin:accesssalestouch:use
Exécution
Appel d’outil MCP synchrone

Prérequis

Fournissez exactement un mode de recherche : url, filters ou company_result_id (company_result_id peut être combiné avec des filtres de personnes ordinaires).
Résolvez les valeurs référencées avec linkedin.sales_navigator.search_parameters ; ne devinez pas les identifiants du fournisseur.
load_saved_search et load_recent_search remplacent les filtres ordinaires ; utilisez-les seuls.
Utilisez save_search avec un nom pour enregistrer la recherche structurée actuelle dans Sales Navigator.
Utilisez le mode URL pour un filtre LinkedIn natif non exposé par le schéma structuré v2.
Le compte sélectionné doit disposer d’un accès Sales Navigator.

Exemple

Demandez à votre agent

Trouve 100 directeurs RH dans les entreprises de mon résultat d’entreprises Sales Navigator précédent.

Arguments de l’outil
{
  "company_result_id": "scrape_companies_123",
  "filters": {
    "current_job_title": {
      "include": [
        {
          "query": "Human Resources Director"
        }
      ]
    }
  },
  "limit": 100,
  "preview_limit": 20
}
Enveloppe de réponse MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Résultat attendu : Un résultat de personnes enregistré avec aperçu, pagination et exports JSONL/CSV signés.

Paramètres

account_id
string

Identifiant, nom d’utilisateur, e-mail, handle ou URL du compte SalesTouch connecté.

url
string

URL de recherche native Sales Navigator. Utilisez le mode URL pour les filtres natifs absents du contrat v2 structuré; ne le combinez pas avec filtres ou company_result_id.

filters
object

Filtres explicites Sales Navigator v2. Résolvez les identifiants de référence avec linkedin_sales_navigator_search_parameters. load_saved_search et load_recent_search chacun remplace les filtres ordinaires et ils ne doivent pas être combinés.

company_result_id
string

Identifiant de résultat d’entreprise Sales Navigator enregistré, utilisé pour limiter les entreprises actuelles.

limit
integer

Nombre maximal de résultats à extraire.

preview_limit
integer

Nombre maximal d’éléments d’aperçu à renvoyer directement. Par défaut : 20.

Les alias sont affichés séparément, car les clients MCP envoient un objet JSON plat. Utilisez un seul alias par groupe obligatoire, pas tous les alias.

Erreurs fréquentes

insufficient_scope

Reconnectez le MCP et approuvez l’autorisation LinkedIn demandée.

paid_plan_required

Utilisez un espace de travail SalesTouch avec un accès au MCP LinkedIn.

trial_payment_method_required

Ajoutez un moyen de paiement dans la facturation SalesTouch pour activer l’essai et l’accès au MCP LinkedIn.

sales_navigator_required

Sélectionnez ou connectez un compte LinkedIn disposant d’un accès Sales Navigator actif.

search_parameter_not_resolved

Examinez les candidats renvoyés et réessayez le filtre avec l’identifiant du candidat souhaité.

deprecated_filter_v2

Lancez la recherche native Sales Navigator équivalente par URL, car ce filtre historique est absent du contrat structuré v2.

filter_not_expressible_v2

Utilisez une URL de recherche native Sales Navigator pour préserver exactement l’intention de ce filtre.

Sur cette page

Quand l’utiliserPrérequisExempleParamètresErreurs fréquentesOutils associés