Have ideas to improve npm?Join in the discussion! »

    subquest

    1.5.3 • Public • Published

    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

    Install

    npm i subquest

    DownloadsWeekly Downloads

    76

    Version

    1.5.3

    License

    MIT

    Last publish

    Collaborators

    • avatar
    • avatar