osintr helps you build a strong foundation for any OSINT investigation by quickly creating a digital footprint of the target via advanced Google searches, HIBP breach and paste data, OSINT Industries API etc.
The app directly interacts with high-quality APIs (SerpDev, Firecrawl, HIBP, OSINT Industries) at a low cost, bypassing the need for unreliable third-party apps. This ensures you have full control over the code and only need to cover the API costs.
osintr performs two primary tasks:
You provide a Username or Email Address for the -t argument (see below). This is the target of the OSINT investigation. Ensure you create and populate a .env file as described below before running the tool.
Automated tasks include:
- Perform verbatim search, intext, inurl, and intitle search on Google.
- Store search results, including URLs, as JSON and remove duplicates.
- Scrape all URLs and save each page as Markdown file in the
rawdirectory. - Save URLs of unscraped pages (e.g., social media) in a
.txtfile. - Save full page screenshots of each page in the
rawdirectory. - Extract all the links and email addresses from the scraped pages.
- Sort the email addresses and URLs based on relevance and save to
DATA.json. - Check HIBP breaches and pastes for target and save to
DATA.json. - Optionally use the OSINT.Industries if an API key is provided. Save to
DATA.json.
Once data is collected, osintr will automatically analyze the information inside DATA.json for patterns, hidden links and connections between data points.
Automated tasks include:
- Analyze data inside
DATA.jsonfor patterns and insights using OpenAI GPT-4o. - osintr builds a profile or digital footprint of the target based on collected data.
- The gathered data is carefully curated and a summary is provided in .md format.
Running the Data Collection and Data Analysis phases requires API keys inside the .env file.
To use osintr with GPT-4o, you need the following items in your .env file inside the root folder of osintr.
OPENAI_API_KEY=<your_key_here>
SERPER_API_KEY=<your_key_here>
FIRECRAWL_API_KEY=<your_key_here>
HIBP_API_KEY=<your_key_here>
API Keys:
- OpenAI: Get your key here
- SerperDev: Get your key here
- Firecrawl: Get your key here
- HaveIBeenPwned: Get your key here
Optionally, you can collect data from OSINT.Industries via their API. Add the key in .env as OSIND_API_KEY=<your_key_here>. This functionality is triggered at runtime if you have a valid key saved in .env.
- OpenAI: Pay-as-you-go.
- SerperDev: 2,500 free queries, then pay-as-you-go (50k queries for $50).
- Firecrawl: 500 free credits; $19/mo for 3,000 page scrapes.
- HIBP: Pwned1 plan for $3.95/mo, 10 email searches/minute.
- OSINT.Industries (optional): Starting at £19/mo.
Ensure Python >=3.10 is installed.
In Linux, you may need to add /home/<user>/.local/bin to PATH.
sudo apt upgrade python3
sudo apt upgrade python3-pip
git clone https://github.com/0SINTr/0SINTr.git
cd 0SINTr
python -m pip install .osintr [-h] -t TARGET -o OUTPUTTo update this tool to the latest version, follow these steps:
python -m pip install --upgrade osintr- More data sources from quality API providers.
- More phone number and company search avenues.
- Recursive web scraping for deeper analysis.
- Optimizing the code overall.
This tool is designed for passive, non-intrusive OSINT tasks. Any illegal or unethical use of the tool is your responsibility. See LICENSE for more details on rights, permissions, and liability.
For support, questions, or feedback: