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.2.tar.gz (19.1 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.2-py3-none-any.whl (23.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: webpeek-1.2.2.tar.gz
  • Upload date:
  • Size: 19.1 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.2.tar.gz
Algorithm Hash digest
SHA256 03f074d85b6371a09c6627dd78d85dbed33a3a2d1aed4bb5d516756636c5f674
MD5 cd0367d0f6cb26f21e9ff83237ca60d8
BLAKE2b-256 864840f34197d73156d45a76cceb9e4e5e73d2bedc326e5a51e30075fabddfc7

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: webpeek-1.2.2-py3-none-any.whl
  • Upload date:
  • Size: 23.5 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e29663ac417cc739ac6443d3d1a7a0d975bf9d30f2fa32c780e21182306e69db
MD5 a55047f6a8bff98a90779f34554a1dd8
BLAKE2b-256 f7a25b60befb935c1ab10089ac4e573b2f64c85bd909c807cf55830987ff8707

See more details on using hashes here.

Provenance

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