Skip to content
New

DeepSeek V4.1 Flash free for 7 days: 10M tokens a day after a top-up of $10 or more. Until Nov 30.

How it works
aeondave/spiderfootRecon and OSINT

spiderfoot

⁨Auth/lab ref: Automated OSINT platform with 200+ modules for target profiling: DNS, email, username, IP, ASN, breach data, dark web, social media, threat intel.⁩

v2026.11.13-21cd5683 installs+3 in 7 days39 StarsMITsynced 11 hours ago

Install

No NotHoly CLI yet? Install it first.

$ curl -fsSL https://notholy.com/install.sh | sh
$ notholy skills install aeondave/spiderfoot

Writes to ⁦~/.notholy/skills⁩ after checking the signature and the SHA-256.

SignatureSigned, ed25519
B2sjLHFrv3…M9usiVAg==The CLI checks the SHA-256 and the signature before it writes a file.
Package7850d62f…63f8f348
7850d62f6766…f74663f8f3482 files · ⁦3.6 KB⁩
ScanMedium3 findings
  • Link to a raw IP addressSKILL.md:27
  • Link to a raw IP addressSKILL.md:106
  • Links to outside domains
See the full scan
Sourcegithub.com/AeonDave/malskill/tree/main/offensive-tools/osint/spiderfoot@21cd568

Automated OSINT platform — 200+ modules, correlates all data types around a target.

Quick Start

bash
git clone https://github.com/smicallef/spiderfoot
cd spiderfoot
pip install -r requirements.txt

# CLI scan on domain
python3 sf.py -s target.com -t INTERNET_NAME -o json -q

# Web UI (interactive)
python3 sf.py -l 127.0.0.1:5001
# → http://127.0.0.1:5001

Target Types (-t)

Type Description Example
INTERNET_NAME Hostname / domain target.com
IP_ADDRESS IPv4 address 1.2.3.4
EMAILADDR Email address [email protected]
USERNAME Social username johndoe
PHONE_NUMBER Phone number +14151234567
HUMAN_NAME Person's name "John Doe"
NETBLOCK_OWNER ASN or CIDR AS12345
BGP_AS_OWNER ASN number 12345
URL_FORM URL to scan https://target.com/login

CLI Usage

bash
# Domain scan — all passive modules
python3 sf.py -s target.com -t INTERNET_NAME -o json -q > results.json

# Email scan
python3 sf.py -s [email protected] -t EMAILADDR -o json -q

# Specific modules only
python3 sf.py -s target.com -t INTERNET_NAME -m sfp_dnsresolve,sfp_sublist3r,sfp_crtsh -o json -q

# List all modules
python3 sf.py -M

# List modules by type
python3 sf.py -M | grep -i "passive"

Key CLI Flags

Flag Purpose
-s <target> Target value
-t <type> Target type
-m <modules> Specific modules (comma-separated)
-o json/csv/tab Output format
-q Quiet (no progress)
-l <host:port> Start web UI
-M List all modules
--timeout <sec> Global timeout

Module Categories

bash
# List all categories
python3 sf.py -M | awk '{print $1}' | sort -u

# Useful module groups
sfp_dnsresolve      # DNS resolution
sfp_crtsh           # Certificate transparency
sfp_sublist3r       # Subdomain enumeration
sfp_shodan          # Shodan integration (API key)
sfp_virustotal      # VirusTotal (API key)
sfp_hunter          # Hunter.io emails (API key)
sfp_emailharvest    # Email harvesting
sfp_haveibeenpwned  # Breach check (API key)
sfp_linkedin        # LinkedIn profiles
sfp_twitter         # Twitter profiles
sfp_github          # GitHub user/org data
sfp_pastebin        # Pastebin leaks
sfp_darkweb         # Dark web mentions (Tor)
sfp_threatintel     # Threat intelligence feeds
sfp_whois           # WHOIS data

Web UI Workflow

bash
python3 sf.py -l 127.0.0.1:5001
  1. Browse to http://127.0.0.1:5001
  2. New Scan → enter target + type
  3. Select scan profile: Passive, Investigate, Footprint, All
  4. Run → watch live graph of discovered entities
  5. Browse results by data type: emails, IPs, subdomains, leaked credentials, social profiles
  6. Export: JSON/CSV for downstream use

Scan Profiles

Profile Modules Use
Passive ~50 No direct target contact
Investigate ~100 Mixed passive + active
Footprint ~150 Full external footprint
All 200+ Everything (loud)

API Key Configuration

ini
# spiderfoot.db stores settings after first run
# Or configure via web UI: Settings → API Keys

High-value API keys:

text
Hunter.io       → email harvest
Shodan          → port/service data
VirusTotal      → malware/domain intel
HaveIBeenPwned  → breach lookup
SecurityTrails  → DNS history
IntelX          → dark web / leaks

Parse JSON Output

python
import json

with open("results.json") as f:
    results = json.load(f)

# Group by data type
from collections import defaultdict
by_type = defaultdict(list)
for item in results:
    by_type[item["type"]].append(item["data"])

# Print emails found
for email in set(by_type.get("EMAILADDR", [])):
    print(email)

# Print subdomains
for sub in set(by_type.get("INTERNET_NAME", [])):
    print(sub)

Resources

File When to load
references/modules.md Full module list with descriptions, API requirements, and recommended scan configurations

Files in this version

Permissions

PermissionDeclaredFound by the scan
Reads filesNoNo
Writes filesYesYes
Runs shell commandsYesYes
Uses the networkYesYes
Uses connectorsNoNo
Drives a browserNoNo

Scan findings

Reviewed on Nov 13, 2026

  1. MediumLink · Link to a raw IP addressSKILL.md:27
  2. MediumLink · Link to a raw IP addressSKILL.md:106
  3. InfoLink · Links to outside domains

A clean scan lowers the risk but does not prove a package is safe. Read what you install.

VersionPublishedCommitSHA-256SignaturePermission change
v2026.11.13-21cd568Nov 13, 202621cd5687850d62fSigned–

Ask anything your scope allows.

Create an account, add credits and ask the first question in the chat or the terminal.

  1. 1/3

    Create the account

    Individual or company. You can switch to a company later without losing balance or keys.

    IndividualCompany
  2. 2/3

    Add credits

    By card. Pay per token, no subscription.

    $5.00minimum deposit
  3. 3/3

    Ask

    In the chat, or install the CLI and run notholy login in your terminal.

    $ notholy login