SalesTouch Docs
Todas as ferramentas MCP
Somente leituraLinkedIn

Explorar uma lista de leads do Sales Navigator

linkedin_sales_navigator_browse_lead_list

Explore as pessoas salvas em uma lista de leads do LinkedIn Sales Navigator.

Quando usar

Explore as pessoas salvas em uma lista de leads do Sales Navigator, com priorização ou ordenação opcionais.

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

Requisitos

Forneça o list_id retornado por linkedin_sales_navigator_get_lead_lists.
A conta selecionada deve ter acesso ao Sales Navigator.

Exemplo

Peça ao seu agente

Explore os leads que mudaram de cargo recentemente na lista de leads do Sales Navigator list_456.

Argumentos da ferramenta
{
  "list_id": "list_456",
  "offset": 0,
  "limit": 25,
  "spotlight": "RECENT_POSITION_CHANGE"
}
Envelope da resposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Perfis de leads salvos, contagem total, estado indicando se há mais resultados e próximo deslocamento quando disponível.

Parâmetros

account_id
string

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

list_idobrigatório
string

Exato Sales Navigator lead-list id retornado por linkedin_sales_navigator_get_lead_lists.

offset
integer

Deslocamento de paginação a partir de zero. Padrão: 0.

limit
integer

Máximo de leads a retornar. Padrão: 25.

spotlight
string

Filtro inteligente opcional para priorizar leads.

sort_by
string

Método de ordenação. Padrão: DATE_ADDED.

sort_order
string

Ordem de classificação. Padrão: DESCENDING.

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.