KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

dorkgen

★ 108 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Dorkgen

Dorkgen is a dork query wrapper for popular search engines such as Google Search, DuckDuckGo, Yahoo and Bing. [Learn more about Google Hacking](https://en.wikipedia.org/wiki/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 for **[PhoneInfoga](https://github.com/sundowndev/PhoneInfoga)**.

## 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](https://pkg.go.dev/github.com/sundowndev/dorkgen/googlesearch) | Stable      |
| [DuckDuckGo](https://pkg.go.dev/github.com/sundowndev/dorkgen/duckduckgo)    | Stable              |
| Yahoo Search  | WIP                   |
| Bing Search   | WIP                   |

## Install

Fetch the module :

```bash
go get github.com/sundowndev/dorkgen
```

## Usage

**[Try it in the Go playground](https://play.golang.org/p/QKHG2cZe4iK)**

#### Get started

```go
package main

import "github.com/sundowndev/dorkgen"

func main() {
  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

```go
func main() {
  dork.Site("facebook.com").Or().Site("twitter.com").String()
  // returns: site:facebook.com | site:twitter.com

dork.InText("facebook").And().InText("twitter").String()
  // returns: intext:"facebook" + intext:"twitter"
}
```

#### Exclude results

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

#### Group tags along with operators

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

#### URL conversion

```go
func main() {
  dork.
    Site("facebook.*").
    Exclude(dorkgen.NewGoogleSearch().Site("facebook.com"))

dork.String()
  // returns: site:facebook.* -site:facebook.com

dork.ToURL()
  // returns: https://www.google.com/search?q=site%3Afacebook.%2A+-site%3Afacebook.com
}
```

## Support

[![](https://raw.githubusercontent.com/sundowndev/dorkgen/master/docs/jetbrains.svg)](https://www.jetbrains.com/?from=sundowndev)

Thanks to [JetBrains](https://www.jetbrains.com/?from=sundowndev) for supporting my open-source projects.

dorkgen

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README