Updated Readme to reflect new branding
|
Before Width: | Height: | Size: 2.5 MiB |
|
Before Width: | Height: | Size: 188 KiB |
|
Before Width: | Height: | Size: 495 KiB |
|
Before Width: | Height: | Size: 996 KiB |
|
Before Width: | Height: | Size: 110 KiB |
|
Before Width: | Height: | Size: 2.1 MiB |
|
Before Width: | Height: | Size: 966 KiB |
|
Before Width: | Height: | Size: 112 KiB |
|
Before Width: | Height: | Size: 1.5 MiB |
|
Before Width: | Height: | Size: 604 KiB |
|
Before Width: | Height: | Size: 100 KiB |
|
Before Width: | Height: | Size: 116 KiB |
|
Before Width: | Height: | Size: 33 KiB |
@@ -276,7 +276,13 @@ This is a combination of the company and person enrichments given an email addre
|
|||||||
# Perform a Hunter.io combined enrichment search for example@target.com
|
# Perform a Hunter.io combined enrichment search for example@target.com
|
||||||
crowsnest hunter -e example@target.com -B
|
crowsnest hunter -e example@target.com -B
|
||||||
```
|
```
|
||||||
|
## Debugging
|
||||||
|
CrowsNest supports debugging. This can be enabled using the `--debug` flag in the root command.
|
||||||
|

|
||||||
|
```bash
|
||||||
|
# Perform a Hunter.io combined enrichment search for example@target.com with debugging enabled
|
||||||
|
crowsnest --debug hunter -e example@target.com -B
|
||||||
|
```
|
||||||
---
|
---
|
||||||
## 📊 Database Querying
|
## 📊 Database Querying
|
||||||
CrowsNest stores query results in a local database.
|
CrowsNest stores query results in a local database.
|
||||||
@@ -287,10 +293,10 @@ This database also includes WhoIs Information and Subdomain Scan results, but do
|
|||||||
## Simple Query
|
## Simple Query
|
||||||
#### It's possible to query the database using shorthand and without knowing any SQL at all.
|
#### It's possible to query the database using shorthand and without knowing any SQL at all.
|
||||||
#### The following queries the results table where username is not null, only showing the username, email and password columns.
|
#### The following queries the results table where username is not null, only showing the username, email and password columns.
|
||||||

|

|
||||||
#### You may also add in a simple query using the `-q` flag. The following displays a 'LIKE' clause on the email column.
|
#### You may also add in a simple query using the `-q` flag. The following displays a 'LIKE' clause on the email column.
|
||||||
#### Note the '%\<clause\>%' is still required.
|
#### Note the '%\<clause\>%' is still required.
|
||||||

|

|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Query the database for all results containing the word 'admin' in the username
|
# Query the database for all results containing the word 'admin' in the username
|
||||||
@@ -299,7 +305,7 @@ crowsnest query -t results -q "username LIKE '%admin%'"
|
|||||||
|
|
||||||
|
|
||||||
## Raw SQL Queries
|
## Raw SQL Queries
|
||||||

|

|
||||||
|
|
||||||
CrowsNest also supports raw SQL queries. This is useful for when you want to query for specific information.
|
CrowsNest also supports raw SQL queries. This is useful for when you want to query for specific information.
|
||||||
```bash
|
```bash
|
||||||
@@ -317,6 +323,7 @@ crowsnest query -t results -q "username LIKE '%admin%'" -n username,email,passwo
|
|||||||
## Listing Tables and Columns
|
## Listing Tables and Columns
|
||||||
CrowsNest supports listing all available tables and columns.
|
CrowsNest supports listing all available tables and columns.
|
||||||
This is useful for when you want to query for specific information.
|
This is useful for when you want to query for specific information.
|
||||||
|

|
||||||
```bash
|
```bash
|
||||||
# List all available tables and columns
|
# List all available tables and columns
|
||||||
crowsnest query -a
|
crowsnest query -a
|
||||||
@@ -347,6 +354,7 @@ CrowsNest supports exporting results to a file.
|
|||||||
This is useful for when you want to requery for specific information without touching the Dehashed API.
|
This is useful for when you want to requery for specific information without touching the Dehashed API.
|
||||||
The export subcommand supports all the same options as the query subcommand.
|
The export subcommand supports all the same options as the query subcommand.
|
||||||
The export subcommand also supports file naming and output format control.
|
The export subcommand also supports file naming and output format control.
|
||||||
|

|
||||||
```bash
|
```bash
|
||||||
# Export all results containing the word 'admin' in the username to a text file
|
# Export all results containing the word 'admin' in the username to a text file
|
||||||
crowsnest export -t results -q "username LIKE '%admin%'" -o admins_file -f txt
|
crowsnest export -t results -q "username LIKE '%admin%'" -o admins_file -f txt
|
||||||
@@ -357,8 +365,8 @@ crowsnest export -t results -q "username LIKE '%admin%'" -o admins_file -f txt
|
|||||||
CrowsNest uses the `zap` logging library for logging. The logs are stored in `~/.local/share/crowsnest/logs`.
|
CrowsNest uses the `zap` logging library for logging. The logs are stored in `~/.local/share/crowsnest/logs`.
|
||||||
The logs can be easily queried from the crowsnest CLI.
|
The logs can be easily queried from the crowsnest CLI.
|
||||||
|
|
||||||
### Logs Dates
|
### Filtering by Date
|
||||||
#### crowsnest utilized 'easy time' to determine the appropriate time for a given query.
|
#### CrowsNest utilizes 'easy time' to determine the appropriate time for a given query.
|
||||||

|

|
||||||
#### You may also used dates mixed with easy time to perform queries.
|
#### You may also used dates mixed with easy time to perform queries.
|
||||||

|

|
||||||
@@ -385,24 +393,10 @@ crowsnest logs -s "last 24 hours"
|
|||||||
crowsnest logs -s "05-01-2025" -v error,fatal
|
crowsnest logs -s "05-01-2025" -v error,fatal
|
||||||
```
|
```
|
||||||
|
|
||||||
## 🎉 Sample Run
|
|
||||||
```bash
|
|
||||||
ar1ste1a@kali:~$ crowsnest dehashed -D <redacted>.com -o <redacted> -f json
|
|
||||||
Making 3 Requests for 10000 Records (30000 Total)
|
|
||||||
[*] Querying Dehashed API...
|
|
||||||
[*] Performing Request...
|
|
||||||
[+] Retrieved 2740 Records
|
|
||||||
[-] Not Enough Entries, ending queries
|
|
||||||
[+] Discovered 10 Credentials
|
|
||||||
[*] Writing entries to file: <redacted>.json
|
|
||||||
[*] Success
|
|
||||||
[*] Completing Process
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🤝 Contributing
|
## 🤝 Contributing
|
||||||
Contributions are welcome! Submit a pull request to help improve CrowsNest.
|
Contributions are welcome! Submit a pull request to help improve CrowsNest.
|
||||||
|
|
||||||
|
## [Buy Me A Coffee](https://buymeacoffee.com/ehosinskiz)
|
||||||
|
|
||||||
<div align="center">
|
<div align="center">
|
||||||
<img src="https://img.wanman.io/fUSu0/jUtovIFE52.png/raw" style="width: 350px; height: auto" alt="Ar1ste1a" title="Ar1ste1a Offensive Security">
|
<img src="https://img.wanman.io/fUSu0/jUtovIFE52.png/raw" style="width: 350px; height: auto" alt="Ar1ste1a" title="Ar1ste1a Offensive Security">
|
||||||
|
|||||||