sub

subquest

Fast, Elegant subdomain scanner using nodejs

Showing:

Popularity

Downloads/wk

74

GitHub Stars

24

Maintenance

Last Commit

2yrs ago

Contributors

5

Package

Dependencies

5

Size (min+gzip)

314.9KB

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

subquest-logo

fast and elegant subdomain scanner built with node

Installation

To use subquest in your node scripts you have to install it and add it to your project dependencies:

npm install --save subquest

Than you can require it in your script and use it, following examples below.

After v1.5.0

After the version 1.5.0 the module doesn't use event emitters, just callbacks,

const subquest = require('subquest')

subquest.getSubDomains({
  host: 'google.com'
}, (err, results) => {

  if(err) {
    console.log('Error:', err);
    return;
  }

  console.log('Subdomains:', results);  
})

Before v1.5.0

Before the version 1.5.0 the module makes use of event emitters to determine when it's done.

var subquest = require('subquest');

subquest
  .getSubDomains({
    host: 'google.com', // required
    rateLimit:'4', // four requests at time
    dnsServer:'4.2.2.2', // custom DNS server
    dictionary: 'top_200' // dictionary file to use
  })
  .on('end', function(res){
    console.log(res); // array of subdomains.
  })

This scans google.com for the list of all subdomains using the top_200 dictionary.

Methods

isValidDnsServer(server, [timeout], callback)

Test if a given address is valid DNS server

getResolvers([domain], callback)

Get the list of all the resolvers (DNS Servers) used in the scan, both default and custom

getDictionaryNames()

Get the list of the dictionary files used in the scan

getSubDomains(options, callback)

Run the scan against the domain to enumerate all subdomains

Looking for the cli version?

You can use subquest as a command line tool by cloning the official repository or using npm:

$ npm install -g subquest-cli

Want to add a new entry to Subquest's dictionary?

Add your list of subdomain names to the ./dictionary/all.txt file and send a pull request.

Contributing

  1. Create an issue and describe your idea
  2. Fork the project (https://github.com/skepticfx/subquest/fork)
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Publish the branch (git push origin my-new-feature)
  6. Create a new Pull Request

Credits

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100