{"id":13478953,"url":"https://github.com/bhavsec/reconspider","last_synced_at":"2026-04-09T00:31:20.894Z","repository":{"id":40212985,"uuid":"161927328","full_name":"bhavsec/reconspider","owner":"bhavsec","description":"🔎 Most Advanced Open Source Intelligence (OSINT) Framework for scanning IP Address, Emails, Websites, Organizations.","archived":false,"fork":false,"pushed_at":"2023-09-26T10:12:16.000Z","size":65815,"stargazers_count":2530,"open_issues_count":29,"forks_count":359,"subscribers_count":73,"default_branch":"master","last_synced_at":"2025-12-15T15:37:06.498Z","etag":null,"topics":["automated","cybersecurity","framework","hacking","information-gathering","osint","pentest","pentesting","python","recon","reconnaissance","scanner","security"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bhavsec.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2018-12-15T17:16:27.000Z","updated_at":"2025-12-15T14:16:47.000Z","dependencies_parsed_at":"2023-10-20T18:24:11.949Z","dependency_job_id":null,"html_url":"https://github.com/bhavsec/reconspider","commit_stats":{"total_commits":121,"total_committers":9,"mean_commits":"13.444444444444445","dds":0.5371900826446281,"last_synced_commit":"5dae8c16b2845b5ccb73aba93e333fe308b0754a"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/bhavsec/reconspider","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhavsec%2Freconspider","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhavsec%2Freconspider/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhavsec%2Freconspider/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhavsec%2Freconspider/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bhavsec","download_url":"https://codeload.github.com/bhavsec/reconspider/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhavsec%2Freconspider/sbom","scorecard":{"id":236504,"data":{"date":"2025-08-11","repo":{"name":"github.com/bhavsec/reconspider","commit":"5dae8c16b2845b5ccb73aba93e333fe308b0754a"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":0,"reason":"Found 1/29 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 2 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T05:53:03.418Z","repository_id":40212985,"created_at":"2025-08-17T05:53:03.418Z","updated_at":"2025-08-17T05:53:03.418Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31579832,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["automated","cybersecurity","framework","hacking","information-gathering","osint","pentest","pentesting","python","recon","reconnaissance","scanner","security"],"created_at":"2024-07-31T16:02:06.451Z","updated_at":"2026-04-09T00:31:20.869Z","avatar_url":"https://github.com/bhavsec.png","language":"Python","funding_links":[],"categories":["Python","[](#table-of-contents) Table of contents","security"],"sub_categories":["[](#netflix)Netflix"],"readme":"\u003ch1 align=\"center\"\u003e\n\u003ca href=\"https://github.com/bhavsec/reconspider\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/bhavsec/reconspider/master/logo.png\" width=\"200\"\u003e\u003c/a\u003e\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003e Most Advanced Open Source Intelligence (OSINT) Framework \u003c/h4\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/bhavsec/reconspider\"\u003e\u003cimg src=\"https://img.shields.io/static/v1?label=version\u0026message=1.0.7\u0026color=blue\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/bhavsec/reconspider/issues?q=is:issue+is:closed\"\u003e\u003cimg src=\"https://img.shields.io/github/issues-closed/bhavsec/reconspider?color=orange\"\u003e\u003c/a\u003e\n\u003ca href=\"https://travis-ci.com/bhavsec/reconspider\"\u003e\u003cimg src=\"https://api.travis-ci.com/bhavsec/reconspider.svg\"\u003e\u003c/a\u003e\n\n\n\u003c/p\u003e\n\n# ReconSpider\n\nReconSpider is most Advanced Open Source Intelligence (OSINT) Framework for scanning IP Address, Emails, Websites, Organizations and find out information from different sources.\n\nReconSpider can be used by Infosec Researchers, Penetration Testers, Bug Hunters and Cyber Crime Investigators to find deep information about their target.\n\nReconSpider aggregate all the raw data, visualize it on a dashboard and facilitate alerting and monitoring on the data.\n\nRecon Spider also combines the capabilities of [Wave](https://github.com/adithyan-ak/WAVE), [Photon](https://github.com/s0md3v/Photon) and [Recon Dog](https://github.com/s0md3v/ReconDog) to do a comprehensive enumeration of attack surface.\n\n# Why it's called ReconSpider ?\n\n```ReconSpider```  =  ```Recon```  +  ```Spider```\n\n\n**Recon** = **Reconnaissance**\n\nReconnaissance is a mission to obtain information by various detection methods, about the activities and resources of an enemy or potential enemy, or geographic characteristics of a particular area.\n\n\n**Spider = Web crawler**\n\nA Web crawler, sometimes called a spider or spiderbot and often shortened to crawler, is an Internet bot that systematically browses the World Wide Web, typically for the purpose of Web indexing (web spidering).\n\n  \n# Table Of Contents\n\n1. [Version (beta)](https://github.com/bhavsec/reconspider#version-beta)\n2. [Overview of the tool](https://github.com/bhavsec/reconspider#overview-of-the-tool)\n3. [Mind Map (v1)](https://github.com/bhavsec/reconspider#mind-map-v1)\n4. [License Information](https://github.com/bhavsec/reconspider#license-information)\n5. [ReconSpider Banner](https://github.com/bhavsec/reconspider#reconspider-banner)\n6. [Documentation](https://github.com/bhavsec/reconspider#documentation)\n7. [Setting up the environment](https://github.com/bhavsec/reconspider#setting-up-the-environment)\n8. [Updating API Keys](https://github.com/bhavsec/reconspider#updating-api-keys)\n9. [Usage](https://github.com/bhavsec/reconspider#usage)\n10. [Contact](https://github.com/bhavsec/reconspider#contact)\n11. [Wiki \u0026 How-to Guide](https://github.com/bhavsec/reconspider#reconspider-full-wiki-and-how-to-guide)\n12. [Updates](https://github.com/bhavsec/reconspider#frequent--seamless-updates)\n\n\n# Version (beta)\n\n  \tReconSpider   :     1.0.7\n\n\n# Overview of the tool:\n\n* Performs OSINT scan on a IP Address, Emails, Websites, Organizations and find out information from different sources.\n* Correlates and collaborate the results, show them in a consolidated manner.\n* Use specific script / launch automated OSINT for consolidated data.\n* Currently available in only Command Line Interface (CLI).\n\n\n# Mind Map (v1)\n\nCheck out our mind map to see visually organize information of this tool regarding api, services and techniques and more.\n\nhttps://bhavsec.com/img/reconspider_map.png\n\n\n\n# License Information\n```\nReconSpider and its documents are covered under GPL-3.0 (General Public License v3.0)\n```\n\n\n\n## ReconSpider Banner\n\n```\n__________                               _________       __     ___            \n\\______   \\ ____   ____  ____   ____    /   _____/_____ |__| __| _/___________\n |       _// __ \\_/ ___\\/  _ \\ /    \\   \\_____  \\\\____ \\|  |/ __ |/ __ \\_  __ \\\n |    |   \\  ___/\\  \\__(  \u003c_\u003e )   |  \\  /        \\  |_\u003e \u003e  / /_/ \\  ___/|  | \\/\n |____|_  /\\___  \u003e\\___  \u003e____/|___|  / /_______  /   __/|__\\____ |\\___  \u003e__|   \n        \\/     \\/     \\/           \\/          \\/|__|           \\/    \\/       \n\n\n\nENTER 0 - 13 TO SELECT OPTIONS\n\n1.  IP                           Enumerate  information  from  IP Address\n2.  DOMAIN                       Gather  information  about  given DOMAIN\n3.  PHONENUMBER                  Gather  information  about   Phonenumber\n4.  DNS MAP                      Map DNS  records associated  with target\n5.  METADATA                     Extract all metadata of  the  given file\n6.  REVERSE IMAGE SEARCH         Obtain domain name or IP address mapping\n7.  HONEYPOT                     Check if it's honeypot or a real  system\n8.  MAC ADDRESS LOOKUP           Obtain information about give Macaddress\n9.  IPHEATMAP                    Draw  out  heatmap  of  locations  of IP\n10. TORRENT                      Gather torrent download  history  of  IP\n11. USERNAME                     Extract Account info. from social  media\n12. IP2PROXY                     Check whether  IP  uses  any VPN / PROXY\n13. MAIL BREACH                  Checks given domain  has  breached  Mail\n99. UPDATE                       Update ReconSpider to its latest version\n\n0. EXIT                         Exit from  ReconSpider  to your terminal\n```\n\n\n\n# Documentation\n\nInstalling and using ReconSpider is very easy. Installation process is very simple.\n\n1. Downloading or cloning ReconSpider github repository.\n2. Installing all dependencies.\n3. Setting up the Database.\n\nLet's Begin !!\n\n\n### Setting up the environment\n\nStep 1 - Cloning ReconSpider on your linux system.\n\nIn order to download ReconSpider simply clone the github repository. Below is the command which you can use in order to clone ReconSpider repository.\n```\ngit clone https://github.com/bhavsec/reconspider.git\n```\n\nStep 2 - Make sure python3 and python3-pip is installed on your system.\n\nYou can also perform a check by typing this command in your terminal.\n\n```\nsudo apt install python3 python3-pip\n```\n\nStep 3 - Installing all dependencies.\n\nOnce you clone and check python installation, you will find directory name as **reconspider**. Just go to that directory and install using these commands:\n```\ncd reconspider\nsudo python3 setup.py install\n```\n\nStep 4 - Setting up the Database.\n\n**IP2Proxy Database**\n\n```\nhttps://lite.ip2location.com/database/px8-ip-proxytype-country-region-city-isp-domain-usagetype-asn-lastseen\n```\nDownload database, extract it and move to `reconspider/plugins/` directory.\n\n\n# Updating API Keys\n\nAPIs included in ReconSpider are FREE and having limited \u0026 restricted usage per month, Please update the current APIs with New APIs in `setup.py` file, and re-install once done to reflect the changes.\n\n\u003e Warning: Not updating the APIs can result in not showing the expected output or it may show errors.\n\nYou need to create the account and get the API Keys from the following websites.\n\n* Shodan.io - https://developer.shodan.io/api\n* NumVerify - https://numverify.com/documentation\n* IP Stack - https://ipstack.com/documentation\n* Google Maps - https://developers.google.com/maps/documentation/places/web-service/get-api-key\n\n\n# Usage\n\n\nReconSpider is very handy tool and easy to use. All you have to do is just have to pass values to parameter.\nIn order to start ReconSpider just type:\n```\npython3 reconspider.py\n```\n\n**1. IP**\n\nThis option gathers all the information of given IP Address from public resources.\n```\nReconSpider \u003e\u003e 1\nIP \u003e\u003e 8.8.8.8\n```\n\n**2. DOMAIN**\n\nThis option gathers all the information of given URL Address and check for vulneribility.\n```\nReconspider \u003e\u003e 2\nHOST (URL / IP) \u003e\u003e vulnweb.com\nPORT \u003e\u003e 443\n```\n\n**3. PHONENUMBER**\n\nThis option allows you to gather information of given phonenumber.\n```\nReconspider \u003e\u003e 3\nPHONE NUMBER (919485247632) \u003e\u003e\n```\n\n**4. DNS MAP**\n\nThis option allows you to map an organizations attack surface with a virtual DNS Map of the DNS records associated with the target organization.\n```\nReconSpider \u003e\u003e 4\nDNS MAP (URL) \u003e\u003e vulnweb.com\n```\n\n**5. METADATA**\n\nThis option allows you to extract all metadat of the file.\n```\nReconspider \u003e\u003e 5\nMetadata (PATH) \u003e\u003e /root/Downloads/images.jpeg\n```\n\n**6. REVERSE IMAGE SEARCH**\n\nThis option allows you to obtain information and similar image that are available in internet.\n```\nReconspider \u003e\u003e 6\nREVERSE IMAGE SEARCH (PATH) \u003e\u003e /root/Downloads/images.jpeg\nOpen Search Result in web broser? (Y/N) : y\n```\n\n**7. HONEYPOT**\n\nThis option allows you to identify honeypots! The probability that an IP is a honeypot is captured in a \"Honeyscore\" value that can range from 0.0 to 1.0\n```\nReconSpider \u003e\u003e 7\nHONEYPOT (IP) \u003e\u003e 1.1.1.1\n```\n\n**8. MAC ADDRESS LOOKUP**\n\nThis option allows you to identify Mac address details who is manufacturer, address, country, etc.\n\n```\nReconspider \u003e\u003e 8\nMAC ADDRESS LOOKUP (Eg:08:00:69:02:01:FC) \u003e\u003e\n```\n\n**9. IPHEATMAP**\n\nThis option provided you heatmap of the provided ip or single ip, if connect all the provided ip location with accurate Coordinator.\n```\nReconspider \u003e\u003e 9\n\n    1) Trace single IP\n    2) Trace multiple IPs\nOPTIONS \u003e\u003e\n```\n\n**10. TORRENT**\n\nThis option allows you to gathers history of Torrent download history.\n```\nReconspider \u003e\u003e 10\nIPADDRESS (Eg:192.168.1.1) \u003e\u003e\n```\n\n**11. USERNAME**\n\nThis option allows you to gathers account information of the provided username from social media like Instagram, Twitter, Facebook.\n```\nReconspider \u003e\u003e 11\n\n1.Facebook\n2.Twitter\n3.Instagram\n\nUsername \u003e\u003e\n```\n\n**12. IP2PROXY**\n\nThis option allows you to identify whether IP address uses any kind of VPN / Proxy to hide his identify.\n```\nReconspider \u003e\u003e 12\nIPADDRESS (Eg:192.168.1.1) \u003e\u003e\n```\n\n**13. MAIL BREACH**\n\nThis option allows you to identify all breached mail ID from given domain.\n```\nReconspider \u003e\u003e 13\nDOMAIN (Eg:intercom.io) \u003e\u003e\n```\n\n**99. UPDATE**\n\nThis option allows you to check for updates. If a newer version will available, ReconSpider will download and merge the updates into the current directory without overwriting other files.\n```\nReconSpider \u003e\u003e 99\nChecking for updates..\n```\n\n**0. EXIT**\n\nThis option allows you to exit from ReconSpider Framework to your current Operating System's terminal.\n```\nReconSpider \u003e\u003e 0\nBye, See ya again..\n```\n\n\n\n# Contact Developer\n\nDo you want to have a conversation in private?\n\n    Twitter:            @bhavsec\n    Facebook:           fb.com/bhavsec\n    Instagram:          instagram.com/bhavsec\n    LinkedIn:           linkedin.com/in/bhavsec\n    Email:              bhavsec@gmail.com\n    Website:            bhavsec.com\n\n\n\n# ReconSpider Full Wiki and How-to Guide\n\nPlease go through the [ReconSpider Wiki Guide](https://github.com/bhavsec/reconspider/wiki) for a detailed explanation of each and every option and feature.\n\n\n# Frequent \u0026 Seamless Updates\nReconSpider is under development and updates for fixing bugs. optimizing performance \u0026 new features are being rolled. Custom error handling is also not implemented, and all the focus is to create required functionality.\n\n\n# Special Thanks \u0026 Contributors\n\n* [Aravindha](https://github.com/Aravindha1234u)\n* [Ishan Batish](https://www.linkedin.com/in/ishanbatish/)\n* [Adithyan AK](https://github.com/adithyan-ak)\n* [S0md3v](https://github.com/s0md3v/)\n* [Parshant](mailto:parshant.dhall@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhavsec%2Freconspider","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbhavsec%2Freconspider","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhavsec%2Freconspider/lists"}