{"id":16895382,"url":"https://github.com/sundowndev/dorkgen","last_synced_at":"2025-04-07T11:06:31.065Z","repository":{"id":45823352,"uuid":"242708177","full_name":"sundowndev/dorkgen","owner":"sundowndev","description":"Type-safe dork queries for search engines such as Google, Yahoo, DuckDuckGo \u0026 Bing","archived":false,"fork":false,"pushed_at":"2021-03-04T13:37:14.000Z","size":183,"stargazers_count":95,"open_issues_count":1,"forks_count":19,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-31T09:07:37.069Z","etag":null,"topics":["bing","bing-search","dork","dork-queries","duckduckgo","google-hacking","search-engine","search-engines","yahoo"],"latest_commit_sha":null,"homepage":"https://pkg.go.dev/github.com/sundowndev/dorkgen","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sundowndev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-24T10:34:17.000Z","updated_at":"2025-03-17T18:34:19.000Z","dependencies_parsed_at":"2022-07-17T10:16:21.927Z","dependency_job_id":null,"html_url":"https://github.com/sundowndev/dorkgen","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sundowndev%2Fdorkgen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sundowndev%2Fdorkgen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sundowndev%2Fdorkgen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sundowndev%2Fdorkgen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sundowndev","download_url":"https://codeload.github.com/sundowndev/dorkgen/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247640462,"owners_count":20971557,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bing","bing-search","dork","dork-queries","duckduckgo","google-hacking","search-engine","search-engines","yahoo"],"created_at":"2024-10-13T17:23:23.796Z","updated_at":"2025-04-07T11:06:31.034Z","avatar_url":"https://github.com/sundowndev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"left\"\u003e\n  \u003ca href=\"https://pkg.go.dev/github.com/sundowndev/dorkgen\"\u003e\u003cimg src=\"https://pkg.go.dev/badge/github.com/sundowndev/dorkgen.svg\" alt=\"Go Reference\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sundowndev/dorkgen/actions\"\u003e\n    \u003cimg src=\"https://img.shields.io/endpoint.svg?url=https://actions-badge.atrox.dev/sundowndev/dorkgen/badge?ref=master\" alt=\"build status\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://goreportcard.com/report/github.com/sundowndev/dorkgen\"\u003e\n    \u003cimg src=\"https://goreportcard.com/badge/github.com/sundowndev/dorkgen\" alt=\"go report\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://codeclimate.com/github/sundowndev/dorkgen/maintainability\"\u003e\n    \u003cimg src=\"https://api.codeclimate.com/v1/badges/e827d7cc994c6519d319/maintainability\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/sundowndev/dorkgen\"\u003e\n    \u003cimg src=\"https://codecov.io/gh/sundowndev/dorkgen/branch/master/graph/badge.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/sundowndev/dorkgen/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/release/SundownDEV/dorkgen.svg\" alt=\"Latest version\" /\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n# Dorkgen\n\nDorkgen 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)**.\n\n## Current status\n\nVersion 1 is ongoing, but the API is still not fixed. **See below table for supported search engines and status of their implementation**.\n\n| Search engine        | Implementation status |\n|---------------|:-----------------------:|\n| [Google Search](https://pkg.go.dev/github.com/sundowndev/dorkgen/googlesearch) | Stable      |\n| [DuckDuckGo](https://pkg.go.dev/github.com/sundowndev/dorkgen/duckduckgo)    | Stable              |\n| Yahoo Search  | WIP                   |\n| Bing Search   | WIP                   |\n\n## Install\n\nFetch the module :\n\n```bash\ngo get github.com/sundowndev/dorkgen\n```\n\n## Usage\n\n**[Try it in the Go playground](https://play.golang.org/p/QKHG2cZe4iK)**\n\n#### Get started\n\n```go\npackage main\n\nimport \"github.com/sundowndev/dorkgen\"\n\nfunc main() {\n  dork := dorkgen.NewGoogleSearch()\n  // dork := dorkgen.NewDuckDuckGo()\n  // dork := dorkgen.NewBingSearch()\n  // dork := dorkgen.NewYahooSearch()\n\n  dork.Site(\"example.com\").InText(\"text\").String()\n  // returns: site:example.com intext:\"text\"\n}\n```\n\n#### Operators\n\n```go\nfunc main() {\n  dork.Site(\"facebook.com\").Or().Site(\"twitter.com\").String()\n  // returns: site:facebook.com | site:twitter.com\n\n  dork.InText(\"facebook\").And().InText(\"twitter\").String()\n  // returns: intext:\"facebook\" + intext:\"twitter\"\n}\n```\n\n#### Exclude results\n\n```go\nfunc main() {\n  dork.\n    Exclude(dorkgen.NewGoogleSearch().Site(\"example.com\")).\n    Site(\"example.*\").\n    Or().\n    InText(\"text\")\n  // returns: -site:example.com site:example.* | \"text\"\n}\n```\n\n#### Group tags along with operators\n\n```go\nfunc main() {\n  dork.\n    Group(dorkgen.NewGoogleSearch().\n      Site(\"facebook.com\").\n      Or().\n      Site(\"twitter.com\")).\n    InText(\"wtf\").\n    String()\n  // returns: (site:facebook.com | site:twitter.com) \"wtf\"\n}\n```\n\n#### URL conversion\n\n```go\nfunc main() {\n  dork.\n    Site(\"facebook.*\").\n    Exclude(dorkgen.NewGoogleSearch().Site(\"facebook.com\"))\n\n  dork.String()\n  // returns: site:facebook.* -site:facebook.com\n\n  dork.ToURL()\n  // returns: https://www.google.com/search?q=site%3Afacebook.%2A+-site%3Afacebook.com\n}\n```\n\n## Support\n\n[![](docs/jetbrains.svg)](https://www.jetbrains.com/?from=sundowndev)\n\nThanks to [JetBrains](https://www.jetbrains.com/?from=sundowndev) for supporting my open-source projects.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsundowndev%2Fdorkgen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsundowndev%2Fdorkgen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsundowndev%2Fdorkgen/lists"}