Skip to content

A Google Dorking Library & Command-Line Interface 🐲

License

Notifications You must be signed in to change notification settings

aaronlyy/ventus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Oct 19, 2022
155185a Β· Oct 19, 2022

History

59 Commits
Apr 20, 2022
May 3, 2022
Oct 19, 2022
Apr 18, 2022
Apr 18, 2022
Oct 19, 2022
Apr 20, 2022
Oct 19, 2022

Repository files navigation

banner

A Google Dorking library & Command-Line Interface πŸ‘Ύ

GitHub last commit GitHub release (latest by date) GitHub

Installation

Install ventus with pip

pip install ventus

Usage (command-line interface)

Usage: ventus [OPTIONS] QUERY

Options:
  --help                Show this message and exit.
  -l, --leak            Search leaked images and pictures
  -p, --presentation    Search for PDF & PPTX files
  -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)

To Do

  • Add support for proxy lists
  • Add option to choose number of links to return
  • Add more Examples and Documentation

About

Made with β™₯ by aaronlyy