philINT 0.1a0

philINT is a library that allows OSINT investigators to retrieve and organize data from an email address or an username.

philINT

philINT is an OSINT tool and a Python 3 library that allows investigators to gather information from an email address or an username, without alerting the target.

The main difference between philINT and already existing solutions is that you are 100% sure that the tool will not gather any information about you - as you have access to all the code and run it yourself.

Features :

• Fully async with sync compatibility
• .gpx files visualisation
• Easy data export

Requirements

• Python 3

Installation

With PyPI :

pip install philINT

With GitHub :

git clone https://github.com/ajuelosemmanuel/philINT.git
cd philINT
python3 setup.py install

And then fill the credentials.conf file with the credentials required for some sources. Not filling it will not break the script.

Usage

usage: philINT [-h] (-e EMAIL | -u USERNAME) [-x]

Script that tries to retrieve information from an email address

options:
  -h, --help            show this help message and exit
  -e EMAIL, --email EMAIL
                        Target email address
  -u USERNAME, --username USERNAME
                        Target username
  -x, --extract
                        Extracts the raw data to a json file

CLI Exemple

philINT.exe -e [e-mail]
Duolingo : found 1 user.
Chess.com : found 1 user.
philINT - by Emmanuel Ajuelos (https://github.com/ajuelosemmanuel)
-------------------------------------
|              Results              |
-------------------------------------
Email address : [e-mail]
         • Spam : False
         • Deliverable : True
         • Disposable : False
Email addresses :
         • [e-mail]
Usernames :
         • examplema1
         • examplemail
Names :
         • Example Mail
Pictures :
         • https://simg-ssl.duolingo.com/avatars/XXXXXXXXXX/XXXXXXXXXX/xxlarge
         • https://images.chesscomfiles.com/uploads/v1/user/XXXXXXXXX.XXXXXXXX.200x200o.XXXXXXXXX.jpeg
Accounts :
         • Duolingo
         • Chess.com

Python Exemple

import philINT.classes

target = "[e-mail]"

email = philINT.classes.Email(target)
email.run_all()
target_person = philINT.classes.Person()
target_person.fill_from_email(email)


email.display()
target_person.display()
target_person.display_raw_data()

Other

Inspired by Palenath's work, especially holehe. Not knowing how to strucuture my project, I used an extremely similar one.

Troubleshooting

The User-Agent might get banned - feel free to tell me about it, and I will change it.

Because of the number of sources, I can't test all of them every day. Please reach out to me if one isn't working - I'll do my best to solve the problem. Also, keep in mind that people can delete their accounts, or simply don't have one sometimes.

False positives

Keep in my, especially when searching usernames, that multiple people can use the same username - and therefore generate false positives.

Wanna contribute ?

Here are a few ways you can help me on this project !

Sponsoring

Using GitHub sponsors, you can help me buy API access to some websites, such as HaveIBeenPwned, in order to create new modules for everyone to use.

Making new modules

Here is a template for a module :

import httpx, configparser
from collections import namedtuple

endpoint_config = configparser.ConfigParser()
endpoint_config.read('philINT/endpoints.conf')

WebsiteData = namedtuple("Website", ["Data1", "Data2", "Data3", "DataETC"])

async def from_email(email):
    headers = {"User-Agent": endpoint_config["BASE"]["USER_AGENT"]}
    json = {}
    async with httpx.AsyncClient() as client:
        response = await client.post(endpoint_config["Website"]["ENDPOINT_EMAIL"], headers = headers, json = json)
    resp = response.json()
    results = WebsiteData(
        Data1 = None,
        Data2 = None,
        Data3 = None,
        DataETC = None
        )
    return results

You need to do the parsing, etc

For web scraping, I use Selenium, and all the code is async compatible - with non-async aliases when possible.

Licence

GNU GPL 3.0

Disclaimer

Use philINT ONLY in personal or criminal investigations, pentesting or open-source projects. I'm not responsible of its use, and the project was made for educational purposes only.

Modules

Source	Domain	Email	Username
Adobe	adobe.com	✓	✗
Chess.com	chess.com	✓	✓
Duolingo	duolingo.com	✓	✓
GitHub	github.com	✓	✓
Gravatar	gravatar.com	✓	✗
Imgur	imgur.com	✓	✗
MeWe	mewe.com	✓	✗
MyAnimeList	myanimelist.net	✗	✓
Twitter	twitter.com	✓	✗
WordPress	wordpress.com	✓	✗