{"id":20706695,"url":"https://github.com/censys/censys-recon-ng","last_synced_at":"2025-06-11T13:12:48.228Z","repository":{"id":51091452,"uuid":"182835857","full_name":"censys/censys-recon-ng","owner":"censys","description":"recon-ng modules for Censys","archived":false,"fork":false,"pushed_at":"2023-10-23T19:07:16.000Z","size":69,"stargazers_count":37,"open_issues_count":2,"forks_count":15,"subscribers_count":22,"default_branch":"main","last_synced_at":"2025-04-22T14:57:39.554Z","etag":null,"topics":["censys-api","cybersecurity","osint","osint-reconnaissance","osinttool","penetration-testing","pentesting","python","recon-ng","recon-ng-modules","threat-hunting","threat-intelligence","threatintel"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/censys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2019-04-22T17:31:54.000Z","updated_at":"2025-03-07T11:16:04.000Z","dependencies_parsed_at":"2024-11-17T02:15:55.576Z","dependency_job_id":null,"html_url":"https://github.com/censys/censys-recon-ng","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcensys-recon-ng","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcensys-recon-ng/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcensys-recon-ng/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcensys-recon-ng/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/censys","download_url":"https://codeload.github.com/censys/censys-recon-ng/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/censys%2Fcensys-recon-ng/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259271879,"owners_count":22832100,"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":["censys-api","cybersecurity","osint","osint-reconnaissance","osinttool","penetration-testing","pentesting","python","recon-ng","recon-ng-modules","threat-hunting","threat-intelligence","threatintel"],"created_at":"2024-11-17T01:23:52.167Z","updated_at":"2025-06-11T13:12:48.199Z","avatar_url":"https://github.com/censys.png","language":"Python","funding_links":[],"categories":["Integrations and plugins"],"sub_categories":[],"readme":"# Censys `recon-ng` Modules\n\n[![License](https://img.shields.io/github/license/censys/censys-recon-ng)](LICENSE)\n[![Code Style](https://img.shields.io/badge/code%20style-black-000000)](https://github.com/psf/black)\n[![Code Style](https://img.shields.io/badge/code%20style-pycodestyle-blue)](https://github.com/PyCQA/pycodestyle)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)\n\nWe have written several modules for [`recon-ng`](https://github.com/lanmaster53/recon-ng) adding data via the Censys API. These were inspired by the work that [@scumsec](https://github.com/scumsec/Recon-ng-modules) did on the original recon-ng additions from their add-on modules, and also from the subdomain enumeration techniques that use Censys data like from [@christophetd](https://github.com/christophetd/censys-subdomain-finder).\n\n## Installation\n\nWe have provided two pieces you need to install these modules and begin using them.\n\n- `requirements.txt` - Use this via `pip install -r requirements.txt` to install Python dependencies.\n- `install.sh`- Run this script and it will both install the modules in your home directory (recon-ng supports modules added for the local user in `~/.recon-ng`) and configures the database to add support for your Censys API ID and secret. See your Censys [account](https://search.censys.io/account/api) for your credentials, and add them to the database as you would any other credential - `keys add ...`.\n\nOne you have completed these you can fire up `recon-ng`.\n\nConfigure your Censys API ID and secret variables using `keys add` to `censysio_id` and `censysio_secret`.\n\n## Usage\n\nThese are normal recon-ng modules, use them like any other. Pivot away! This repository adds the following new modules:\n\n```recon-ng\n[recon-ng][default] \u003e modules search censys\n[*] Searching for 'censys'...\n\n  Recon\n  -----\n    recon/companies-contacts/censys_email_address\n    recon/companies-domains/censys_subdomains\n    recon/companies-multi/censys_org\n    recon/companies-multi/censys_tls_subjects\n    recon/contacts-domains/censys_email_to_domains\n    recon/domains-companies/censys_companies\n    recon/domains-hosts/censys_domain\n    recon/hosts-hosts/censys_query\n    recon/hosts-ports/censys_hostname\n    recon/hosts-ports/censys_ip\n    recon/netblocks-companies/censys_netblock_company\n    recon/netblocks-hosts/censys_netblock\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcensys%2Fcensys-recon-ng","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcensys%2Fcensys-recon-ng","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcensys%2Fcensys-recon-ng/lists"}