KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #dsh-plugin #ai-agent #mcp #deepseek-harness #windows #open-source

xssrecon

★ 54 Open GitHub ↗

XSSRecon automates the process of testing URL parameters for reflection of a test payload rix4uni and further checks how special characters are handled (allowed, blocked, or converted).

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## XSSRecon - Automated Reflected XSS Parameter Discovery Tool

**XSSRecon** is a powerful tool designed to help security researchers and penetration testers identify reflected XSS vulnerabilities in web applications.
It automates the process of testing URL parameters for reflection of a test payload (`rix4uni`), and further checks how special characters are handled (allowed, blocked, or converted).

### 🚀 Features:

* **Dual Detection Method**: Detects if input is reflected in both HTTP response body and rendered DOM
* **DOM Checking**: Automatically checks JavaScript-rendered content using headless Chrome (chromedp) with configurable concurrency and timeout
* **Smart Optimization**: Skips HTML checks for special characters when base URL is only found in DOM
* **Custom Special Characters**: Test custom special characters with `--checkspecialchar` flag (inline or from .txt file)
* **First Match Optimization**: Stops checking special characters after finding the first allowed character for faster scanning
* **Concurrent Processing**: Process multiple URLs in parallel with configurable worker pool (default: 50)
* **ChromeDP Concurrency Control**: Limit concurrent ChromeDP browser instances to manage resource usage (default: 5)
* **Special Character Testing**: Tests special characters for allowed, blocked, or converted behavior
* **Flexible Output**: Supports compact JSON output, colorized or plain text single-line format, silent and verbose modes
* **Parameter Injection**: Uses external `pvreplace` tool for precise parameter injection
* **ChromeDP Control**: Disable DOM checking entirely with `--no-chromedp` flag for faster execution when only HTML checking is needed

## Prerequisites

* **pvreplace**: Required for parameter injection
  ```
  go install github.com/rix4uni/pvreplace@latest
  ```

* **Chrome/Chromium**: Required for DOM checking (automatically used when HTML check fails)
  - Chrome or Chromium must be installed on your system
  - The tool will automatically use it for DOM-based reflection detection

## Installation

```
go install github.com/rix4uni/xssrecon@latest
```

## Download prebuilt binaries

```
wget https://github.com/rix4uni/xssrecon/releases/download/v0.0.5/xssrecon-linux-amd64-0.0.5.tgz
tar -xvzf xssrecon-linux-amd64-0.0.5.tgz
rm -rf xssrecon-linux-amd64-0.0.5.tgz
mv xssrecon ~/go/bin/xssrecon
```

Or download [binary release](https://github.com/rix4uni/xssrecon/releases) for your platform.

## Compile from source

```
git clone --depth 1 https://github.com/rix4uni/xssrecon.git
cd xssrecon; go install
```

## Usage

```yaml
Usage of xssrecon:
  -c, --concurrent int           Number of concurrent workers for processing URLs (default: 50)
  -H, --user-agent string        Custom User-Agent header for HTTP requests. (default "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0.0.0 Safari/537.36")
  -s, --skipspecialchar          Only check rix4uni in response and move to next url, skip checking special characters.
  -t, --timeout int              Timeout for HTTP requests in seconds. (default 15)
      --checkspecialchar string  Custom special characters to test (inline or .txt file, e.g., "'><script>" or "tags.txt"). Cannot be used with --skipspecialchar.
      --chromedp-concurrent int  Number of concurrent ChromeDP browser instances (default 5)
      --chromedp-timeout int     ChromeDP page rendering timeout in seconds (default 30)
      --no-chromedp              Disable ChromeDP fallback
      --json                     Output results in compact JSON format.
      --no-color                 Do not use colored output.
      --silent                   silent mode.
      --verbose                  Enable verbose output for debugging purposes.
      --version                  Print the version of the tool and exit.
```

## Usage Examples

### Single URL:
```yaml
echo "https://labs.hackxpert.com/RXSS/GET/01.php?fname=rat" | xssrecon
```

### Multiple URLs with concurrent processing:
```yaml
cat urls.txt | xssrecon --concurrent 20
```

### Custom special characters (inline):
```yaml
cat urls.txt | xssrecon --checkspecialchar "'><script>"
```

### Custom special characters (from file):
```yaml
# Create tags.txt with one tag per line:
# <script>
# <Script>
# </script>
cat urls.txt | xssrecon --checkspecialchar tags.txt
```

### Verbose mode (shows DOM checking):
```yaml
echo "https://summer.harvard.edu/search/?live_global%5Bquery%5D=rix4uni" | xssrecon --verbose
```

### Silent mode with JSON output:
```yaml
cat urls.txt | xssrecon --silent --json
```

### Skip special character checks (faster):
```yaml
cat urls.txt | xssrecon --silent --skipspecialchar --json
```

### Disable ChromeDP DOM checking (faster, HTML only):
```yaml
cat urls.txt | xssrecon --no-chromedp
```

### Configure ChromeDP concurrency and timeout:
```yaml
cat urls.txt | xssrecon --chromedp-concurrent 10 --chromedp-timeout 60
```

## Output Examples

### Standard Output (Single-line format):
```yaml
https://labs.hackxpert.com/RXSS/GET/01.php?fname=rat [REFLECTED: YES] [ALLOWED: ' " < > ( ) ` { } / \ ;] [BLOCKED: ] [CONVERTED: ]
```

### Verbose Output (DOM detection):
```yaml
Not found in HTML, checking DOM...
CHECKING: https://summer.harvard.edu/search/?live_global%5Bquery%5D=rix4uni'
CHECKING: https://summer.harvard.edu/search/?live_global%5Bquery%5D=rix4uni"
...
https://summer.harvard.edu/search/?live_global%5Bquery%5D=rix4uni [REFLECTED: YES] [ALLOWED: ' " ( ) ` { } / \ ;] [BLOCKED: ] [CONVERTED: < ➔ &lt; > ➔ &gt;]
```

### Compact JSON Output:
```json
{"baseurl":"https://labs.hackxpert.com/RXSS/GET/01.php?fname=rat","reflected":true,"allowed":["'","\"","<",">","(",")","`","{","}","/","\\",";"],"blocked":[],"converted":[],"count":{"allowed":12,"blocked":0,"converted":0}}
```

### Filtering with jq:
```yaml
# Get only reflected URLs
cat urls.txt | xssrecon --silent --skipspecialchar --json | jq -r 'select(.reflected==true) | .baseurl'

# Get URLs with all special characters allowed
cat urls.txt | xssrecon --silent --json | jq -r 'select(.reflected==true) | select(.count.allowed==12) | .baseurl'
```

## How It Works

1. **Parameter Injection**: Uses `pvreplace` to inject the test payload `rix4uni` into URL parameters
2. **HTML Check**: First checks if the payload is reflected in the raw HTTP response body
3. **DOM Check**: If not found in HTML (and `--no-chromedp` is not set), automatically checks the rendered DOM using headless Chrome with configurable concurrency and timeout
4. **Special Character Testing**: Tests each special character to determine if it's allowed, blocked, or converted
5. **Optimization**: If base URL is only found in DOM, skips HTML checks for special characters (faster execution)
6. **Concurrent Processing**: Processes multiple URLs in parallel using a worker pool (configurable with `--concurrent`)
7. **ChromeDP Concurrency Control**: ChromeDP operations are limited by `--chromedp-concurrent` to prevent resource exhaustion

## Notes

* DOM checking requires Chrome/Chromium to be installed on your system
* If Chrome is not available, DOM checking will fail gracefully and only HTML checking will be performed
* The `--concurrent` flag controls how many URLs are processed simultaneously (default: 50)
* The `--chromedp-concurrent` flag controls how many ChromeDP browser instances run concurrently (default: 5)
* Use `--no-chromedp` to disable DOM checking entirely for faster execution when only HTML checking is needed
* Use `--chromedp-timeout` to adjust the timeout for ChromeDP page rendering (default: 30 seconds)
* Use `--checkspecialchar` to test specific characters inline (e.g., "'><script>") or from a .txt file (e.g., tags.txt)
* The tool automatically detects .txt files and reads each line as a separate special character/string to test
* Special character checking stops after finding the first allowed character for faster scanning
* `--checkspecialchar` and `--skipspecialchar` cannot be used together
* The default HTTP request timeout is 15 seconds (configurable with `-t` or `--timeout`)
* Output is now in single-line format for better readability and parsing
* JSON output is compact (single line) instead of pretty-printed for easier processing

xssrecon

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README