👾
A Google Dorking library & Command-Line Interface
Installation
Install ventus with pip
pip install ventus
Usage (command-line interface)
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
from ventus import search
results = search("test")
for r in results:
print(r)
Example 2: Search a raw dork query
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
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
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
- Move search wrapper directly into cli.py [DONE]
- Option to choose number of links to return
- Recode parts of the query builder
- More pre configured searches in CLI
- Option to use custom queries directly in the terminal
About
Made with