/Maryam

Maryam: Open-source Intelligence(OSINT) Framework

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Build Status Version 2.2.6 GPLv3 License Python 3.8.x CII Best Practices

OWASP Maryam

OWASP Maryam is a modular open-source framework based on OSINT and data gathering. It is designed to provide a robust environment to harvest data from open sources and search engines quickly and thoroughly.

Installation

Supported OS

  • Linux
  • FreeBSD
  • OSX
$ pip install maryam

Usage

# 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 ..
# Run web API
maryam -e web api 127.0.0.1 1313

Updates

Last Updates

  • clustering, meta search engine, dark web search
  • Iris: the first beta version
  • Add famous_person
  • Speed up the core
  • Add setup.py and change arch
  • Web API: web command

Contribution

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

Roadmap

  • Write a complete metacrawler engine based on OSINT by using the current search engines
  • Add clustering algorithms: Done
  • Web User Interface

Links

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