[](https://app.travis-ci.com/github/saeeddhqan/Maryam)
[](https://bestpractices.coreinfrastructure.org/projects/4577)
# 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
- Darwin
- OSX
```bash
$ pip install maryam
```
Alternatively, you can install the latest version with the following command (Recommended):
```bash
pip install git+https://github.com/saeeddhqan/maryam.git
```
# Usage
```bash
# 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 framework modules
maryam -e show modules
# Set framework options.
maryam -e set proxy ..
maryam -e set agent ..
maryam -e set timeout ..
# Run web API
maryam -e web api 127.0.0.1 1313
```
# Contribution
Here is a start guide: [Development Guide](https://github.com/saeeddhqan/maryam/wiki/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 language model based search
# Links
### [OWASP](https://owasp.org/www-project-maryam/)
### [Wiki](https://github.com/saeeddhqan/maryam/wiki)
### [Install](https://github.com/saeeddhqan/maryam/wiki#install)
### [Modules Guide](https://github.com/saeeddhqan/maryam/wiki/modules)
### [Development Guide](https://github.com/saeeddhqan/maryam/wiki/Development-Guide)
To report bugs, requests, or any other issues please [create an issue](https://github.com/saeeddhqan/maryam/issues).
Raw data
{
"_id": null,
"home_page": "https://github.com/saeeddhqan/Maryam",
"name": "maryam",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "OWASP, OSINT, search-engine, social-networks, Maryam",
"author": "Saeed Dehqan",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/77/07/4c8c28cdbd1decc13edafdcf92969da409cdfbb07c60eb41920a0502c0f0/maryam-2.5.3.post1.tar.gz",
"platform": null,
"description": "[](https://app.travis-ci.com/github/saeeddhqan/Maryam)\n\n\n\n[](https://bestpractices.coreinfrastructure.org/projects/4577)\n\n# OWASP Maryam\n\nOWASP 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.\n\n# Installation\n\n### Supported OS\n - Linux\n - FreeBSD\n - Darwin\n - OSX\n\n```bash\n$ pip install maryam\n```\nAlternatively, you can install the latest version with the following command (Recommended):\n```bash\npip install git+https://github.com/saeeddhqan/maryam.git\n```\n\n# Usage\n\n```bash\n# Using dns_search. --max means all of resources. --api shows the results as json.\n# .. -t means use multi-threading.\nmaryam -e dns_search -d ibm.com -t 5 --max --api --form \n# Using youtube. -q means query\nmaryam -e youtube -q \"<QUERY>\"\nmaryam -e google -q \"<QUERY>\"\nmaryam -e dnsbrute -d domain.tld\n# Show framework modules\nmaryam -e show modules\n# Set framework options.\nmaryam -e set proxy ..\nmaryam -e set agent ..\nmaryam -e set timeout ..\n# Run web API\nmaryam -e web api 127.0.0.1 1313\n```\n\n# Contribution\n\nHere is a start guide: [Development Guide](https://github.com/saeeddhqan/maryam/wiki/Development-Guide)\nYou can add a new search engine to the util classes or use the current search engines to write a new module.\nThe best help to write a new module is checking the current modules.\n\n# Roadmap\n\n - Write a language model based search\n\n# Links\n### [OWASP](https://owasp.org/www-project-maryam/)\n### [Wiki](https://github.com/saeeddhqan/maryam/wiki)\n### [Install](https://github.com/saeeddhqan/maryam/wiki#install)\n### [Modules Guide](https://github.com/saeeddhqan/maryam/wiki/modules)\n### [Development Guide](https://github.com/saeeddhqan/maryam/wiki/Development-Guide)\n\nTo report bugs, requests, or any other issues please [create an issue](https://github.com/saeeddhqan/maryam/issues).\n",
"bugtrack_url": null,
"license": "GPL-V3",
"summary": "OWASP Maryam is a modular/optional open-source framework based on OSINT and data gathering.",
"version": "2.5.3.post1",
"project_urls": {
"Homepage": "https://github.com/saeeddhqan/Maryam"
},
"split_keywords": [
"owasp",
" osint",
" search-engine",
" social-networks",
" maryam"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "77074c8c28cdbd1decc13edafdcf92969da409cdfbb07c60eb41920a0502c0f0",
"md5": "1f03b1a4e247311d60ce55b713a1d340",
"sha256": "3f3ed9d81f115e791c77791e27d19276c75f7a7f49cc6ce67d4ea456e56be65a"
},
"downloads": -1,
"filename": "maryam-2.5.3.post1.tar.gz",
"has_sig": false,
"md5_digest": "1f03b1a4e247311d60ce55b713a1d340",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 245462,
"upload_time": "2024-06-19T12:27:39",
"upload_time_iso_8601": "2024-06-19T12:27:39.028916Z",
"url": "https://files.pythonhosted.org/packages/77/07/4c8c28cdbd1decc13edafdcf92969da409cdfbb07c60eb41920a0502c0f0/maryam-2.5.3.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-19 12:27:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "saeeddhqan",
"github_project": "Maryam",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"lcname": "maryam"
}
JSON
