Need help with xsshunter_client?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

187 Stars 46 Forks 8 Commits 11 Opened issues


Correlated injection proxy tool for XSS Hunter

Services available


Need anything else?

Contributors list

# 91,884
6 commits

XSS Hunter Client

What is the this tool for?

This tool can be used to generate correlated XSS payloads, these payloads are tagged with a unique ID which can be used to track which HTTP request caused which XSS payload to fire. By using this tool all of your injection attempts are tracked and the reports you generate will have the responsible injection attempt included in the final output. This is useful since XSS payloads can often traverse multiple services (and even protocols) before firing, so it's not always clear what injection caused a certain XSS payload to fire.


  1. Create an XSS Hunter account at
  2. Create a new virtual environment by running
    virtualenv env
  3. Source the newly created enviroment by running
    source env/bin/activate
  4. Install the required libraries by running
    pip install -r requirements.txt
  5. Run the config generation tool
    and follow the steps mentioned.
  6. Now run mitmproxy with this client as an inline script:
    mitmproxy -s -p 1234
  7. Proxy your browser through this new tool, keep in mind that you may have to install the mitmproxy certificate authority if you have not done so already.

Using the XSS Hunter Client

Using the client is simple, during the config generation you will set a list of dummy words, these are special strings which will be replaced upon being seen by the proxy tool. For example, one rule could have the dummy word be
with the
URI payload selected. Once the proxy sees
in the request it will automatically replace it with the
URI payload. It is very important that you choose a unique dummy word that is unlikely to appear regularly in the request, else you risk scattering your payloads where you don't want them.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.