{"id":18755790,"url":"https://github.com/kasperskylab/opentip-scanner","last_synced_at":"2025-06-24T13:04:54.324Z","repository":{"id":62592253,"uuid":"491527827","full_name":"KasperskyLab/OpenTIP-scanner","owner":"KasperskyLab","description":"Open-source file scanner that sends requests and optionally uploads files to OpenTIP.kaspersky.com.","archived":false,"fork":false,"pushed_at":"2023-09-27T16:09:01.000Z","size":20,"stargazers_count":19,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-13T01:56:00.798Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KasperskyLab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"License.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-05-12T13:35:15.000Z","updated_at":"2025-02-21T08:37:44.000Z","dependencies_parsed_at":"2023-09-27T16:39:09.434Z","dependency_job_id":null,"html_url":"https://github.com/KasperskyLab/OpenTIP-scanner","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/KasperskyLab%2FOpenTIP-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KasperskyLab%2FOpenTIP-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KasperskyLab%2FOpenTIP-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KasperskyLab%2FOpenTIP-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KasperskyLab","download_url":"https://codeload.github.com/KasperskyLab/OpenTIP-scanner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248654050,"owners_count":21140235,"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":[],"created_at":"2024-11-07T17:33:57.281Z","updated_at":"2025-04-13T01:56:10.713Z","avatar_url":"https://github.com/KasperskyLab.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## OpenTIP scanner\n\nThe script is a Python 3 client to the [OpenTIP service](https://opentip.kaspersky.com).\n\nIt can scan files and directories and provide the category (clean, malware, adware). For unknown files, it will also upload them to the service for scanning and Sandbox processing (optional).\n\nTo run the script, you need to obtain a valid API key from [OpenTIP](https://opentip.kaspersky.com/token) and set it with the --apikey command line switch or the OPENTIP\\_APIKEY environment variable.\n\n## Building\n\n```\npython3 -m build\n```\n\n## Installation\n\nInstall the package via pip.\n\n```\npip3 install opentip\n```\n\n\n## Command line switches\n\n### OpenTIP file scanner\n\n```\nusage: opentip [-h] [--no-upload] [--exclude EXCLUDE] [--log LOG] [--apikey APIKEY] [--quiet] path [path ...]\n\nCheck files and directories with OpenTIP.kaspersky.com, optionally upload and scan unknown files\n\npositional arguments:\n  path               File or directory location to scan\n\noptional arguments:\n  -h, --help         show this help message and exit\n  --no-upload        DO NOT upload unknown files to scan with the Sandbox, default behaviour is to upload\n  --exclude EXCLUDE  Do not scan or upload the files matching the pattern\n  --log LOG          Write results to the log file\n  --apikey APIKEY    OpenTIP API key, received from https://opentip.kaspersky.com/token\n  --quiet            Do not log clean files\n```\n\n### IOC checker\n\n```\nusage: check_iocs [-h] [--apikey APIKEY] [--out OUT] type value\n\nCheck IOCS (file hashes, IP addresses, domain names, URLs using the service OpenTIP.kaspersky.com\n\npositional arguments:\n  type               hash, ip, domain, url\n  value              Value of the IOC (hash, ip, domain, url, filename with the iocs)\n\noptional arguments:\n  -h, --help         show this help message and exit\n  --apikey APIKEY    OpenTIP API key, received from https://opentip.kaspersky.com/token\n  --out OUT, -o OUT  Write output as JSON to this filename\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkasperskylab%2Fopentip-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkasperskylab%2Fopentip-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkasperskylab%2Fopentip-scanner/lists"}