/Maryam

Maryam: Open-source Intelligence(OSINT) Framework

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Build Status Version 2.0.5 GPLv3 License Python 3.8.x Codacy Badge CII Best Practices

OWASP Maryam

OWASP Maryam is a modular/optional open source framework based on OSINT and data gathering. Maryam is written in Python programming language and it’s designed to provide a powerful environment to harvest data from open sources and search engines and collect data quickly and thoroughly.

Install

Supported OS

  • Linux
  • FreeBSD
  • OSX

Prerequisites

  • Python 3.8.x or 3.9.x (NOT 3.7, ..)
  • requests module
git clone https://github.com/saeeddhqan/maryam.git
cd maryam
pip install -r requirements
python3 maryam -e help

Tips

# Using dns_search. --max means all of resources. --api shows the results as json.
# .. -t means use multi-threading.
./maryam -e dns_search -d ibm.com -t 5 --max --api --form 
# Using youtube. -q means query
./maryam -e youtube -q "<QUERY>"
./maryam -e google -q "<QUERY>"
./maryam -e dnsbrute -d domain.tld
# Show the framework modules
./maryam -e show modules
# Set framework options. It'll save in the workspace.
./maryam -e set proxy ..
./maryam -e set agent ..
./maryam -e set timeout ..

Updates

Last Updates

  • Error stack and a better performance for dev
  • Update google and yahoo: new format
  • Add API interface
  • Combine 'waf' to 'wapps'
  • Add 'update' command to update modules
  • Remove 'record', 'spool', and 'use'

Contribution

Contributes are welcome! Here is a start guide: Development Guide You can add a new search engine to the util classes or use current search engines to write a new module. The best help to write a new module is by checking the current modules.

Roadmap

  • Write a complete metacrawler engine based on OSINT by using the current search engines
  • Add new sources for dns_search module
  • Web User Interface

links

To report bugs, requests, or any other issues please create an issue.