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.3.4 - 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.3.4.tar.gz (19.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.3.4-py3-none-any.whl (23.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: webpeek-1.3.4.tar.gz
  • Upload date:
  • Size: 19.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.3.4.tar.gz
Algorithm Hash digest
SHA256 fdf84a5fa8c2004086748f2c4e7ecd442875efce3511112d9dcbc97c8b8b74e8
MD5 f3f0863d4be55e704aad31c3119a169b
BLAKE2b-256 e8a1fe8fbd5f42bbc50d71c6252b2c8b8262f50c4e1e114438fe7438dddeb313

See more details on using hashes here.

Provenance

The following attestation bundles were made for webpeek-1.3.4.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.3.4-py3-none-any.whl.

File metadata

  • Download URL: webpeek-1.3.4-py3-none-any.whl
  • Upload date:
  • Size: 23.1 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.3.4-py3-none-any.whl
Algorithm Hash digest
SHA256 abc9291381dbd578a43784ed53496c4a8a3c1dfdc72bc9450758c76a3fe6e254
MD5 053592a7094b832e260a49e35b78d3c4
BLAKE2b-256 206833f998e8dc522c889c2b8e81a5dd97c9b6a40a0755a342a8ac0a48edc39b

See more details on using hashes here.

Provenance

The following attestation bundles were made for webpeek-1.3.4-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