Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/m8sec/CrossLinked
LinkedIn enumeration tool to extract valid employee names from an organization through search engine scraping
https://github.com/m8sec/CrossLinked
enumeration linkedin-scraper osint pentest-scripts pentest-tool python3 username-generator webscraping
Last synced: about 2 months ago
JSON representation
LinkedIn enumeration tool to extract valid employee names from an organization through search engine scraping
- Host: GitHub
- URL: https://github.com/m8sec/CrossLinked
- Owner: m8sec
- License: gpl-3.0
- Created: 2019-05-16T13:36:36.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-05-21T06:28:48.000Z (4 months ago)
- Last Synced: 2024-05-22T06:12:09.767Z (4 months ago)
- Topics: enumeration, linkedin-scraper, osint, pentest-scripts, pentest-tool, python3, username-generator, webscraping
- Language: Python
- Homepage:
- Size: 117 KB
- Stars: 1,162
- Watchers: 29
- Forks: 174
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
CrossLinked
CrossLinked is a LinkedIn enumeration tool that uses search engine scraping to collect valid employee names from an
organization. This technique provides accurate results without the use of API keys, credentials, or accessing
LinkedIn directly!
## Table of Contents
- [Install](#install)
- [Prerequisites](#prerequisites)
+ [Naming Format](#naming-format)
+ [Advanced Formatting](#advanced-formatting)
- [Search](#search)
* [Example Usage](#example-usage)
* [Screenshots](#screenshots)
- [Parse](#parse)
* [Example Usage](#example-usage-1)
* [Screenshots](#screenshots-1)
- [Additional Options](#additional-options)
* [Proxy Rotation](#proxy-rotation)
- [Command-Line Arguments](#command-line-arguments)
- [Contribute](#contribute)
# Install
### PyPi
Install the last stable release from PyPi:
```commandline
pip3 install crosslinked
```
### Poetry
Install and run the latest code using [Poetry](https://python-poetry.org/docs/#installing-with-the-official-installer):
```bash
git clone https://github.com/m8sec/subscraper
cd subscraper
poetry install
poetry run crosslinked -h
```
### Python
Install the most recent code from GitHub:
```bash
git clone https://github.com/m8sec/crosslinked
cd crosslinked
pip3 install .
```
# Prerequisites
CrossLinked assumes the organization's account naming convention has already been identified. This is required for execution and should be added to the CMD args based on your expected output. See the [Naming Format](#naming-format) and [Example Usage](#example-usage) sections below:
### Naming Format
```text
{first.{last} = john.smith
CMP\{first}{l} = CMP\johns
{f}{last}@company.com = [email protected]
```
> 🦖 ***Still Stuck?** Metadata is always a good place to check for hidden information such as account naming convention. see [PyMeta](https://github.com/m8sec/pymeta) for more.*
### Advanced Formatting
:boom: **New Feature** :boom:
To be compatible with alternate naming conventions CrossLinked allows users to control the index position of the name extracted from search text. Should the name not be long enough, or errors encountered with the search string, CrossLinked will revert back to its default format.
***Note**: the search string array starts at `0`. Negative numbers can also be used to count backwards from the last value.*
```
# Default output
python3 crosslinked.py -f '{first}.{last}@company.com' Company
John David Smith = [email protected]
# Use the second-to-last name as "last"
python3 crosslinked.py -f '{0:first}.{-2:last}@company.com' Company
John David Smith = [email protected]
Jane Doe = [email protected]
# Use the second item in the array as "last"
python3 crosslinked.py -f '{first}.{1:last}@company.com' Company
John David Smith = [email protected]
Jane Doe = [email protected]
```
# Search
By default, CrossLinked will use `google` and `bing` search engines to identify employees of the target organization. After execution, two files (`names.txt` & `names.csv`) will appear in the current directory, unless modified in the CMD args.
* *names.txt* - List of unique user accounts in the specified format.
* *names.csv* - Raw search data. See the `Parse` section below for more.
## Example Usage
```bash
python3 crosslinked.py -f '{first}.{last}@domain.com' company_name
```
```bash
python3 crosslinked.py -f 'domain\{f}{last}' -t 15 -j 2 company_name
```
> ⚠️ For best results, use the company name as it appears on LinkedIn `"Target Company"` not the domain name.
## Screenshots
# Parse
*Account naming convention changed after execution and now your hitting CAPTCHA requests? No Problem!*
CrossLinked includes a `names.csv` output file, which stores all scraping data including: `name`, `job title`, and `url`. This can be ingested and parsed to reformat user accounts as needed.
## Example Usage
```
python3 crosslinked.py -f '{f}{last}@domain.com' names.csv
```
## Screenshots
# Additional Options
## Proxy Rotation
The latest version of CrossLinked provides proxy support to rotate source addresses. Users can input a single proxy with `--proxy 127.0.0.1:8080` or use multiple via `--proxy-file proxies.txt`.
```bash
> cat proxies.txt
127.0.0.1:8080
socks4://111.111.111.111
socks5://222.222.222.222
> python3 crosslinked.py --proxy-file proxies.txt -f '{first}.{last}@company.com' -t 10 "Company"
```
> ⚠️ `HTTP/S` proxies can be added by IP:Port notation. However, socks proxies will require a `socks4://` or `socks5://` prefix.*
# Command-Line Arguments
```
positional arguments:
company_name Target company name
optional arguments:
-h, --help show help message and exit
-t TIMEOUT Max timeout per search (Default=15)
-j JITTER Jitter between requests (Default=1)
Search arguments:
--search ENGINE Search Engine (Default='google,bing')
Output arguments:
-f NFORMAT Format names, ex: 'domain\{f}{last}', '{first}.{last}@domain.com'
-o OUTFILE Change name of output file (omit_extension)
Proxy arguments:
--proxy PROXY Proxy requests (IP:Port)
--proxy-file PROXY Load proxies from file for rotation
```
# Contribute
Contribute to the project by:
* Like and share the tool!
* Create an issue to report any problems or, better yet, initiate a PR.
* Reach out with any potential features or improvements [@m8sec](https://twitter.com/m8sec).