Project Arjuna is an OSINT (Open Source Intelligence) toolkit designed to help users gather and manage public information from diverse sources, all in one place.
- Profile Management:
- Generate random user profiles (with customizable gender) using external APIs.
- Save generated or manually entered profiles to a local database.
- View a list of all saved profiles.
- Search and Lookups:
- Perform Google searches and fetch summarized results.
- Retrieve WHOIS and registration information about domains.
- Validate phone numbers and obtain country, location, and timezone data.
- Lookup IP address details including organization, city, region, and country.
- Frontend:
- Built with React, leveraging functional components and hooks.
- Communicates with the backend via RESTful API calls.
- Provides forms and lists for inputting and displaying OSINT data.
- Backend:
- Node.js with Express for the HTTP server.
- Uses SQLite for local storage of profiles (via a
dbmodule). - Integrates with third-party APIs for Google Search, WHOIS/domain info, phone validation, and IP lookups.
- Exposes routes for:
/api/google— Google Custom Search results/api/profile/random— Get a random user profile/api/profile— Save a profile/api/profiles— List saved profiles/api/domain— WHOIS/domain lookup/api/phone— Phone validation/api/ip— IP address lookup
This project relies on external APIs. Set the following environment variables in a .env file in the backend directory:
GOOGLE_API_KEY— Google Custom Search API keyGOOGLE_CSE_ID— Google Custom Search Engine IDAPI_NINJAS_KEY— API Ninjas key for domain and phone lookups- (Optional)
PORT— Port for the backend server (defaults to 5000)
- Clone the repository
- Install dependencies
cd backend && npm installcd ../frontend && npm install
- Configure environment variables
- Create
.envinbackend/with the required API keys.
- Create
- Run the backend
cd backend && node server.js
- Run the frontend
cd frontend && npm start
Note: This tool is for educational and research purposes only. Always comply with laws and terms of service when using OSINT resources.
