SalesTouch Docs
Todas as ferramentas MCP
Somente leituraLinkedIn

Parâmetros de busca do LinkedIn

linkedin_sales_navigator_search_parameters

Descubra ids de parâmetros v2 específicos da conta para buscas estruturadas no LinkedIn Classic ou Sales Navigator. O nome legado da ferramenta é mantido por compatibilidade.

Quando usar

Descubra os ids v2 exatos específicos da conta antes de uma busca estruturada no LinkedIn Classic ou Sales Navigator.

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

Requisitos

Forneça um tipo de parâmetro explícito; use saved_people_search, saved_company_search ou recent_search para buscas reutilizáveis.
Passe o id retornado em {id: ...}; {query: ...} também é aceito quando o rótulo é identificado de forma única.
Defina product como classic para filtros de busca Classic; o padrão continua sendo sales_navigator por compatibilidade.

Exemplo

Peça ao seu agente

Encontre o parâmetro de localização do Sales Navigator para Paris.

Argumentos da ferramenta
{
  "type": "location",
  "query": "Paris",
  "limit": 10
}
Envelope da resposta MCP
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Resultado esperado: Ids e rótulos de parâmetros candidatos, além dos metadados disponíveis de buscas salvas que podem ser passados diretamente para uma busca estruturada v2.

Parâmetros

account_id
string

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

product
string

Produto de pesquisa. Padrão: sales_navigator for backward compatibility.

typeobrigatório
string

Família de parâmetros do LinkedIn Classic ou Sales Navigator a pesquisar.

query
string

Valor legível a resolver. Opcional para tipos semelhantes a listas.

limit
integer

Máximo de candidatos a retornar. Padrão: 10.

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.