https://github.com/aaronlyy/ventus
A Google Dorking Library & Command-Line Interface 🐲
https://github.com/aaronlyy/ventus
dork dorking dorking-tool google google-dorking scraper scraping
Last synced: 3 months ago
JSON representation
A Google Dorking Library & Command-Line Interface 🐲
- Host: GitHub
- URL: https://github.com/aaronlyy/ventus
- Owner: aaronlyy
- License: gpl-3.0
- Created: 2022-04-18T11:07:39.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2023-09-15T22:41:04.000Z (almost 3 years ago)
- Last Synced: 2025-11-28T12:38:43.303Z (7 months ago)
- Topics: dork, dorking, dorking-tool, google, google-dorking, scraper, scraping
- Language: Python
- Homepage:
- Size: 306 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
A Google Dorking library & Command-Line Interface 👾
## Installation
Install ventus with pip
```pip install ventus```
## Usage (command-line interface)
```txt
Usage: ventus [OPTIONS] QUERY
Options:
--help Show this message and exit
-p, --paste Search paste sites
-f, --files Search filesharing sites
-i, --index Search index of /
-d, --document Search for DOCX files
```
## Usage (library)
### Example 1: Search a string
```py
from ventus import search
results = search("test")
for r in results:
print(r)
```
### Example 2: Search a raw dork query
```py
from ventus import search
results = search("site:wikipedia.com mercedes")
for r in results:
print(r)
for r in results:
print(r)
```
### Example 3: Build and search a query using the query builder
```py
from ventus import search, Query
q = Query()
q.site("finance.yahoo.com")
q.intitle("AMD")
print(q) # site:finance.yahoo.com intitle:AMD
# search query
results = search(q)
for r in results:
print(r)
```
### Example 4: Add a keyword group to a query
```py
from ventus import search, Query, Filter
q = Query()
q.site("finance.yahoo.com")
q.intitle(["BMW", "Mercedes"], group_seperator=Filter.AND)
print(q) # site:finance.yahoo.com intitle:(BMW & Mercedes)
# search query
results = search(q)
for r in results:
print(r)
```
## Roadmap
- recode searcher and add support for pagination
- add option to choose number of links to return
- more pre configured searches in cli
- recode query builder
- show live updates while searching
- add proxy from file support
- add exceptions
- refactor all files
### About
Made with ♥ by [aaronlyy](https://github.com/aaronlyy)