{"id":13800130,"url":"https://github.com/carlospolop/MalwareWorld","last_synced_at":"2025-05-13T09:31:08.697Z","repository":{"id":60019949,"uuid":"130572881","full_name":"carlospolop/MalwareWorld","owner":"carlospolop","description":"System based on +500 blacklists and 5 external intelligences to detect internet potencially malicious hosts","archived":false,"fork":false,"pushed_at":"2022-06-19T23:06:28.000Z","size":1760,"stargazers_count":150,"open_issues_count":3,"forks_count":46,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-05-12T13:49:53.737Z","etag":null,"topics":["blacklists","malware-detection","malwareworld","proxies","spam-detection","tor"],"latest_commit_sha":null,"homepage":"https://malwareworld.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/carlospolop.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-04-22T14:02:06.000Z","updated_at":"2025-04-29T12:57:03.000Z","dependencies_parsed_at":"2022-09-25T15:30:22.135Z","dependency_job_id":null,"html_url":"https://github.com/carlospolop/MalwareWorld","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carlospolop%2FMalwareWorld","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carlospolop%2FMalwareWorld/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carlospolop%2FMalwareWorld/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carlospolop%2FMalwareWorld/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/carlospolop","download_url":"https://codeload.github.com/carlospolop/MalwareWorld/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253913028,"owners_count":21983245,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blacklists","malware-detection","malwareworld","proxies","spam-detection","tor"],"created_at":"2024-08-04T00:01:09.602Z","updated_at":"2025-05-13T09:31:07.589Z","avatar_url":"https://github.com/carlospolop.png","language":"JavaScript","funding_links":[],"categories":["Malware"],"sub_categories":["Dependencies"],"readme":"![](https://github.com/carlospolop/MalwareWorld/blob/master/images/big_logo.png)\n\nA system based on +500 blacklists and 5 external intelligences to detect potentially malicious hosts on the internet.\n\n\n## Description\n\nThe tool parses more than 500 public blacklists around the internet in order to identify potencially malicious devices.\n\nAmong the final blacklist created merging all the others you can find ips, domains and urls that potencially:\n-   Are infected with malware\n-   Attack other hosts\n-   Send spam\n-   Contains phishing sites\n-   Are bitcoin nodes\n-   Are Tor exit nodes or web-to-tor hosts\n-   Are public proxies\n-   Have bad reputation\n-   Are related to adware\n-   **Whitelisted domains (a whitelisted domain will also appeard so you can easily find false possitives. Please, always check if a domain has been categorized as \"Whitelist\")**\n\nAll blacklists used to create a single and huge blacklist can be seen [here](https://malwareworld.com/textlists/blacklists.txt).\n\nWhen you `require` the blacklist it will start accessing and loading all the blacklists. This process could take from 5 to 10 minutes.\nThe \"database\" will be a javascript huge dictionary in memmory. Each component will be and IP or Domain or IPRange potencially malicios that will have as atributes:\n+ A title\n+ An array of types (reason/s why this host is potencially malicious)\n+ An array of urls (that points to the malicios part of the host)\n+ Location (only filled if it is an IP) \n+ The references that have pointed to this host.\n\nBesides, the API of 5 external intelligences are used to check single IPs or domains not only against the huge database of hosts blacklisted but also against the intelligences. If the ip or domain has something suspicious it will be discovered.\n\n```javascript\nmalicious_comp = \"IP/DOMAIN/RANGE\": { \n                    title: \"\",\n                    type: [],\n                    urls: [],\n                    location : {lat: \"\", lng: \"\"},\n                    references: []\n}\n```\n\n## Whitelisting\n\n**It has been added some whitelisting so very used and common domains are whitelisted. Please, before deciding that a domain is malicious, check if it has been categorized as \"Whitelist\".**\n\n## Visual representation of a portion of the final database \n\nPlease visit [MalwareWorld](https://malwareworld.com) to access to the main page of **MalwareWolrd** where you can check if a domain or IP is suspicious.\n\nYou can found some maps where some malicious IPs detected are represented (It is recommended to use Chrome):\n\n+ [Hosts with bad reputation](https://malwareworld.com/badreputation)\n+ [Hosts related to Malware](https://malwareworld.com/malware)\n+ [Hosts known to be attacking through internet](https://malwareworld.com/attackers)\n+ [Hosts sending spamm](https://malwareworld.com/spammers)\n+ [Hosts related to cryptocurrencies](https://malwareworld.com/cryptocurrencies)\n+ [Public proxies, tor exit nodex and tor-to-web hosts](https://malwareworld.com/hidesource)\n\n![](https://github.com/carlospolop/MalwareWorld/blob/master/images/map.png)\n\n## Requisites\n\n**At least 4Gb of RAM are needed to run this project, 8Gb is recommended**\n\n\n## External Intelligences Used\n\nBy default, when you check if an IP, Domain or Url is malicious it will be checked agaist the database created merging all the blacklists and against the activated extrnal inteligences. The external intelligences are:\n+ [Fraudguard](https://fraudguard.io)\n+ [Fortiguard](https://fortiguard.com)\n+ [ProjectHoneypot](https://www.projecthoneypot.org)\n+ [Spamcop](http://spamcop.net)\n+ [Web Of Trust](https://www.mywot.com)\n+ [OTX Alientvault](https://otx.alienvault.com/)\n\nBy default, only the intelligences that don't require credentials to be used are activated. These are: **Fortiguard** and **Spamcop**.\n\nIf you want to deactivate Fortiguard or Spamcop, use:\n\n`mw.deactivateFortiguard()`\n\n`mw.deactivateSpamcop()`\n\nIn order to activate the other intelligences you have to set the credentials:\n\nActivate **Fraudguard**:\n\n`mw.setFraudguardUser(\"\u003cYOUR USERNAME\u003e\");`\n\n`mw.setFraudguardPass(\"\u003cYOUR PASSWORD\u003e\");`\n\nActivate **ProjecHoneypot**:\n\n`mw.setProjecthoneypotKey(\"\u003cYOUR API KEY\u003e\");`\n\nActivate **WOT**:\n\n`mw.setWOTKey(\"\u003cYOUR WOT API KEY\u003e\")`\n\nActivate **OTX Alientvault**:\n\n`mw.setOTXAlientvaultKey(\"\u003cYOUR WOT API KEY\u003e\")`\n\n## Huge Blacklists\n\nIf you only want the huge blacklist that **MalwareWorld** creates you can access to:\n\n+ [List of Suspicious IPs](https://malwareworld.com/textlists/suspiciousIPs.txt)\n+ [List of Suspicious Domains](https://malwareworld.com/textlists/suspiciousDomains.txt)\n+ [All the information about Suspicious IPs](https://malwareworld.com/textlists/ips.txt)\n+ [All the information about Suspicious Domains](https://malwareworld.com/textlists/domains.txt)\n\n## Installation\n\n`npm install malwareworld`\n\n\n## How to use\n\nThe library has been made to be as simple as possible to use.\nOnce the library has had time to load all the blacklists:\n\n`const mw = require('malwareworld')`\n\n### Check if Malicious\n\nYou can check if an IP, Domain or URL is malicious just calling:\n`mw.isMalicious(\u003cINPUT\u003e)`\n\n```javascript\n\u003e mw.isMalicious(\"70.32.94.216\").then(function(result){ \n        console.log(result);\n    }, function(err) {\n        console.log(err);\n});\n\n// Result:\n{ malicious: true,\n  '70.32.94.216':\n   { title: 'honeypot_tracker/Malicious Host/Spammer',\n     type: [ 'Bad Reputation', 'Spammer' ],\n     urls: [],\n     location: { lat: 34.0202, lng: -118.3928 },\n     references:\n      [ 'https://fraudguard.io/',\n        'https://fortiguard.com/search?q=70.32.94.216\u0026engine=8',\n        'https://www.spamcop.net/w3m?action=checkblock\u0026ip=70.32.94.216' ] \n   }\n}\n```\n\nBy default this method will check the INPUT against the database created using all the blacklists and against the activated external intelligeces.\n\nIf you **don't want to create the database** using the blacklists you can do:\n\n`mw.deactivateBlacklists()`\n\nYou can **get all the potencially malicious domains** of the database with their descriptions calling:\n\n`mw.getMalDomainsList()`\n\nYou can **get all the potencially malicious IPs** of the database with their descriptions calling:\n\n`mw.getMalIpsList()`\n\nYou can **get all the potencially malicious IP Ranges** of the database with their descriptions calling:\n\n`mw.getMalRangesList()`\n\nYou can **get all the hosts of type** of the database with their descriptions calling:\n\n`mw.getMalHostsOf(TYPE)`\n\n```javascript\nTypes: BadReputation, Malware, KnownAttacker, Spammer, Phishing, CryptoCurrencies, Hidesource, Adware, DGA\n```\n\nYou can **get all the blacklist that does not respond** calling:\n\n`mw.getNotRespondingLists()`\n\n### Statistics\n\nYou can get **general statistics** of the status of the database and the blacklists by calling:\n```javascript\n\u003e mw.getGeneralStatistics()\n{ num_ips: 165117,                    // Number of unique malicious IPs found\n  num_domains: 118664,                // Number of unique malicious Domains found\n  num_ranges: 46089,                  // Number of unique malicious IP Ranges found\n  num_blacklists: 522,                // Number of blacklists used\n  num_notResponding_blacklists: 0,    // Number of blacklists not loaded\n  total_unique: 329870,               // Number of unique malicious hosts\n  repeated: 116451,                   // Number of repetitions found between balcklists\n  external_sources:                   // Check if the external sources are being used or not\n   { fraudguard: false,\n     fortiguard: true,\n     projecthoneypot: false,\n     simplespamcop: true,\n     wot: false } \n}\n```\n\nYou can access how much potencially malicious hosts were contained in each blacklist used and the sha1 of the response body by calling:\n\n`mw.getStatistics()`\n\n### Renew data\n\nYou can **reload all the blacklists** calling:\n\n`mw.renewAllData()`\n\nYou can **reload all the not responding blacklists** calling:\n\n`mw.renewNotRespondingData()`\n\nYou can **set an interval to reload every blacklists** calling:\n\n`mw.renewtAllDataInterval(MINUTES)`\n\nYou can set an interval to **reload every not responding blacklists** calling:\n\n`mw.renewNotRespondingDataInterval(MINUTES)`\n\n### Port\n\nYou can set the `isMalicious()` function to listen in a port calling:\n`mw.listenInPort(PORT)`\n\n### Example\n\n```javascript\nconst mw = require('malwareworld');\n\nmw.setFraudguardUser(\"\u003cYOUR USERNAME\u003e\");\nmw.setFraudguardPass(\"\u003cYOUR PASSWORD\u003e\");\nmw.setProjecthoneypotKey(\"\u003cYOUR API KEY\u003e\");\nmw.setWOTKey(\"\u003cYOUR API KEY\u003e\");\nmw.setOTXAlientvaultKey(\"\u003cYOUR WOT API KEY\u003e\");\n\nvar day = 24**60;\nvar hour1   = 1**60;\n\nmw.renewtAllDataInterval(day);      \t  // Reload the blacklists every day\nmw.renewNotRespondingData(hour1);       // Try to load the not responding blacklists every hour\n\nmw.listenInPort(9999);                  // Expose the isMalicious() funtion in port 9999  \n\nmw.isMalicious(\"malwareworld.com\").then(function(result){  // Check if the domain malwareworld.com is malicious (No, it isn't)\n        console.log(result);\n    }, function(err) {\n        console.log(err);\n});\n\n```\n\n\n## TODO\n-   Integrate more blacklists and external intelligences.\n-   If you know about blacklists or external intelligences that are not used, please contact me.\n\n\n![](https://github.com/carlospolop/MalwareWorld/blob/master/images/logo.png)\n\n\n\n## License\n\nThe MIT License (MIT)\n\nCopyright (c) 2018 Carlos Polop\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nPLEASE, NOTICE THAT IF YOU ARE PLANNING TO USE THE DATABASE CREATED BY THIS SOFTWARE\nWITH COMMERCIAL PURPOSES YOU SHOULD CHECK THE LICENSE ASSOCIATE WITH EACH BLACKLIST\nTHAT THIS SOFTWARE USES.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlospolop%2FMalwareWorld","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarlospolop%2FMalwareWorld","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlospolop%2FMalwareWorld/lists"}