https://github.com/eth0izzle/the-endorser

An OSINT tool that allows you to draw out relationships between people on LinkedIn via endorsements/skills.
https://github.com/eth0izzle/the-endorser

linkedin osint python selenium

Last synced: about 17 hours ago
JSON representation

An OSINT tool that allows you to draw out relationships between people on LinkedIn via endorsements/skills.

• Host: GitHub
• URL: https://github.com/eth0izzle/the-endorser
• Owner: eth0izzle
• License: mit
• Created: 2017-11-24T23:58:08.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2021-03-25T21:45:32.000Z (over 3 years ago)
• Last Synced: 2024-08-01T09:25:35.330Z (3 months ago)
• Topics: linkedin, osint, python, selenium
• Language: Python
• Homepage: https://www.darkport.co.uk
• Size: 5.59 MB
• Stars: 318
• Watchers: 21
• Forks: 54
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# The Endorser

An OSINT tool that allows you to draw out relationships between people on LinkedIn via endorsements/skills.

Check out the [example](https://raw.githubusercontent.com/eth0izzle/the-endorser/master/example/output.pdf) ([digraph](#digraph)), which is based on mine and my friends (David Prince) LinkedIn profile. By glancing at the visualisation you can easily see, by the number of "arrows", there is some sort of relationship between us and "Zoë Rose" (in this case we used to work together). If I was carrying out an investigation I would focus my efforts towards her next.

![Example](https://raw.githubusercontent.com/eth0izzle/the-endorser/master/example/example.png)

**Due to the way LinkedIn's privacy settings work this tool works best when your target is within your 3rd degree network or higher. Using a LinkedIn Premium or Recruiter account will allow you to map targets outside of your network.**

## Installation

All you need it Python 3.4+ and do the following:

1. `git clone https://github.com/eth0izzle/the-endorser.git`

2. `sudo pip3 install -r requirements.txt`

3. Install Graphviz from https://www.graphviz.org/download/ or via your package manager, e.g. `apt-get install graphviz` or `brew install graphviz` or `choco install graphiz`

4. Download [ChromeDriver](https://sites.google.com/a/chromium.org/chromedriver/downloads) for your platform (requires Chrome) and place in ./drivers. Alternatively you can use [PhantomJS](http://phantomjs.org/download.html) and launch with the `--driver phantomjs` flag (*note phantomjs is 8x slower*).

5. Setup your LinkedIn credentials in `config.yaml`

6. `python3 the-endorser.py     `

## Usage

    usage: python the-endorser.py https://www.linkedin.com/in/user1 https://www.linkedin.com/in/user2

    Maps out relationships between peoples endorsements on LinkedIn.

    positional arguments:

      profiles              Space separated list of LinkedIn profile URLs to map

    optional arguments:

      -h, --help            show this help message and exit

      --config_file CONFIG_FILE

                            Specify the path of the config.yaml file (default:

                            ./the-endorser/config.yaml)

      --driver DRIVER       Selenium WebDriver to use to parse the webpages:

                            chromedriver, phantomjs (default: chromedriver)

      --output OUTPUT       Output module to visualise the relationships: digraph,

                            stdout (default: digraph)

      --log LOG             Path of log file. None for stdout. (default: None)

      --log-level LOG_LEVEL

                            Logging output level: DEBUG, INFO, WARNING, ERROR.

                            (default: INFO)

### Outputs

The Endorser is "modular" in the sense that it can output and visualise the data in different ways. An output module just needs one method: `def run(profiles)`

Currently there is only one output module (digraph). In the future I plan to add modules for Maltego and Plot.ly - but feel free to [get involved](https://github.com/eth0izzle/the-enforcer/issues)!

#### Digraph

It's best to read the graph from right-to-left, identifying people that have a large collection of "arrows" from multiple profiles (different colours). Square box = skill, ellipse = person.

## Contributing

Check out the [issue tracker](https://github.com/eth0izzle/the-enforcer/issues) and see what tickles your fancy.

1. Fork it, baby!

2. Create a feature branch: `git checkout -b my-new-feature`

3. Create your super-awesome feature!

4. Commit your changes: `git commit -am 'Add some feature'`

5. Push to the branch: `git push origin my-new-feature`

6. Submit a [pull request](https://github.com/eth0izzle/the-endorser/pulls)

## License

MIT. See LICENSE