{"id":19601295,"url":"https://github.com/kennbroorg/poorskeme","last_synced_at":"2026-03-27T04:51:12.277Z","repository":{"id":123991887,"uuid":"490272735","full_name":"kennbroorg/poorskeme","owner":"kennbroorg","description":"OSINT - Data Visualization - Blockchain - Awareness - Scam","archived":false,"fork":false,"pushed_at":"2023-11-25T23:14:32.000Z","size":9557,"stargazers_count":41,"open_issues_count":1,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T01:32:24.542Z","etag":null,"topics":["data-analysis","data-visualization","python","scam","smart-contracts","visualization"],"latest_commit_sha":null,"homepage":"https://kennbroorg.gitlab.io/poorskeme-page/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kennbroorg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-05-09T12:26:49.000Z","updated_at":"2025-02-24T10:36:41.000Z","dependencies_parsed_at":"2023-11-25T22:25:37.725Z","dependency_job_id":"8f39c151-75ba-4eb6-9650-7c61259698d6","html_url":"https://github.com/kennbroorg/poorskeme","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kennbroorg%2Fpoorskeme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kennbroorg%2Fpoorskeme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kennbroorg%2Fpoorskeme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kennbroorg%2Fpoorskeme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kennbroorg","download_url":"https://codeload.github.com/kennbroorg/poorskeme/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251171754,"owners_count":21547155,"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":["data-analysis","data-visualization","python","scam","smart-contracts","visualization"],"created_at":"2024-11-11T09:17:56.965Z","updated_at":"2026-03-27T04:51:07.234Z","avatar_url":"https://github.com/kennbroorg.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\" style=\"margin-bottom: 10px;\"\u003e\n    \u003ca href=\"https://twitter.com/intent/follow?screen_name=kennbroorg\"\u003e\n\t\u003cimg alt=\"follow on Twitter\" src=\"https://img.shields.io/twitter/follow/kennbroorg.svg?label=follow%20\u0026style=for-the-badge\u0026logo=twitter\u0026labelColor=abcdef\u0026color=1da1f2\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg alt=\"Logo\" src=\"https://kennbroorg.gitlab.io/poorskeme-page/img/poorSKeme-logo.png\"\u003e\n\u003c/div\u003e\n\n---\n# poorSKeme\n\nOSINT - Data Visualization - Blockchain - Awareness - Scam\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg alt=\"Principal\" src=\"https://kennbroorg.gitlab.io/poorskeme-page/img/principal.png\"\u003e\n\u003c/div\u003e\n\n# Install\nGo to this [site](https://kennbroorg.gitlab.io/poorskeme-page/) and click on the downdload button\nOr go to release section. Download the ZIP file called poorSKeme.zip\n\nUnzip it, install requeriments and execute it.\n\n``` shell\nunzip poorSKeme.zip\ncd poorSKeme\npip install -r requirements.txt\npython3 poorSKeme --help\n```\n```\n$$$$$$$\\                                       $$$$$$\\  $$\\   $$\\\n$$  __$$\\                                     $$  __$$\\ $$ | $$  |\n$$ |  $$ | $$$$$$\\   $$$$$$\\   $$$$$$\\        $$ /  \\__|$$ |$$  / $$$$$$\\  $$$$$$\\$$$$\\   $$$$$$\\\n$$$$$$$  |$$  __$$\\ $$  __$$\\ $$  __$$\\       \\$$$$$$\\  $$$$$  / $$  __$$\\ $$  _$$  _$$\\ $$  __$$\\\n$$  ____/ $$ /  $$ |$$ /  $$ |$$ |  \\__|       \\____$$\\ $$  $$\u003c  $$$$$$$$ |$$ / $$ / $$ |$$$$$$$$ |\n$$ |      $$ |  $$ |$$ |  $$ |$$ |            $$\\   $$ |$$ |\\$$\\ $$   ____|$$ | $$ | $$ |$$   ____|\n$$ |      \\$$$$$$  |\\$$$$$$  |$$ |            \\$$$$$$  |$$ | \\$$\\\\$$$$$$$\\ $$ | $$ | $$ |\\$$$$$$$\\\n\\__|       \\______/  \\______/ \\__|             \\______/ \\__|  \\__|\\_______|\\__| \\__| \\__| \\_______|\n\nusage: poorSKeme.py [-h] [-bc {bsc,eth}] [-ct CONTRACT] [-bf BLOCK_FROM] [-bt BLOCK_TO] [-c CHUNK] [-f FILE] [-w]\n\nContract analyzer\n\noptional arguments:\n  -h, --help            show this help message and exit\n\nGet and process data:\n  -bc {bsc,eth}, --blockchain {bsc,eth}\n                        Select Blockchain (bsc, eth)\n  -ct CONTRACT, --contract CONTRACT\n                        address of contract\n  -bf BLOCK_FROM, --block-from BLOCK_FROM\n                        Block start\n  -bt BLOCK_TO, --block-to BLOCK_TO\n                        Block end\n  -c CHUNK, --chunk CHUNK\n                        Chunks of blocks\n\nProcess data from JSON file:\n  -f FILE, --file FILE  JSON file of recolected data\n\nStart WebServer visualization data:\n  -w, --web             WEB for data visaulization\n\n            Examples\n            --------\n\n            # Extract TRXs of contract from block to block (Ethereum Network)\n            python3 poorSKeme.py -bc eth -ct 0xb547027A4CCD46EC98199Fa88AAEDF5aA981Db26 -bt 6496413        # To collect\n\n            # Extract TRXs of contract from block to block (Binance Smart Chain)\n            python3 poorSKeme.py -bc bsc -ct 0xe878BccA052579C9061566Cec154B783Fc5b9fF1 -bt 15552901       # To collect\n\n            # Data Visualization of processed contract information (Binance Smart Chain)\n            python3 poorSKeme.py -bc bsc -f contract-0xe878BccA052579C9061566Cec154B783Fc5b9fF1.db -w  # To visualice data\n\n```\nIf you use the web param, the port is 4200. The complete url is http://127.0.0.1:4200.\n\n# API\nGet the Free API from https://etherscan.io/apis (Ethereum) and from https://bscscan.com/apis (Binance Smart Chain)\nLoad them in the API.yaml file replacing the XXX by the corresponding APIKey\n\n# Example\n## Getting data\nTo collect data from contract 0xe878BccA052579C9061566Cec154B783Fc5b9fF1 (Ethereum is the blockchain default)\n```\npython3 poorSKeme.py -ct 0xb547027A4CCD46EC98199Fa88AAEDF5aA981Db26\n```\nBut this could take too long, so you can pass by parameter the block from and block to\n```\npython3 poorSKeme.py -bc bsc -ct 0xe878BccA052579C9061566Cec154B783Fc5b9fF1 -bf 14040726 -bt 15552901\n```\nOr just block to\n```\npython3 poorSKeme.py -bc bsc -ct 0xe878BccA052579C9061566Cec154B783Fc5b9fF1 -bt 15552901\n```\nNote the -bc parameter which indicates the blockchain network (Binance Smart Chain in this case)\n\n\nThis will result in a file named contract-bsc-[CONTRACT].json, for our example it will be called contract-bsc-0xe878BccA052579C9061566Cec154B783Fc5b9fF1.json\n\n## Process data and visualization\nAfter obtaining the data file you can process the information and visualize it by executing\n```\npython3 poorSKeme.py -f ./contract-bsc-0xe878BccA052579C9061566Cec154B783Fc5b9fF1.db -w\n```\nThe above command will turn on two services, an internal API on port 5000 and the webi visualization on port 4200. Just open the browser and enter the address http://127.0.0.1:4200\n\n\u003cp float=\"left\" style=\"text-align: center;\"\u003e\n  \u003cimg alt=\"Resume\" src=\"https://kennbroorg.gitlab.io/poorskeme-page/img/resume.png\" style=\"width: 48%; margin: 10px;\"/\u003e\n  \u003cimg alt=\"Detail\" src=\"https://kennbroorg.gitlab.io/poorskeme-page/img/detail.png\" style=\"width: 48%; margin: 10px;\"/\u003e\n  \u003cimg alt=\"Code\" src=\"https://kennbroorg.gitlab.io/poorskeme-page/img/code.png\" style=\"width: 48%; margin: 10px;\"/\u003e\n  \u003cimg alt=\"Diagram\" src=\"https://kennbroorg.gitlab.io/poorskeme-page/img/diagram.png\" style=\"width: 48%; margin: 10px;\"/\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n    \u003cimg alt=\"Distribution\" src=\"https://kennbroorg.gitlab.io/poorskeme-page/img/bkg_poorSKeme.png\"/\u003e\n\u003c/div\u003e\n\n# Disclaimer\nThis is a young project, started in mid-March 2022, so it may contain errors.\nOver time, and with feedback, the project will grow and bugs will be fixed, but it is a personal project and the time dedicated to it is undetermined.\n\n# Disclaimer\nThis is a young project, started in mid-March 2022, so it may contain errors.\nOver time, and with feedback, the project will grow and bugs will be fixed, but it is a personal project and the time dedicated to it is undetermined.\n\n# Disclaimer\nThis is a young project, started in mid-March 2022, so it may contain errors.\nOver time, and with feedback, the project will grow and bugs will be fixed, but it is a personal project and the time dedicated to it is undetermined.\n\n\u003e I posted the disclaimer three times, maybe you will read it even once\n\n# Simple Roadmap\n- [X] Binance Blockchain support\n- [X] Ethereum Blockchain support\n- [X] Data collect\n- [X] Visualization\n- [X] Early detection of scams\n- [X] Automatic anomaly detection\n\n...\n\n- [?] Traceability\n- [ ] Wallet identification\n\nThese last two points of the roadmap are subject to a lot of research, but nothing is impossible.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkennbroorg%2Fpoorskeme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkennbroorg%2Fpoorskeme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkennbroorg%2Fpoorskeme/lists"}