|
||
---|---|---|
templates | ||
README.md | ||
osint.py | ||
requirements.txt |
README.md
OSINT Search Tool
The OSINT (Open Source Intelligence) Search Tool is a web application for gathering public information from various platforms, including Twitter, Facebook, Google, and Instagram. The tool allows users to search for profiles and retrieve relevant data in an organized manner.
Features
- Search for usernames across multiple platforms.
- Display user details such as bio, followers, location, and recent posts.
- Concurrent search functionality for faster results.
- Lightweight and easy to set up.
Technologies Used
- Python: Backend development.
- Flask: Web framework.
- BeautifulSoup: HTML parsing and scraping.
- Jinja2: Templating engine.
- HTML/CSS: Frontend design.
- Requests: API requests to fetch data.
Prerequisites
- Python 3.11 or later.
- A virtual environment (optional but recommended).
Installation
-
Clone the Repository:
git clone https://cerus.eu.org/adil/osint.git cd osint
-
Set Up Virtual Environment:
python -m venv venv source venv/bin/activate # For Linux/Mac venv\Scripts\activate # For Windows
-
Install Dependencies:
pip install -r requirements.txt
-
Create Templates Directory: Ensure the
templates/
directory exists, and include the following files:index.html
result.html
Running the Application
-
Activate the virtual environment:
source venv/bin/activate
-
Start the Flask application:
python osint.py
-
Open your web browser and navigate to:
http://127.0.0.1:5000/
File Structure
OSINT/
├── osint.py # Main application file
├── requirements.txt # Project dependencies
├── templates/ # HTML templates
│ ├── index.html # Homepage
│ └── result.html # Results page
├── static/ # Static files (CSS, JS, images)
├── README.md # Project documentation
└── venv/ # Virtual environment
Example Usage
- Enter a username in the search bar.
- Select one or more platforms to search (Twitter, Facebook, Google, Instagram).
- Click
Search
to view the results.
Contributing
Contributions are welcome! To contribute:
- Fork the repository.
- Create a new branch:
git checkout -b feature-name
- Commit your changes:
git commit -m "Add feature description"
- Push to your fork:
git push origin feature-name
- Open a pull request.
License
This project is licensed under the MIT License. See the LICENSE
file for details.
Acknowledgments
Special thanks to the developers of Flask, BeautifulSoup, and Requests for their excellent libraries.