Lecture seuleExtraction

Rechercher des entreprises dans Sales Navigator

scrape_sales_navigator_companies

Recherchez et extrayez des entreprises Sales Navigator avec des filtres v2 explicites, des signaux, des recherches enregistrées ou récentes, ou une URL native.

Quand l’utiliser

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

Scopes requis

linkedin:accesssalestouch:use

Exécution

Appel d’outil MCP synchrone

Prérequis

Fournissez exactement un mode de recherche : url ou filters.

Utilisez les signaux v2 pour les recrutements, les connexions de premier niveau, les changements de direction et les levées de fonds.

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 les filtres natifs obsolètes, comme technology, absents du schéma structuré v2.

Le compte sélectionné doit disposer d’un accès Sales Navigator.

Exemple

Demandez à votre agent

Trouve les entreprises Sales Navigator à Paris qui recrutent et développent leur département Engineering.

Arguments de l’outil

{
  "filters": {
    "location": {
      "include": [
        {
          "query": "Paris"
        }
      ]
    },
    "spotlights": [
      "HIRING_ON_LINKEDIN"
    ],
    "department_headcount_growth": {
      "department": {
        "query": "Engineering"
      },
      "min": 1,
      "max": 100
    }
  },
  "limit": 1000,
  "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 d’entreprises enregistré, exportable ou réutilisable comme company_result_id.

Paramètres

NomTypeDescription

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.

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.