💬 Descrizione

LinkedInDumper è uno script Python 3 che estrae i dati dei dipendenti dalla piattaforma social LinkedIn.

I risultati includono nome, cognome, posizione (titolo), località e il link al profilo di un utente. Sono necessarie solo 2 chiamate API per recuperare tutti i dipendenti se l'azienda non ha più di 10 dipendenti. Altrimenti, è necessario paginare attraverso i risultati API. Con il flag CLI --email-format è possibile definire un formato stringa Python per generare automaticamente gli indirizzi email basati su nome e cognome recuperati.

✨ Requisiti

LinkedInDumper comunica con l'API non ufficiale LinkedIn Voyager, che richiede l'autenticazione. Pertanto, devi disporre di un account utente LinkedIn valido. Per semplicità, LinkedInDumper accetta solo un valore cookie fornito da te. In questo modo, sono supportati anche account protetti da 2FA. Inoltre, devi fornire un URL aziendale LinkedIn da cui estrarre i dipendenti.

Recupero del cookie LinkedIn

1. Accedi a www.linkedin.com e recupera il valore del cookie di sessione li_at, ad esempio tramite gli strumenti di sviluppo del browser
2. Specifica il valore del cookie in modo persistente nella variabile li_at dello script Python o temporaneamente durante l'esecuzione tramite il flag CLI --cookie

Recupero dell'URL aziendale LinkedIn

1. Cerca l'azienda target su Google Search o direttamente su LinkedIn
2. L'URL aziendale LinkedIn dovrebbe essere simile a questo: https://www.linkedin.com/company/apple

🎓 Utilizzo

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                        

🐳 Esempio 1 - Esecuzione con Docker

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

🐍 Esempio 2 - Python nativo

# install dependencies
pip install -r requirements.txt

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

💎 Output

Lo script restituirà i dati dei dipendenti come valori separati da punto e virgola (tipo CSV):

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

[i] Company Name: apple
[i] Company X-ID: 162479
[i] LN Employees: 1000 employees found
[i] Dumping Date: 17/10/2022 13:55:06
[i] Email Format: {0}.{1}@apple.de

Firstname;Lastname;Email;Position;Gender;Location;Profile
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] Successfully crawled 2 unique apple employee(s). Hurray ^_-

Opzionalmente, puoi utilizzare i parametri CLI --output-json e --output-csv per salvare i risultati in formato JSON o CSV.

💥 Limitazioni

LinkedIn permetterà di ottenere solo i primi 1.000 risultati di ricerca durante la raccolta delle informazioni di contatto. Potresti anche aver bisogno di un account LinkedIn premium quando raggiungi il numero massimo consentito di query per visitare i profili con il tuo account freemium LinkedIn.