SalesTouch Docs
Alle MCP-Tools
Nur LesenExtraktion

Personen in Sales Navigator suchen

scrape_sales_navigator_people

Suche und extrahiere Sales-Navigator-Leads mit expliziten v2-Filtern, einer gespeicherten oder aktuellen Suche, einer nativen URL oder Unternehmen aus einem früheren Ergebnis.

Wann verwenden

Erstelle und extrahiere eine Sales-Navigator-Lead-Suche aus expliziten v2-Filtern, einer gespeicherten/aktuellen Suche, einer nativen URL oder einem früheren Unternehmensergebnis.

Erforderliche Scopes
linkedin:accesssalestouch:use
Ausführung
Synchroner MCP-Tool-Aufruf

Voraussetzungen

Gib genau einen Suchmodus an: url, filters oder company_result_id (company_result_id kann mit gewöhnlichen Personenfiltern kombiniert werden).
Löse referenzierte Werte mit linkedin.sales_navigator.search_parameters auf; rate keine Anbieter-IDs.
load_saved_search und load_recent_search überschreiben gewöhnliche Filter; verwende sie allein.
Verwende save_search mit einem Namen, um die aktuelle strukturierte Suche in Sales Navigator zu speichern.
Verwende den URL-Modus für einen nativen LinkedIn-Filter, den das strukturierte v2-Schema nicht bereitstellt.
Das ausgewählte Konto muss Zugriff auf Sales Navigator haben.

Beispiel

Frage deinen Agenten

Finde 100 HR-Leiter in Unternehmen aus meinem vorherigen Sales-Navigator-Unternehmensergebnis.

Tool-Argumente
{
  "company_result_id": "scrape_companies_123",
  "filters": {
    "current_job_title": {
      "include": [
        {
          "query": "Human Resources Director"
        }
      ]
    }
  },
  "limit": 100,
  "preview_limit": 20
}
MCP-Antwortumschlag
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Erwartet: Ein gespeichertes Personenergebnis mit Vorschau, Paginierung und signierten JSONL-/CSV-Exporten.

Parameter

account_id
string

ID, Benutzername, E-Mail, Handle oder Konto-URL des verbundenen SalesTouch-Kontos.

url
string

Native Sales-Navigator-Such-URL. Verwende den URL-Modus für native Filter, die im strukturierten v2-Vertrag fehlen; nicht mit Filter oder company_result_id kombinieren.

filters
object

Explizite Sales-Navigator-v2-Filter. Löse Referenz-IDs mit linkedin_sales_navigator_search_parameters auf. load_saved_search und load_recent_search beide ersetzen gewöhnliche Filter und dürfen nicht miteinander kombiniert werden.

company_result_id
string

Gespeicherte Sales-Navigator-Unternehmensergebnis-ID zur Einschränkung aktueller Unternehmen.

limit
integer

Höchstzahl zu extrahierender Ergebnisse.

preview_limit
integer

Höchstzahl direkt zurückzugebender Vorschauelemente. Standard: 20.

Aliasse werden einzeln angezeigt, da MCP-Clients ein flaches JSON-Objekt senden. Verwende pro erforderlicher Gruppe genau einen Alias, nicht alle Aliasse.

Häufige Fehler

insufficient_scope

Verbinde das MCP erneut und genehmige die angeforderte LinkedIn-Berechtigung.

paid_plan_required

Verwende einen SalesTouch-Workspace mit Zugriff auf das LinkedIn-MCP.

trial_payment_method_required

Füge in der SalesTouch-Abrechnung eine Zahlungsmethode hinzu, um die Testphase und den Zugriff auf das LinkedIn-MCP zu aktivieren.

sales_navigator_required

Wähle oder verbinde ein LinkedIn-Konto mit aktivem Sales-Navigator-Zugriff.

search_parameter_not_resolved

Prüfe die zurückgegebenen Kandidaten und wiederhole den Filter mit der ID des gewünschten Kandidaten.

deprecated_filter_v2

Führe die entsprechende native Sales-Navigator-Suche per URL aus, da dieser bisherige Filter im strukturierten v2-Vertrag fehlt.

filter_not_expressible_v2

Verwende eine native Sales-Navigator-Such-URL, um die genaue Filterabsicht beizubehalten.