https://github.com/animeshshaw/python-malshare
Complete implementation of the Malshare API and a toolkit to interact with it
https://github.com/animeshshaw/python-malshare
malshare malshare-api malware malware-research malware-samples malwareanalysis virustotal
Last synced: about 1 month ago
JSON representation
Complete implementation of the Malshare API and a toolkit to interact with it
- Host: GitHub
- URL: https://github.com/animeshshaw/python-malshare
- Owner: AnimeshShaw
- License: mit
- Created: 2018-04-17T03:37:54.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2018-08-09T07:27:09.000Z (almost 7 years ago)
- Last Synced: 2025-03-25T09:03:08.062Z (about 2 months ago)
- Topics: malshare, malshare-api, malware, malware-research, malware-samples, malwareanalysis, virustotal
- Language: Python
- Size: 8.79 KB
- Stars: 7
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# python-malshare
Complete implementation of the [Malshare API](https://malshare.com/doc.php) and a toolkit to interact with it.
## Malshare Kit - Help Options
```text
C:\Users\Psycho_Coder\Documents\GitHub\python-malshare>python malsharekit.py --help
_ _ _ _
/\/\ __ _| |___| |__ __ _ _ __ ___ /\ /(_) |_
/ \ / _` | / __| '_ \ / _` | '__/ _ \ / //_/ | __|
/ /\/\ \ (_| | \__ \ | | | (_| | | | __/ / __ \| | |_
\/ \/\__,_|_|___/_| |_|\__,_|_| \___| \/ \/|_|\__|
CLI interface to interact with Malshare API
Developed By: Animesh Shaw
Email: [email protected]
Twitter: @Psycho__Coder
usage: main.py [-h] -k APIKEY [-l DIR] [--save] [-gl] [-gtl TYPELIST] [-gtl24]
[-gs] [-d DOWNLOAD] [-i DETAILS] [-u UPLOAD] [-s SEARCH] [-al]
Complete implementation of the Malshare API and a toolkit to interact with it
optional arguments:
-h, --help show this help message and exit
-k APIKEY, --apikey APIKEY
Malshare API Key.
-l DIR, --dir DIR Directory location to save the samples data as json.
By default, stored in the current directory.
--save, --save Save the results in a file in the current directory.
-gl, --latest List hashes from the past 24 hours
-gtl TYPELIST, --typelist TYPELIST
List MD5/SHA1/SHA256 hashes of a specific type from
the past 24 hours. Sample File Types: C, XML, PHP,
HTML, ASCII, PE-32, PE32, ISO-8859, UTF-8, MSVC,
Composite, data, 80386, current, BSD, Zip, 7-zip
-gtl24, --typelist24 Get list of file types & count from the past 24 hours
-gs, --sources List of sample sources from the past 24 hours
-d DOWNLOAD, --download DOWNLOAD
Provide the malware hash to download the sample.
-i DETAILS, --details DETAILS
Provide the malware hash to get the stored file
details.
-u UPLOAD, --upload UPLOAD
Upload a Malware Sample to Malshare. Provide the file
location.
-s SEARCH, --search SEARCH
Search Malshare for different Malware
Samples/Signatures.
-al, --apilimit GET allocated number of API key requests per day and
remaining
```
## Sample Usage
__1. Get List hashes from the past 24 hours__
```text
python malsharekit.py --apikey -gl
```
The Above will print the data to the console. Use `--save` to store them in the current directory or `--dir` to
save the data in a custom location (must be directory).
```text
python malsharekit.py --apikey --save -gl
```
or
```text
python malsharekit.py --apikey --dir /home/myuser/data -gl
```
__2. Downloading a Sample from Malshare__
```text
python malsharekit.py --apikey --save -d d25ca94d2e43d0b8addca830297e169f
```
## Contact
_Email:_ coder[at]animeshshaw[dot]com
_Twitter:_ https://twitter.com/Psycho__Coder
## License
This software is under [MIT License](https://en.wikipedia.org/wiki/MIT_License)