# blacklanternsecurity/MANSPIDER

Spider entire networks for juicy files sitting on SMB shares.  Search filenames or file content - regex supported!

Repository: https://github.com/blacklanternsecurity/MANSPIDER
Canonical: https://ross.abutalabs.com/products/manspider
Language: Python
License: GPL-3.0
License Family: copyleft
Last push: 2026-08-26T17:45:37+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 35, longevity 100
- inputs: {"age_days": 2359, "days_push": 7, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1406, forks 163 (observed 2026-08-28T04:04:38.365183+00:00)

## What it is
MANSPIDER is a Python CLI tool that crawls SMB shares across entire networks to find files by filename or content, with regex support and text extraction from formats like PDF, DOCX, XLSX, PPTX, and images via OCR. Matching files are automatically downloaded as loot, with credential fallback from provided creds to guest to null sessions.

## Use cases
- search network SMB shares for files containing passwords
- crawl Windows file shares for sensitive documents
- find spreadsheets with 'password' in the filename
- grep file content across a subnet over SMB
- extract text from PDFs and Office docs on network shares
- hunt for credentials on accessible file shares during a pentest
- search files by modification date on SMB shares

## When to choose
- you need to audit or enumerate SMB shares across many hosts at once
- you want content search (not just filenames) including PDF/Office/OCR extraction
- you're doing offensive security assessments or internal network recon

## When to avoid
- you need to crawl non-SMB protocols like NFS, S3, or HTTP
- you want a GUI-based file search tool
- you lack authorization to access the target network shares

## Facets
- artifact type: cli-tool
- maturity: active
- function: search-engine, web-scraping, ocr, security, cli
- domain: security, penetration-testing, osint, files
- platform: windows, python, cli
- tags: smb, network-crawling, file-content-search, regex-search, penetration-testing, text-extraction, credential-hunting, command-line, linux, macos, docker

## Member repositories
- blacklanternsecurity/MANSPIDER (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:38.365183+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:38:41.539134+00:00, confidence not recorded.
  - readme: https://github.com/blacklanternsecurity/MANSPIDER (fetched 2026-08-28T04:04:38.365183+00:00, sha b13cdf6b9095)
- Data as of 2026-08-30T08:39:29.467469+00:00.