https://github.com/thehamdiz/bluehawk
Email Scraper Tool
https://github.com/thehamdiz/bluehawk
Last synced: 20 days ago
JSON representation
Email Scraper Tool
- Host: GitHub
- URL: https://github.com/thehamdiz/bluehawk
- Owner: theHamdiz
- License: mit
- Created: 2023-08-23T04:46:25.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-08-25T01:45:42.000Z (over 1 year ago)
- Last Synced: 2025-02-14T08:37:27.646Z (2 months ago)
- Language: Python
- Size: 2.36 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Blue Hawk - Information Gathering Tool
- Version: 1.0.0
- Author: Ahmad Hamdi Emara
- Website: https://hamdiz.me
- Copyright: © 2023, Ahmad Hamdi Emara, All rights reserved.
---
### Description:
`Blue Hawk` 🦅 is a powerful **information-gathering tool**
designed to efficiently extract *email addresses*, *phone numbers* & *social links* from a given target website.
Built with `Python`, it provides various features and scraping modes
for an optimized and user-friendly experience.
---
### Dependencies:
- BeautifulSoup
- requests
- *(Note: The script will automatically handle the installation of required packages.)*
### Usage:
- Clone the repository or download the bh.py and helper.py scripts.
---
#### There are two ways to run the script 👇
#### 1. Run the script using command-line arguments: 👇
```zsh
python3 bh.py -d [TARGET_URL] [OPTIONS]
```
- Replace `[TARGET_URL]` with the website URL from which you wish to scrape.
- Replace `[OPTIONS]` with Scraping modes (`--mode`) or their initials, as well as (`--max-depth`).
---
### Options:
`--max-depth` `[DEPTH]`: Set the maximum depth for scraping (**default is 10**).
`--mode` `[MODE]`: Choose the scraping mode. Modes include:
---
`SMART`: Intelligent Scraping.
`LAZY`: One-Request Only Snapshot Scraping.
`VERBOSE`: Recursively Scrape The Original Domain With Any Backlinks Contained Within.
---
#### 2. Run the script without any command-line arguments:
##### Just run it as follows and it will ask you for input. 👇
```zsh
python3 bh.py
```
#### For detailed help:
```zsh
python3 bh.py --help
```
---
### Credits:
All credit goes to Ahmad Hamdi Emara for creating and maintaining this tool.
Visit the official website for more tools and projects by the author.