Skip to content

Latest commit

 

History

History
109 lines (74 loc) · 2.09 KB

README.md

File metadata and controls

109 lines (74 loc) · 2.09 KB

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
  -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

  • 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