{"id":13843860,"url":"https://github.com/nikallass/sharesearch","last_synced_at":"2025-07-11T20:30:46.372Z","repository":{"id":221585456,"uuid":"139195867","full_name":"nikallass/sharesearch","owner":"nikallass","description":"Samba, NFS shares spider and grepper","archived":false,"fork":false,"pushed_at":"2018-07-11T08:27:38.000Z","size":22,"stargazers_count":71,"open_issues_count":0,"forks_count":16,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-21T15:39:36.206Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nikallass.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-06-29T21:02:54.000Z","updated_at":"2024-10-15T14:27:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"c994d5ac-d49a-4984-aaa2-f0fc040dc8dc","html_url":"https://github.com/nikallass/sharesearch","commit_stats":null,"previous_names":["nikallass/sharesearch"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nikallass/sharesearch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikallass%2Fsharesearch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikallass%2Fsharesearch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikallass%2Fsharesearch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikallass%2Fsharesearch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nikallass","download_url":"https://codeload.github.com/nikallass/sharesearch/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikallass%2Fsharesearch/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264892025,"owners_count":23679207,"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-08-04T17:02:29.582Z","updated_at":"2025-07-11T20:30:46.359Z","avatar_url":"https://github.com/nikallass.png","language":"Python","funding_links":[],"categories":["Python (1887)","Python"],"sub_categories":[],"readme":"# Samba, NFS shares spider and grepper\nShareSearch tool goes through hosts with SMB, NFS, checking credentials,\nlooking for interesting stuff and greping sensitive data in it. WARNING! Alfa version, a lot of bugs and spaghetti code.\n\n## Install\n    pip3 install -r requirements.txt\n    sudo apt-get install cifs-utils\n\n## Usage\n    python3 sharesearch.py [options] DOMAIN/login:password HOSTS_CIDR\n    python3 sharesearch.py [options] WORKGROUP/login:LM:NT HOSTS_CIDR\n\n    python3 sharesearch.py -p all -w -v -H hosts.lst -C creds.lst\n    python3 sharesearch.py -s --share-num 2 --grep -i prev_share_results.csv 192.168.1.62\n\n### Check credentials:\n![Sharesearch usage. Check creds.](https://image.ibb.co/i5GNpy/Selection_290.jpg)\n\n### Grep stuff:\n![Sharesearch usage. Grep files.](https://image.ibb.co/m2yDwd/Selection_291.jpg)\n\n\n\n## Configuration:\nYou can configure sharesearch in default.cfg. \n\n## Lists\n\u003cpre\u003e\n\u003cb\u003ehostlist.lst\u003c/b\u003e =\u003e CIDR ranges or hosts\n\u003cb\u003ecreds.lst\u003c/b\u003e =\u003e списки учетных записей\n\u003c/pre\u003e\n\n## Flags\n\u003cpre\u003e\n\u003cb\u003e--version\u003c/b\u003e  =\u003e  show program's version number and exit\n\u003cb\u003e-h, --help\u003c/b\u003e  =\u003e  show this help message and exit\n\u003c/pre\u003e\n\n### General Options\n\u003cpre\u003e\n\u003cb\u003e-i FILE, --import=FILE\u003c/b\u003e  =\u003e  Import previous csv-results and print them.\n\u003cb\u003e-H FILE, --hosts=FILE\u003c/b\u003e  =\u003e  Get target hosts from input file.\n\u003cb\u003e-m, --masscan\u003c/b\u003e  =\u003e  Use masscan instead of nmap at initial 445, 139 port scan.\n\u003cb\u003e-e, --exist\u003c/b\u003e  =\u003e  Declare all input (-H) hosts containing SMB shares and skip init port scan. Ranges will be removed.\n\u003cb\u003e-C FILE, --creds=FILE\u003c/b\u003e  =\u003e  Get credentials from input file.\n\u003cb\u003e-p [r/rw/w/no/all], --perms=[r/rw/w/no/all]\u003c/b\u003e  =\u003e  Shares with what permissions do we need (default r) [r/rw/w/no/all]\n\u003cb\u003e-w, --check-write\u003c/b\u003e  =\u003e  Check write permissions trying to upload file.\n\u003cb\u003e-v, --verbose\u003c/b\u003e  =\u003e  Be verbose. Print all findings to STDOUT.\n\u003c/pre\u003e\n\n### Share Spider Options\nOptions for spidering files in shares. You can manage files to spider in default.cfg\n\u003cpre\u003e\n\u003cb\u003e-s, --spider\u003c/b\u003e  =\u003e  Spider interesting files in all shares.\n\u003cb\u003e-n SHARE_NUM, --share-num=SHARE_NUM\u003c/b\u003e  =\u003e  Shares numbers in imported result list to spider ([,] as delimiter, [0/a/all] for \"all\").\n\u003cb\u003e-d MAX_DEPTH, --depth=MAX_DEPTH\u003c/b\u003e  =\u003e  Maximum depth level of recursive spidering (default 5).\n\u003cb\u003e-f, --force\u003c/b\u003e  =\u003e  Spider everyting in every share, even if it is already spidered. By default we also skip parsing whole \"ADMIN$\" and \"C$/Windows\" shares to speed up (but we look for SAM, SYSTEM, hosts files.).\n\u003cb\u003e-S FILE, --spider-print=FILE\u003c/b\u003e  =\u003e  Print imported Spider results with highlighting.\n\u003cb\u003e-t THREADS, --threads=THREADS\u003c/b\u003e  =\u003e  TODO: Number of threads while spidering (default 1).\n\u003c/pre\u003e\n\n### File Grep Options\nOptions for grep strings in files found by spider. By default it doesn't grep strings in files after spidering shares. You can manage regular expressions list in default.cfg\n\u003cpre\u003e\n\u003cb\u003e-g, --grep\u003c/b\u003e  =\u003e  Grep previously spidered interesting files.\n\u003cb\u003e-k MAX_FILE_SIZE, --kb-grep-size=MAX_FILE_SIZE\u003c/b\u003e  =\u003e  Maximum filesize in KB for grep (default 200).\n\u003cb\u003e-G FILE, --grep-print=FILE\u003c/b\u003e  =\u003e  Print imported Grep results with highlighting.\n\u003c/pre\u003e\n\n## TODO\n* Download specified file\n* Validate imported csv file\n* Add custom regexp\n* Add flag for grep how many lines to show before and after match\n* Multi threading\n\n## Author\n**nikallass**\n\u003cbr\u003eTelegram: [@is_man](https://t.me/is_man)\n\u003cbr\u003eLinkedIn: [Nikita M.](https://linkedin.com/in/mednikand)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikallass%2Fsharesearch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnikallass%2Fsharesearch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikallass%2Fsharesearch/lists"}