Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/4383/emploo
🕵️♂️ discover and list companies employees based on Linkedin profiles
https://github.com/4383/emploo
osint osint-tool security-audit
Last synced: 3 months ago
JSON representation
🕵️♂️ discover and list companies employees based on Linkedin profiles
- Host: GitHub
- URL: https://github.com/4383/emploo
- Owner: 4383
- License: mit
- Created: 2023-11-24T14:14:17.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-11-30T20:11:23.000Z (about 1 year ago)
- Last Synced: 2024-10-17T19:44:17.925Z (4 months ago)
- Topics: osint, osint-tool, security-audit
- Language: Python
- Homepage:
- Size: 48.8 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Employees Lookup (emploo)
[](https://github.com/4383/emploo/actions/workflows/main.yml)
[](https://pepy.tech/project/emploo)
[](https://pepy.tech/project/emploo/month)
OSINT tool to list employees of a given company. Profiles discovering
based on Linkedin data.
## 📋 Description
During an OSINT audit discovering company's employees can lead security
experts to a valuable source of information. The goal of this tool is to
give you automation to discover this kind of data. The JSON output
can be used in your OSINT toolchain to automatize your reports generation by
being piped with other tools.
This tool, is a command line tool who give you company profiles research
results in JSON format.
This tool is compatible with Windows, Linux and Mac operanting systems.
## ✅ Prerequisites
To run emploo:
- you must own a valid google account.
- install python 3.9 or higher versions
## 💾 Install
```
$ pip install emploo
```
## ⚙️ Init your environment - First run only
Employees Lookup (emploo) is based on the Google Programmable Search Engine
(GPSE). More info about GPSE are available here:
https://developers.google.com/custom-search/docs/tutorial/creatingcse
Firstly, you must create a new empty GPSE by using the
[control panel] (https://programmablesearchengine.google.com/controlpanel/all).
Once the new GPSE is create you should run the command `$ emploo init` and,
by using the GPSE control panel, then, you should import the output of this
previous command as an annotation of your fresly created GPSE.
Now copy the GPSE ID corresponding to your fresly created GPSE. It will be
passed to the emploo commands later.
At this point you should visit https://developers.google.com/custom-search/v1/overview
and click on the "Get a Key" button to obtain your google API key. It will be
passed to the emploo commands later.
Store your credentials to reuse them later during your researches.
## 🚀 Usage
Simply run the following command and obtain your results at the json format:
```
$ emploo search -i -k -o /tmp/example
```
The previous command search for the given company name by using the given
credentials, and output its results into the `/tmp/example` file.
Replace `` by the name of the company that you want to lookup.
Replace `` and `` by your own credentials.
## ⚠️ Warnings
Google API usages are limited to 100 results max. Even if you own a premium
Google account this threshold still apply. In other words, for now, you can't
collect more than 100 profiles with this tools, but 100 profiles is still a
good starting point to ignit your investigations.
Also you should notice that the Google GPSE queries are limited to a quotas
allowed by days. You are not able to proceed researches against an infinite
number of companies each days. You should perform your researches on a daily
basis.
## 😉 Contribute
If you want to contribute to this project
[please first read the contribution guidelines](https://github.com/4383/emploo/blob/main/CONTRIBUTING.md)