Somente leituraExtração

Buscar empresas no Sales Navigator

scrape_sales_navigator_companies

Pesquise e extraia empresas do Sales Navigator com filtros v2 explícitos, indicadores, buscas salvas ou recentes ou uma URL nativa.

Quando usar

Crie e extraia uma busca de empresas do Sales Navigator por filtros v2 explícitos, indicadores, uma busca salva/recente ou uma URL nativa.

Escopos necessários

linkedin:accesssalestouch:use

Execução

Chamada síncrona de ferramenta MCP

Requisitos

Forneça exatamente um modo de busca: url ou filters.

Use os indicadores v2 para contratações, conexões de primeiro grau, mudanças de liderança e eventos de captação.

Identifique os valores referenciados com linkedin.sales_navigator.search_parameters; não invente ids do provedor.

load_saved_search e load_recent_search substituem os filtros comuns; use-os sozinhos.

Use save_search com um nome para salvar a busca estruturada atual no Sales Navigator.

Use o modo URL para filtros nativos descontinuados, como technology, que não existem no esquema estruturado v2.

A conta selecionada deve ter acesso ao Sales Navigator.

Exemplo

Peça ao seu agente

Encontre empresas do Sales Navigator em Paris que estejam contratando e ampliando o departamento de Engineering.

Argumentos da ferramenta

{
  "filters": {
    "location": {
      "include": [
        {
          "query": "Paris"
        }
      ]
    },
    "spotlights": [
      "HIRING_ON_LINKEDIN"
    ],
    "department_headcount_growth": {
      "department": {
        "query": "Engineering"
      },
      "min": 1,
      "max": 100
    }
  },
  "limit": 1000,
  "preview_limit": 20
}

Envelope da resposta MCP

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Um resultado de empresas salvo que pode ser exportado ou reutilizado como company_result_id.

Parâmetros

NomeTipoDescrição

account_id

string

ID, nome de usuário, e-mail, identificador ou URL da conta da SalesTouch conectada.

url

string

URL nativa de pesquisa do Sales Navigator. Use o modo URL para filtros nativos ausentes do contrato v2 estruturado; não combine com filtros ou company_result_id.

filters

object

Filtros explícitos do Sales Navigator v2. Resolva os IDs de referência com linkedin_sales_navigator_search_parameters. load_saved_search e load_recent_search cada um substitui os filtros comuns e eles não devem ser combinados.

limit

integer

Máximo de resultados a extrair.

preview_limit

integer

Máximo de itens de prévia a retornar em linha. Padrão: 20.

Os aliases são exibidos separadamente porque os clientes MCP enviam um objeto JSON plano. Use apenas um alias de cada grupo obrigatório, não todos os aliases.

Erros comuns

insufficient_scope

Reconecte o MCP e aprove a permissão solicitada do LinkedIn.

paid_plan_required

Use um espaço de trabalho da SalesTouch com acesso ao MCP do LinkedIn.

trial_payment_method_required

Adicione uma forma de pagamento no faturamento da SalesTouch para ativar o período de teste e o acesso ao MCP do LinkedIn.

sales_navigator_required

Selecione ou conecte uma conta do LinkedIn com acesso ativo ao Sales Navigator.

search_parameter_not_resolved

Confira os candidatos retornados e tente o filtro novamente com o id do candidato desejado.

deprecated_filter_v2

Execute a busca nativa equivalente do Sales Navigator por URL, pois esse filtro legado não existe no contrato estruturado v2.

filter_not_expressible_v2

Use uma URL de busca nativa do Sales Navigator para preservar a intenção exata desse filtro.