💬 Descrição

O LinkedInDumper é um script Python 3 que extrai dados de funcionários da plataforma de rede social LinkedIn.

Os resultados contêm nome, sobrenome, cargo (título), localização e o link do perfil do usuário. Apenas 2 chamadas à API são necessárias para recuperar todos os funcionários se a empresa não tiver mais de 10 funcionários. Caso contrário, precisamos paginar pelos resultados da API. Com a flag de CLI --email-format pode-se definir um formato de string Python para gerar automaticamente endereços de e-mail com base no nome e sobrenome recuperados.

✨ Requisitos

O LinkedInDumper se comunica com a API não oficial LinkedIn Voyager, que requer autenticação. Portanto, você deve ter uma conta de usuário válida do LinkedIn. Para simplificar, o LinkedInDumper espera apenas um valor de cookie fornecido por você. Dessa forma, até contas protegidas com 2FA são suportadas. Além disso, você deve fornecer uma URL de empresa do LinkedIn para extrair os funcionários.

Obtendo o Cookie do LinkedIn

1. Faça login em www.linkedin.com e recupere o valor do cookie de sessão li_at, por exemplo, através das ferramentas de desenvolvedor
2. Especifique o valor do cookie de forma persistente na variável li_at do script Python ou temporariamente durante a execução via a flag de CLI --cookie

Obtendo a URL da Empresa no LinkedIn

1. Pesquise a empresa alvo no Google ou diretamente no LinkedIn
2. A URL da empresa no LinkedIn deve ser algo como: https://www.linkedin.com/company/apple

🎓 Uso

usage: linkedindumper.py [-h] --url <linkedin-url> [--cookie <cookie>] [--quiet] [--include-private-profiles] [--include-contact-infos] [--jitter] [--email-format <mail-format>] [--output-json <json-file>] [--output-csv <csv-file>]

options:
  -h, --help            show this help message and exit
  --url <linkedin-url>  A LinkedIn company url - https://www.linkedin.com/company/<company>
  --cookie <cookie>     LinkedIn 'li_at' session cookie
  --include-private-profiles
                        Show private accounts too
  --include-contact-infos
                        Query each employee individually and retrieve contact infos
  --jitter              Add a random jitter to HTTP requests to bypass rate limiting
  --email-format <mail-format>
                        Python string format for emails; for example:
                        --email-format '{0}.{1}@example.com' --> [email protected]
                        --email-format '{0[0]}.{1}@example.com' --> [email protected]
                        --email-format '{1}@example.com' --> [email protected]
                        --email-format '{0}@example.com' --> [email protected]
                        --email-format '{0[0]}{1[0]}@example.com' --> [email protected]
  --output-json <json-file>
                        Store results in json output file
  --output-csv <csv-file>
                        Store results in csv output file                        

🐳 Exemplo 1 - Execução com Docker

docker run --rm l4rm4nd/linkedindumper:latest --url 'https://www.linkedin.com/company/apple' --cookie '<cookie>' --email-format '{0}.{1}@apple.de'

🐍 Exemplo 2 - Python Nativo

# instalar dependências
pip install -r requirements.txt

python3 linkedindumper.py --url 'https://www.linkedin.com/company/apple' --cookie '<cookie>' --email-format '{0}.{1}@apple.de'

💎 Saídas

O script retornará dados dos funcionários como valores separados por ponto e vírgula (como CSV):

 ██▓     ██▓ ███▄    █  ██ ▄█▀▓█████ ▓█████▄  ██▓ ███▄    █ ▓█████▄  █    ██  ███▄ ▄███▓ ██▓███  ▓█████  ██▀███  
▓██▒    ▓██▒ ██ ▀█   █  ██▄█▒ ▓█   ▀ ▒██▀ ██▌▓██▒ ██ ▀█   █ ▒██▀ ██▌ ██  ▓██▒▓██▒▀█▀ ██▒▓██░  ██▒▓█   ▀ ▓██ ▒ ██▒
▒██░    ▒██▒▓██  ▀█ ██▒▓███▄░ ▒███   ░██   █▌▒██▒▓██  ▀█ ██▒░██   █▌▓██  ▒██░▓██    ▓██░▓██░ ██▓▒▒███   ▓██ ░▄█ ▒
▒██░    ░██░▓██▒  ▐▌██▒▓██ █▄ ▒▓█  ▄ ░▓█▄   ▌░██░▓██▒  ▐▌██▒░▓█▄   ▌▓▓█  ░██░▒██    ▒██ ▒██▄█▓▒ ▒▒▓█  ▄ ▒██▀▀█▄  
░██████▒░██░▒██░   ▓██░▒██▒ █▄░▒████▒░▒████▓ ░██░▒██░   ▓██░░▒████▓ ▒▒█████▓ ▒██▒   ░██▒▒██▒ ░  ░░▒████▒░██▓ ▒██▒
░ ▒░▓  ░░▓  ░ ▒░   ▒ ▒ ▒ ▒▒ ▓▒░░ ▒░ ░ ▒▒▓  ▒ ░▓  ░ ▒░   ▒ ▒  ▒▒▓  ▒ ░▒▓▒ ▒ ▒ ░ ▒░   ░  ░▒▓▒░ ░  ░░░ ▒░ ░░ ▒▓ ░▒▓░
░ ░ ▒  ░ ▒ ░░ ░░   ░ ▒░░ ░▒ ▒░ ░ ░  ░ ░ ▒  ▒  ▒ ░░ ░░   ░ ▒░ ░ ▒  ▒ ░░▒░ ░ ░ ░  ░      ░░▒ ░      ░ ░  ░  ░▒ ░ ▒░
  ░ ░    ▒ ░   ░   ░ ░ ░ ░░ ░    ░    ░ ░  ░  ▒ ░   ░   ░ ░  ░ ░  ░  ░░░ ░ ░ ░      ░   ░░          ░     ░░   ░ 
    ░  ░ ░           ░ ░  ░      ░  ░   ░     ░           ░    ░       ░            ░               ░  ░   ░     
                                      ░                      ░                                         ░ por LRVT      

[i] Nome da Empresa: apple
[i] X-ID da Empresa: 162479
[i] Funcionários no LN: 1000 funcionários encontrados
[i] Data da Extração: 17/10/2022 13:55:06
[i] Formato de E-mail: {0}.{1}@apple.de

Nome;Sobrenome;E-mail;Cargo;Gênero;Localização;Perfil
Katrin;Honauer;[email protected];Software Engineer at Apple;N/A;Heidelberg;https://www.linkedin.com/in/katrin-honauer
Raymond;Chen;[email protected];Recruiting at Apple;N/A;Austin, Texas Metropolitan Area;https://www.linkedin.com/in/raytherecruiter

[i] Rastejados com sucesso 2 funcionário(s) único(s) da apple. Hurray ^_-

Opcionalmente, você pode usar os parâmetros de CLI --output-json e --output-csv para armazenar os resultados como JSON ou CSV.

💥 Limitações

O LinkedIn permitirá apenas os primeiros 1.000 resultados de pesquisa ao coletar informações de contato. Você também pode precisar de uma conta premium do LinkedIn quando atingir o número máximo de consultas permitidas para visitar perfis com sua conta gratuita.