{"id":27710377,"url":"https://github.com/yee-yore/DorkAgent","last_synced_at":"2025-04-26T16:02:30.670Z","repository":{"id":279541859,"uuid":"939160539","full_name":"yee-yore/DorkAgent","owner":"yee-yore","description":"🤖 LLM-powered agent for automated Google Dorking in bug hunting \u0026 pentesting.","archived":false,"fork":false,"pushed_at":"2025-04-17T05:09:48.000Z","size":117,"stargazers_count":25,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-17T19:46:40.642Z","etag":null,"topics":["agent","aiagent","bugbounty","dorks","google-dorking","google-hacking","hacking","llm","osint","pentest","pentesting"],"latest_commit_sha":null,"homepage":"","language":"Python","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/yee-yore.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-26T04:56:34.000Z","updated_at":"2025-04-17T05:09:52.000Z","dependencies_parsed_at":"2025-04-01T06:28:14.490Z","dependency_job_id":"38ec1990-1777-48fd-a60c-7281e063a3e3","html_url":"https://github.com/yee-yore/DorkAgent","commit_stats":null,"previous_names":["yee-yore/dorkagent"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yee-yore%2FDorkAgent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yee-yore%2FDorkAgent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yee-yore%2FDorkAgent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yee-yore%2FDorkAgent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yee-yore","download_url":"https://codeload.github.com/yee-yore/DorkAgent/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251013572,"owners_count":21522869,"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":["agent","aiagent","bugbounty","dorks","google-dorking","google-hacking","hacking","llm","osint","pentest","pentesting"],"created_at":"2025-04-26T16:02:28.641Z","updated_at":"2025-04-26T16:02:30.484Z","avatar_url":"https://github.com/yee-yore.png","language":"Python","funding_links":[],"categories":["Python","agent"],"sub_categories":[],"readme":"# DorkAgent\n🤖 LLM-powered agent for automated Google Dorking in bug hunting \u0026amp; pentesting.\n\n\u003cimg src=\"banner.png\" alt=\"banner\" width=\"700\"\u003e                   \n                                                                                                    \n## Usage\n1. Git clone\n```bash\n\u003e git clone https://github.com/yee-yore/DorkAgent.git\n```\n\n2. Install packages\n```bash\n# python version = 3.11.9\n\u003e pip install -r requirements.txt # for macOS\n\u003e pip install -r requirements_windows.txt # for Windows\n```\n\n3. Configure API keys in the `.env` file  \n- `SERPER_API_KEY` is **required**  \n- You must set at least **one** LLM API key (e.g., OpenAI, Anthropic, or Gemini) depending on your preference  \n- You can also integrate other LLMs: https://docs.crewai.com/concepts/llms\n```bash\nSERPER_API_KEY=        # Required - https://serper.dev/\nOPENAI_API_KEY=        # Optional - set if using OpenAI\nANTHROPIC_API_KEY=     # Optional - set if using Anthropic\nGEMINI_API_KEY=        # Optional - set if using Gemini\n```\n\n4. Run `dorkagent.py`\n```bash\n\u003e python dorkagent.py\n```\n\n## Customize\n1. The number of google results (`serper_dev_tool.py` inside `site-packages/crewai_tools/tools/serper_dev_tool/`)\n```bash\nclass SerperDevTool(BaseTool):\n    ...\n    args_schema: Type[BaseModel] = SerperDevToolSchema\n    base_url: str = \"https://google.serper.dev\"\n    n_results: int = 10 # min: 10, max: 100\n    ...\n```\n2. Duration of google search results (`serper_dev_tool.py`)\n\n```bash\n# https://serper.dev/playground\n\ndef _make_api_request(self, search_query: str, search_type: str) -\u003e dict:\n    ...\n    payload = json.dumps({\"q\": search_query, \"num\": self.n_results, \"qdr:m\"}) # Past week: \"qdr:w\", Past month: \"qdr:m\"\n    ...\n```\n3. Google dorks (`task()`)\n```bash\n# Reference https://github.com/TakSec/google-dorks-bug-bounty\n```\n4. Agents (`agents()`)\n```bash\n# https://docs.crewai.com/concepts/agents\n```\n\n## TODO\n- Support for Telegram bot\n- Customizable Google Dorks set\n- Other Dorks (Github, DuckDuckGo ...)\n- Task/Agent for Validation\n\n\n## Update Log\n- **2025-04-01**: Added hybrid LLM option (GPT \u0026 Claude); Added dork `intitle:\"IIS Windows Server\"`; Applied prompt engineering to tasks.py; Added default depth consideration for subdomain inputs; Added `requirements.txt` for Windows/MacOS compatibility\n- **2025-04-17**: Removed tasks(old).py, the version prior to prompt engineering; Deleted Google Dork for finding “Confidential” documents (most results were merely informative); Removed Google Dork targeting login panels; Added settings to help avoid LLM provider rate limits; Integrated Gemini Flash 2.0 (free to use and currently considered the best value LLM); Merged tasks.py and agents.py into dorkagent.py for simplified maintenance","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyee-yore%2FDorkAgent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyee-yore%2FDorkAgent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyee-yore%2FDorkAgent/lists"}