Skip to main content

OSINT CLI tool for web reconnaissance

Project description

webpeek

OSINT CLI tool for web reconnaissance - gather passive and active information about websites.

Installation

From PyPI (recommended when published)

pip install webpeek

From GitHub

pip install git+https://github.com/JorgeRosbel/webpeek.git

Local development

git clone https://github.com/JorgeRosbel/webpeek.git
cd webpeek
pip install -e .

Usage

# Basic scan
webpeek example.com

# Hybrid mode (active + passive)
webpeek example.com -H

# Passive only
webpeek example.com -P

# Active only
webpeek example.com -A

# Dynamic mode (for JavaScript sites)
webpeek example.com -H -y

# Specific modules
webpeek example.com -T -l -e -p

# Save to file
webpeek example.com -H -oN result.txt

# Without colors
webpeek example.com -C

# Help
webpeek --help

Options

Short Flag Description
-H --hybrid Run both active and passive modules
-A --active Run all active modules
-P --passive Run all passive modules
-y --dynamic Use headless browser (Playwright)
-oN --output Save output to file
-C --no-color Disable colors
-v --verbose Verbose output

Passive Modules

Gather information from public sources without connecting directly to the target.

Short Flag Description
-w --whois Domain registration info
-d --dns DNS A records
-m --mx MX records
-t --txt TXT records (SPF, DKIM)
-S --subdomains Find subdomains

Active Modules

Gather information by connecting directly to the target.

Short Flag Description
-h --headers HTTP headers
-c --security Security headers
-T --tech Detect technologies
-W --wplugins WordPress plugins
-s --ssl SSL certificate info
-g --geo Geolocation
-O --os OS detection
-i --title Page title
-D --description Meta description
-e --emails Extract emails
-p --phones Extract phone numbers
-M --sitemap Sitemap URLs
-r --robots Robots.txt
-l --social Social networks

Dynamic Mode

Use -y for JavaScript-rendered sites (React, Vue, Angular, etc.):

webpeek example.com -T -y

First time using dynamic mode will download Chromium (~150MB).


Example Output

╔════════════════════════════════════════════════════════╗
║  🌐 WEBPEEK v1.0.0 - example.com                  ║
╚════════════════════════════════════════════════════════╝

  📡 PASSIVE MODE
  ─────────────────────
  ◉ WHOIS:
      └─ Registrar: NameCheap, Inc.
      └─ Created: 2025-12-14
      └─ Expires: 2026-12-14

  ◉ DNS:
      └─ 93.184.216.34

  ⚡ ACTIVE MODE
  ─────────────────────
  ◉ IP:
      └─ 93.184.216.34

  ◉ Geo:
      └─ US, California (Cloudflare, Inc.)

  ◉ Technologies:
      └─ Cloudflare
      └─ Nginx

  ◉ SSL:
      └─ example.com (expires in 90 days)

╔════════════════════════════════════════════════════════╗
║  Scan complete!                                  ║
╚════════════════════════════════════════════════════════╝

Uninstall

pip uninstall webpeek

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

webpeek-1.2.5.tar.gz (18.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

webpeek-1.2.5-py3-none-any.whl (21.9 kB view details)

Uploaded Python 3

File details

Details for the file webpeek-1.2.5.tar.gz.

File metadata

  • Download URL: webpeek-1.2.5.tar.gz
  • Upload date:
  • Size: 18.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for webpeek-1.2.5.tar.gz
Algorithm Hash digest
SHA256 d1038318813120a370187fdd11d6c1143cd0f4fa6ef1f82759e2306ddcf6b927
MD5 171dd5110541828785b7553a6d866588
BLAKE2b-256 c0c7a2552d2d1fad8539099d93f8d8042a41514e3708a898a7fde9786e6644fe

See more details on using hashes here.

Provenance

The following attestation bundles were made for webpeek-1.2.5.tar.gz:

Publisher: publish.yml on JorgeRosbel/webpeek

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file webpeek-1.2.5-py3-none-any.whl.

File metadata

  • Download URL: webpeek-1.2.5-py3-none-any.whl
  • Upload date:
  • Size: 21.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for webpeek-1.2.5-py3-none-any.whl
Algorithm Hash digest
SHA256 00fae82998b236faad762e3dd53648ac05a208632ad5f5e36354c87b94c2552b
MD5 c8c8be198b06a44ffafd9f24857f73c6
BLAKE2b-256 8250e23aa355ad010b9771df53cf3ef045a2dd3536694f37a9edfe17ea1b49d6

See more details on using hashes here.

Provenance

The following attestation bundles were made for webpeek-1.2.5-py3-none-any.whl:

Publisher: publish.yml on JorgeRosbel/webpeek

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page