SalesTouch Docs
Todas las herramientas MCP
Solo lecturaExtracción

Buscar personas en Sales Navigator

scrape_sales_navigator_people

Busca y extrae leads de Sales Navigator con filtros v2 explícitos, una búsqueda guardada o reciente, una URL nativa o empresas de un resultado anterior.

Cuándo usarla

Crea y extrae una búsqueda de leads de Sales Navigator a partir de filtros v2 explícitos, una búsqueda guardada/reciente, una URL nativa o un resultado anterior de empresas.

Scopes necesarios
linkedin:accesssalestouch:use
Ejecución
Llamada síncrona a una herramienta MCP

Requisitos

Proporciona exactamente un modo de búsqueda: url, filters o company_result_id (company_result_id puede combinarse con filtros normales de personas).
Resuelve los valores referenciados con linkedin.sales_navigator.search_parameters; no adivines ids del proveedor.
load_saved_search y load_recent_search sustituyen los filtros normales; úsalos solos.
Usa save_search con un nombre para guardar la búsqueda estructurada actual en Sales Navigator.
Usa el modo URL para un filtro nativo de LinkedIn que el esquema estructurado v2 no expone.
La cuenta seleccionada debe tener acceso a Sales Navigator.

Ejemplo

Pídeselo a tu agente

Encuentra 100 directores de RR. HH. en empresas de mi resultado anterior de empresas de Sales Navigator.

Argumentos de la herramienta
{
  "company_result_id": "scrape_companies_123",
  "filters": {
    "current_job_title": {
      "include": [
        {
          "query": "Human Resources Director"
        }
      ]
    }
  },
  "limit": 100,
  "preview_limit": 20
}
Envoltorio de respuesta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Un resultado de personas guardado con vista previa, paginación y exportaciones JSONL/CSV firmadas.

Parámetros

account_id
string

ID, nombre de usuario, correo, identificador o URL de la cuenta de SalesTouch conectada.

url
string

URL nativa de búsqueda de Sales Navigator. Usa el modo URL para filtros nativos ausentes del contrato v2 estructurado; no lo combines con filtros ni company_result_id.

filters
object

Filtros explícitos de Sales Navigator v2. Resuelve los ID de referencia con linkedin_sales_navigator_search_parameters. load_saved_search y load_recent_search cada uno reemplaza los filtros normales y no deben combinarse entre sí.

company_result_id
string

ID de resultado de empresa de Sales Navigator guardado para restringir empresas actuales.

limit
integer

Máximo de resultados que se extraerán.

preview_limit
integer

Máximo de elementos de vista previa que se devolverán en línea. Valor predeterminado: 20.

Los alias se muestran por separado porque los clientes MCP envían un objeto JSON plano. Usa un solo alias de cada grupo obligatorio, no todos los alias.

Errores frecuentes

insufficient_scope

Vuelve a conectar el MCP y aprueba el permiso de LinkedIn solicitado.

paid_plan_required

Usa un espacio de trabajo de SalesTouch con acceso al MCP de LinkedIn.

trial_payment_method_required

Añade un método de pago en la facturación de SalesTouch para activar la prueba y el acceso al MCP de LinkedIn.

sales_navigator_required

Selecciona o conecta una cuenta de LinkedIn con acceso activo a Sales Navigator.

search_parameter_not_resolved

Revisa los candidatos devueltos y vuelve a probar el filtro con el id del candidato deseado.

deprecated_filter_v2

Ejecuta la búsqueda nativa equivalente de Sales Navigator mediante URL porque este filtro anterior no existe en el contrato estructurado v2.

filter_not_expressible_v2

Usa una URL de búsqueda nativa de Sales Navigator para conservar la intención exacta de este filtro.

En esta página

Cuándo usarlaRequisitosEjemploParámetrosErrores frecuentesHerramientas relacionadas