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.6.tar.gz (18.3 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.6-py3-none-any.whl (21.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: webpeek-1.2.6.tar.gz
  • Upload date:
  • Size: 18.3 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.6.tar.gz
Algorithm Hash digest
SHA256 b171e43aac3ef3b64ee63fbdb4b78feb58f9fa57fbca5fe4e62eb064e09de7a8
MD5 af77af1bcb8e4a65b4d6127da32ad0d5
BLAKE2b-256 53ba01895c337847f45f08f80be88559c178176a6dd92019f6be7e885eb49083

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: webpeek-1.2.6-py3-none-any.whl
  • Upload date:
  • Size: 21.8 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 548ba80f538399b51ef87103713b16fd5f26a3241b285cbb75197786e1c81fc1
MD5 1991205b6f7c0098f5955c741db697e4
BLAKE2b-256 41a7d8233b05ed3a73d9bf964897287c10939ba38461e5d5511b07229050b45f

See more details on using hashes here.

Provenance

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