SalesTouch Docs
Todas as ferramentas MCP
Somente leituraExtração

Buscar pessoas no Sales Navigator

scrape_sales_navigator_people

Pesquise e extraia leads do Sales Navigator com filtros v2 explícitos, uma busca salva ou recente, uma URL nativa ou empresas de um resultado anterior.

Quando usar

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

Escopos necessários
linkedin:accesssalestouch:use
Execução
Chamada síncrona de ferramenta MCP

Requisitos

Forneça exatamente um modo de busca: url, filters ou company_result_id (company_result_id pode ser combinado com filtros comuns de pessoas).
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 um filtro nativo do LinkedIn que o esquema estruturado v2 não expõe.
A conta selecionada deve ter acesso ao Sales Navigator.

Exemplo

Peça ao seu agente

Encontre 100 diretores de RH em empresas do meu resultado anterior de empresas do Sales Navigator.

Argumentos da ferramenta
{
  "company_result_id": "scrape_companies_123",
  "filters": {
    "current_job_title": {
      "include": [
        {
          "query": "Human Resources Director"
        }
      ]
    }
  },
  "limit": 100,
  "preview_limit": 20
}
Envelope da resposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Um resultado de pessoas salvo com prévia, paginação e exportações JSONL/CSV assinadas.

Parâmetros

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.

company_result_id
string

ID de resultado de empresa do Sales Navigator salvo para restringir empresas atuais.

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.

Nesta página

Quando usarRequisitosExemploParâmetrosErros comunsFerramentas relacionadas