{"id":21939297,"url":"https://github.com/tropicoo/zoneh","last_synced_at":"2025-11-01T03:04:39.701Z","repository":{"id":55392063,"uuid":"168422426","full_name":"tropicoo/zoneh","owner":"tropicoo","description":"Zone-H Cybercrime Archive Telegram Monitoring Bot","archived":false,"fork":false,"pushed_at":"2024-07-30T20:49:27.000Z","size":84,"stargazers_count":13,"open_issues_count":2,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-22T14:57:56.980Z","etag":null,"topics":["cybersecurity","infosec","python3","secops","telegram-bot","zone-h"],"latest_commit_sha":null,"homepage":"","language":"Python","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/tropicoo.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-01-30T22:02:45.000Z","updated_at":"2024-09-09T14:18:39.000Z","dependencies_parsed_at":"2024-07-31T00:31:38.115Z","dependency_job_id":"0f896f2b-9dae-4517-9cf6-2ec4a78b03ad","html_url":"https://github.com/tropicoo/zoneh","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tropicoo/zoneh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tropicoo%2Fzoneh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tropicoo%2Fzoneh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tropicoo%2Fzoneh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tropicoo%2Fzoneh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tropicoo","download_url":"https://codeload.github.com/tropicoo/zoneh/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tropicoo%2Fzoneh/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260116647,"owners_count":22961064,"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":["cybersecurity","infosec","python3","secops","telegram-bot","zone-h"],"created_at":"2024-11-29T02:18:28.670Z","updated_at":"2025-11-01T03:04:39.673Z","avatar_url":"https://github.com/tropicoo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zoneh\nZone-H cybercrime archive monitoring telegram bot.\n\n![zoneh](https://github.com/tropicoo/zoneh/blob/master/img/scr.png)\n\n# Disclaimer\nIntended to use only for investigation/research purpose.\n\n# Installation\nMake sure you have Python \u003e= 3.6\n\n`clone` repo and install dependencies using `pip3`.\n\n```\ngit clone https://github.com/tropicoo/zoneh.git\npip3 install -r requirements.txt\n```\n\n# Configuration\nFirst of all you need to [create Telegram Bot](https://core.telegram.org/bots#6-botfather)\n and obtain its token.\n\nBefore starting bot needs to be configured.\nConfiguration is simply stored in **JSON** format.\n\nCopy default configuration file `config-template.json`, which comes with default template,\nto `config.json` and edit:\n```json\n{\n  \"telegram\": {\n    \"token\": \"\",\n    \"allowed_user_ids\": []\n  },\n  \"log_level\": \"DEBUG\",\n  \"zoneh\": {\n    \"archive\": \"special\",\n    \"filters\": {\n      \"countries\": [],\n      \"domains\": [],\n      \"notifiers\": []\n    },\n    \"rescan_period\": 1800,\n    \"random_ua\": true\n  }\n}\n```\n\nTo get things done follow the next steps:\n1. Put the obtained bot token to `token` key as string.\n2. [Find](https://stackoverflow.com/a/32777943) your Telegram user id\nand put it to `allowed_user_ids` list as integer value. Multiple ids can\nbe used, just separate them with a comma.\n3. Choose Zone-H archive type to monitor: `archive`, `special` or `onhold`. \nWrite to the `archive` key.\n4. Write preferred filters to `filters` key:\n    1. `countries`: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)\n    country codes, e.g `[\"FR\", \"BR\"]` for France and Brazil.\n    2. `domains`: ending parts of domains e.g. `[\".go.id\"]`\n    3. `notifiers`: watch for submissions of specific notifiers.\n   \n5. Modify User-Agent headers written in `HEADERS` constant in `zoneh/const.py` if needed.\n\n## Example configuration\n```json\n{\n  \"telegram\": {\n    \"token\": \"3468953:ASOPFagAJCdPEZIVALKYhUFPVA\",\n    \"allowed_user_ids\": [\n      111000111\n    ]\n  },\n  \"log_level\": \"DEBUG\",\n  \"zoneh\": {\n    \"archive\": \"special\",\n    \"filters\": {\n      \"countries\": [\"FR\", \"BR\"],\n      \"domains\": [\".go.id\"],\n      \"notifiers\": [\"BrB\"]\n    },\n    \"rescan_period\": 1800,\n    \"random_ua\": true\n  }\n}\n```\n\n# Usage\n## Manual run\nSimply run and see for welcome message in Telegram client.\n\u003e Note: This will log the output to the stdout/stderr (your terminal). Closing\nthe terminal will shutdown the bot.\n```bash\npython3 zbot.py\n\n# Or make the script executable by adding 'x' flag\nchmod +x zbot.py\n./zbot.py\n```\n## Running by Docker Compose\nBuild image and run the container\n```bash\nsudo docker-compose build \u0026\u0026 sudo docker-compose up\n```\n\n# Misc\n| Command | Description                                      |\n|:--------|:-------------------------------------------------|\n| /start  | Show help                                        |\n| /help   | Show help                                        |\n| /run    | Start data scraping                              |\n| /csv    | Get csv data of gathered records during bot run  |\n| /stop   | Fully terminate the bot                          |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftropicoo%2Fzoneh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftropicoo%2Fzoneh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftropicoo%2Fzoneh/lists"}