Skip to content
A better version of my xssfinder tool - scans for different types of xss on a list of urls.
Branch: master
Clone or download
Latest commit aacd608 Aug 3, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
config init Mar 2, 2019
inc Fixed a typo. Aug 3, 2019
logs init Mar 2, 2019
.gitignore init Mar 2, 2019 update readme Aug 2, 2019 added new config to example file Mar 6, 2019 init Mar 2, 2019

Extended XSS Searcher and Finder

This is the extended version based on the initial idea already published as "xssfinder". This private version allows an attacker to perform not only GET but also POST requests. Additionally its possible to proxy every request through Burp or another tunnel.

First steps

Rename the to app-settings.conf and adjust the settings. It should work out of the box but depending on the target I would recommend to resize the chunk sizes.


This tool does not expect any arguments via CLI, so just type:



Its possible to set a lot of options and settings, so here are some explanations.


The main config file is the "app-settings.conf", everything has to be done in that file! Besides that, there are some other files which allow to set more complex data like headers, urls and cookies.


Use this file to add a cookie string. I usually copy the one which you can see in every burp request. Please just copy the value of the "Cookie:"-header. A sample input is in the default file.


This file defines the http headers which are added to the request and manipulated (payload is added to each one). The most important ones are already in the file. But feel free to add more.


The tool has the option to brute force get and post parameters. In that case those parameters (+ those in the query string) will be used. Each parameter gets the payload as value. Most important are already in that file.


Thats the file you need! Please add here your links to scan. The following formats are allowed:

When the last case is detected an "http://" is prepended. This tool is intended to work with a good list of urls. A good way to get one is to just export it using burp. Then you have a valid list of urls. All you need to do ist to just add your cookies.


This is the log folder where everything gets logged to!


The app-settings.conf defined the program workflow. Its the most important file, you can activate/deactive different modules there.

Basic settings


Some requests can take long. Here you can define the max. execution time of one request. I recommend values between 2 and 6 seconds.


The more threads, the faster the script is - but since we are dealing with a lot of connections I usually keep this below 10 on my personal computer and arround 30 on my VPS.

Attack types


Setting this to true will result in only "base requests" - this means the url lists is just spidered and interesting parameters extracted. You could use that to fill you burp sitemap quickly.


Use can skip POST requests setting this to "false"


This is similar - skip GET requests if set to "false"

Attack type settings


How many GET parameters to test with one request?


How many POST parameters to test with one request?


Its also possible to use a tunnel, e.g. "" (Burp Proxy), to monitor all traffic within Burp.


Setting this to "true" will force the script to use a tunneled connection.


Set here your proxy server "ip:port".

The result is the following one, when you open Burp you can watch your http history:





Feature requests

Please just create an issue and tag it as a feature request.


Do you like that tool? Did it help you to get a bounty? Want to give something back/support me? Why not!

Donate via PayPal: CLICK

You can’t perform that action at this time.