# Dark Feed Parser
This is a simples parser for all great data available with the API key of [Dark Feed](https://darkfeed.io/).
The idea is create functions to return data available in the interface and bring more insights, like:
- Top 10 countries this year
- Top 5 sectors in Brazil
- Top 3 ransomwares in latam
- Count of victims in America of the North in the last month
- Filters in a time range
- . . .
## How install it
```bash
pip install darkfeed
```
## How use the command line
If you don't know how run it you can use the argument `-h`, like this:
```bash
darkfeed -h
usage: darkfeed [-h] [-i] [-d] [-a AFTER] [-b BEFORE] [-c COUNTRIES] [-lc] [-s SECTORS] [-ls] [-r RANSOMWARES] [-lr] [-v VICTIM] [-top_c TOP_COUNTRIES] [-top_s TOP_SECTORS]
[-top_r TOP_RANSOMWARES] [-json] [-count] [-xlsx] [-n] [-nr] [-g]
Ransomware statistics - Kudos DarkFeed (darkfeed.io).
options:
-h, --help show this help message and exit
-i, --init First step. Pass your API key.
-d, --download_base To save/update base to a file
-a AFTER, --after AFTER
Date started to collecting published victims. Format: YYYY-MM-DD
-b BEFORE, --before BEFORE
Date finished to collecting published victims. Format: YYYY-MM-DD
-c COUNTRIES, --country COUNTRIES
Country filer, write how many countries do you want split by [,]. You could also use: latam, south_america, central_america, north_america, europe, asia, africa or
oceania
-lc, --list_countries
List all possible strings for countries
-s SECTORS, --sectors SECTORS
Sector filter, choose the sectors of your interest. You can choose more than one split then with [,]
-ls, --list_sectors List all possible sectors.
-r RANSOMWARES, --ransomwares RANSOMWARES
Ransomware filter, choose the ransomware group of your interest. You can choose more than one split then with [,]
-lr, --list_ransomwares
List all ransowmare groups in our base
-v VICTIM, --victim VICTIM
Use the name or substring to search a victm.
-top_c TOP_COUNTRIES, --top_countries TOP_COUNTRIES
Get the global top X countries.
-top_s TOP_SECTORS, --top_sectors TOP_SECTORS
Get the global top X sectors.
-top_r TOP_RANSOMWARES, --top_ransomwares TOP_RANSOMWARES
Get the global top X ransomwares.
-json To format your output to json
-count To count the num of items
-xlsx To convert data to spreadsheet / xlsx
-n, --news Cyber news!
-nr, --new_ransomwares
Return ransomware families based in first detection in DarkFeed database. You can use arguments of date to filter the returned ransomwares. The default is last
month. Reliability is from 2024
-g, --start_gui Init a web service.
```
You can mix commands to receive different outputs, like xlsx or json. The last argument will define the output.
||
|:---:|
|CLI|
# How to use the GUI
```bash
darkfeed -g
```
||
|:-----:|
|GUI|
Raw data
{
"_id": null,
"home_page": "https://github.com/santiag02/DarkFeed",
"name": "darkfeed",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "ransomware, victims, darkfeed, dark feed",
"author": "Camila Santiago",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/05/f2/d1a53e357ca5f32e642ff15cd7a4e19ecc787718da7273c38515159a741e/darkfeed-1.5.tar.gz",
"platform": null,
"description": "# Dark Feed Parser\n\nThis is a simples parser for all great data available with the API key of [Dark Feed](https://darkfeed.io/).\n\nThe idea is create functions to return data available in the interface and bring more insights, like:\n- Top 10 countries this year\n- Top 5 sectors in Brazil\n- Top 3 ransomwares in latam\n- Count of victims in America of the North in the last month\n- Filters in a time range\n- . . . \n\n## How install it\n\n```bash\npip install darkfeed\n```\n\n## How use the command line \n\nIf you don't know how run it you can use the argument `-h`, like this:\n\n```bash\ndarkfeed -h\nusage: darkfeed [-h] [-i] [-d] [-a AFTER] [-b BEFORE] [-c COUNTRIES] [-lc] [-s SECTORS] [-ls] [-r RANSOMWARES] [-lr] [-v VICTIM] [-top_c TOP_COUNTRIES] [-top_s TOP_SECTORS]\n [-top_r TOP_RANSOMWARES] [-json] [-count] [-xlsx] [-n] [-nr] [-g]\n\nRansomware statistics - Kudos DarkFeed (darkfeed.io).\n\noptions:\n -h, --help show this help message and exit\n -i, --init First step. Pass your API key.\n -d, --download_base To save/update base to a file\n -a AFTER, --after AFTER\n Date started to collecting published victims. Format: YYYY-MM-DD\n -b BEFORE, --before BEFORE\n Date finished to collecting published victims. Format: YYYY-MM-DD\n -c COUNTRIES, --country COUNTRIES\n Country filer, write how many countries do you want split by [,]. You could also use: latam, south_america, central_america, north_america, europe, asia, africa or\n oceania\n -lc, --list_countries\n List all possible strings for countries\n -s SECTORS, --sectors SECTORS\n Sector filter, choose the sectors of your interest. You can choose more than one split then with [,]\n -ls, --list_sectors List all possible sectors.\n -r RANSOMWARES, --ransomwares RANSOMWARES\n Ransomware filter, choose the ransomware group of your interest. You can choose more than one split then with [,]\n -lr, --list_ransomwares\n List all ransowmare groups in our base\n -v VICTIM, --victim VICTIM\n Use the name or substring to search a victm.\n -top_c TOP_COUNTRIES, --top_countries TOP_COUNTRIES\n Get the global top X countries.\n -top_s TOP_SECTORS, --top_sectors TOP_SECTORS\n Get the global top X sectors.\n -top_r TOP_RANSOMWARES, --top_ransomwares TOP_RANSOMWARES\n Get the global top X ransomwares.\n -json To format your output to json\n -count To count the num of items\n -xlsx To convert data to spreadsheet / xlsx\n -n, --news Cyber news!\n -nr, --new_ransomwares\n Return ransomware families based in first detection in DarkFeed database. You can use arguments of date to filter the returned ransomwares. The default is last\n month. Reliability is from 2024\n -g, --start_gui Init a web service.\n```\n\nYou can mix commands to receive different outputs, like xlsx or json. The last argument will define the output.\n\n|![CLI](https://github.com/santiag02/DarkFeed/blob/main/media/DarkFeed_CLI.gif \"CLI\")|\n|:---:|\n|CLI|\n\n# How to use the GUI\n\n```bash\ndarkfeed -g\n```\n\n|![GUI](https://github.com/santiag02/DarkFeed/blob/main/media/DarkFeed_GUI.gif \"GUI\")|\n|:-----:|\n|GUI|\n",
"bugtrack_url": null,
"license": null,
"summary": "A CLI and GUI parser for data from Dark Feed",
"version": "1.5",
"project_urls": {
"Homepage": "https://github.com/santiag02/DarkFeed"
},
"split_keywords": [
"ransomware",
" victims",
" darkfeed",
" dark feed"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "275991924d6368ab2d39c5aac2efe08c172f0e7119fc97a290d8f2c55f061474",
"md5": "f9c200a0f2bfb8f16af0b84bb07ed269",
"sha256": "666a416814287f406f71df34059c526b421ffeeaffcd675add06ba7470c9d84c"
},
"downloads": -1,
"filename": "darkfeed-1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f9c200a0f2bfb8f16af0b84bb07ed269",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 760622,
"upload_time": "2024-09-16T18:18:58",
"upload_time_iso_8601": "2024-09-16T18:18:58.595757Z",
"url": "https://files.pythonhosted.org/packages/27/59/91924d6368ab2d39c5aac2efe08c172f0e7119fc97a290d8f2c55f061474/darkfeed-1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "05f2d1a53e357ca5f32e642ff15cd7a4e19ecc787718da7273c38515159a741e",
"md5": "9f79b40e15b68fb1db437f62842ddcc9",
"sha256": "7001daffbd1ea2fd495565fd4a1c9117ab5797e586b9be211c65ec97f3477651"
},
"downloads": -1,
"filename": "darkfeed-1.5.tar.gz",
"has_sig": false,
"md5_digest": "9f79b40e15b68fb1db437f62842ddcc9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 753485,
"upload_time": "2024-09-16T18:19:01",
"upload_time_iso_8601": "2024-09-16T18:19:01.263656Z",
"url": "https://files.pythonhosted.org/packages/05/f2/d1a53e357ca5f32e642ff15cd7a4e19ecc787718da7273c38515159a741e/darkfeed-1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-16 18:19:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "santiag02",
"github_project": "DarkFeed",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "darkfeed"
}
JSON
