SalesTouch Docs
Todas las herramientas MCP
Solo lecturaExtracción

Buscar empresas en Sales Navigator

scrape_sales_navigator_companies

Busca y extrae empresas de Sales Navigator con filtros v2 explícitos, indicadores, búsquedas guardadas o recientes o una URL nativa.

Cuándo usarla

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

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

Requisitos

Proporciona exactamente un modo de búsqueda: url o filters.
Usa los indicadores v2 para contrataciones, conexiones de primer grado, cambios de dirección y eventos de financiación.
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 filtros nativos obsoletos como technology que no existen en el esquema estructurado v2.
La cuenta seleccionada debe tener acceso a Sales Navigator.

Ejemplo

Pídeselo a tu agente

Encuentra empresas de Sales Navigator en París que estén contratando y ampliando su departamento de Engineering.

Argumentos de la herramienta
{
  "filters": {
    "location": {
      "include": [
        {
          "query": "Paris"
        }
      ]
    },
    "spotlights": [
      "HIRING_ON_LINKEDIN"
    ],
    "department_headcount_growth": {
      "department": {
        "query": "Engineering"
      },
      "min": 1,
      "max": 100
    }
  },
  "limit": 1000,
  "preview_limit": 20
}
Envoltorio de respuesta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Un resultado de empresas guardado que puede exportarse o reutilizarse como company_result_id.

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í.

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.