sundowndev/dorkgenPublic

NotificationsYou must be signed in to change notification settings
Fork19
Star97

Type-safe dork queries for search engines such as Google, Yahoo, DuckDuckGo & Bing

pkg.go.dev/github.com/sundowndev/dorkgen

License

MIT license

97 stars 19 forks Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 89 Commits
.github/workflows		.github/workflows
docs		docs
duckduckgo		duckduckgo
googlesearch		googlesearch
.codeclimate.yml		.codeclimate.yml
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
doc.go		doc.go
dorkgen.go		dorkgen.go
dorkgen_test.go		dorkgen_test.go
go.mod		go.mod
go.sum		go.sum
renovate.json		renovate.json

Repository files navigation

Dorkgen

Dorkgen is a dork query wrapper for popular search engines such as Google Search, DuckDuckGo, Yahoo and Bing.Learn more about Google Hacking. The goal of this package is to provide simple interfaces to creates valid dork queries for various search engines. This library was initially created forPhoneInfoga.

Current status

Version 1 is ongoing, but the API is still not fixed.See below table for supported search engines and status of their implementation.

Search engine	Implementation status
Google Search	Stable
DuckDuckGo	Stable
Yahoo Search	WIP
Bing Search	WIP

Install

Fetch the module :

go get github.com/sundowndev/dorkgen

Usage

Try it in the Go playground

Get started

package mainimport"github.com/sundowndev/dorkgen"funcmain() {dork:=dorkgen.NewGoogleSearch()// dork := dorkgen.NewDuckDuckGo()// dork := dorkgen.NewBingSearch()// dork := dorkgen.NewYahooSearch()dork.Site("example.com").InText("text").String()// returns: site:example.com intext:"text"}

Operators

funcmain() {dork.Site("facebook.com").Or().Site("twitter.com").String()// returns: site:facebook.com | site:twitter.comdork.InText("facebook").And().InText("twitter").String()// returns: intext:"facebook" + intext:"twitter"}

Exclude results

funcmain() {dork.Exclude(dorkgen.NewGoogleSearch().Site("example.com")).Site("example.*").Or().InText("text")// returns: -site:example.com site:example.* | "text"}

Group tags along with operators

funcmain() {dork.Group(dorkgen.NewGoogleSearch().Site("facebook.com").Or().Site("twitter.com")).InText("wtf").String()// returns: (site:facebook.com | site:twitter.com) "wtf"}

URL conversion

funcmain() {dork.Site("facebook.*").Exclude(dorkgen.NewGoogleSearch().Site("facebook.com"))dork.String()// returns: site:facebook.* -site:facebook.comdork.ToURL()// returns: https://www.google.com/search?q=site%3Afacebook.%2A+-site%3Afacebook.com}