SalesTouch Docs
Todas as ferramentas MCP
Grava no LinkedInExtração

Extrair uma busca de pessoas do LinkedIn

scrape_linkedin_people_search

Inicie uma busca retomável de pessoas no LinkedIn Classic com filtros explícitos ou uma URL de busca nativa.

Quando usar

Pesquise e extraia pessoas do LinkedIn Classic usando filtros legíveis ou uma URL de busca nativa.

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

Requisitos

Forneça exatamente um modo de busca: filters ou uma URL de busca de pessoas do LinkedIn.
Use {query: ...} para locais, empresas, instituições de ensino, setores, serviços ou pessoas legíveis; use um id exato quando uma consulta for ambígua.

Exemplo

Peça ao seu agente

Extraia até 100 profissionais de growth em Paris pelo LinkedIn Classic.

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

Resultado esperado: Um id de resultado durável com status pending ou running, seguido de uma prévia concluída ou parcial e exportações ao consultá-lo com scrape_result_page.

Parâmetros

account_id
string

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

queue
boolean

Defina como true para retornar a pesquisa pendente imediatamente em vez de aguardar brevemente os resultados. Leia-os depois com scrape_result_page.

filters
object

Filtros explícitos da pesquisa de pessoas do LinkedIn Classic. As referências legíveis são resolvidas inside this tool. Não combine filtros com url.

url
string

URL de origem do LinkedIn.

limit
integer

Máximo de itens 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

Siga a action_url do erro: inicie o período de teste gratuito, escolha um plano se o teste ou a assinatura terminou, ou atualize a forma de pagamento após um pagamento recusado. details.reason indica o caso.

trial_payment_method_required

Tente novamente em um minuto se o checkout acabou de ser concluído; caso contrário, adicione uma forma de pagamento no faturamento da SalesTouch para ativar o período de teste e o acesso ao MCP do LinkedIn.