Skip to main content

HumanoidProbe is a command-line XSS WAF intelligence tool that probes how a WAF responds to payload variations — telling you what gets blocked, what passes through, and what gets reflected back.

Project description

HumanoidProbe

by CyberSafeLabs

Analyse WAF behaviour. Think like an attacker.

HumanoidProbe is a command-line XSS WAF intelligence tool that probes how a WAF responds to payload variations — telling you what gets blocked, what passes through, and what gets reflected back.

Built from real bug bounty research. Not theory.


What it does

  • Fires categorised XSS payload variations at a target URL and parameter
  • Detects WAF blocks via status codes, response body analysis, and response length changes
  • Identifies reflected payloads — the highest value findings
  • Summarises WAF behaviour and what it appears to be filtering
  • Gives you actionable intelligence to craft smarter bypass payloads

Installation

1. Make sure Python 3 is installed

python3 --version

If not:

sudo apt update && sudo apt install python3 python3-pip -y

2. Install the dependency

pip3 install requests

Usage

python3 humanoidprobe.py -u <URL> -p <parameter>

Example:

python3 humanoidprobe.py -u https://example.com/search -p q

With options:

python3 humanoidprobe.py -u https://example.com/search -p q --delay 1 --timeout 15

Options

Flag Description Default
-u / --url Target URL Required
-p / --parameter GET parameter to test Required
--payloads Custom payload file path payloads/xss.txt
--delay Seconds between requests 0.5
--timeout Request timeout in seconds 10

Output verdicts

Verdict Meaning
REFLECTED Payload passed AND appeared in the response — investigate in browser immediately
PASSED WAF did not block — worth exploring further
BLOCKED WAF caught this payload
ERROR Request failed (timeout, connection error)

Project structure

humanoidprobe/
├── humanoidprobe.py    # Main entry point — what you run
├── payloads/
│   └── xss.txt         # XSS payload list
├── core/
│   ├── requester.py    # Sends HTTP requests
│   ├── detector.py     # Analyses responses (blocked vs passed)
│   └── reporter.py     # Terminal output and summary
└── README.md

Roadmap

  • WAF memory — builds a profile of WAF behaviour across sessions
  • Intelligent bypass suggestions — generates mutations based on what passed
  • POST parameter support
  • SQLi payload module
  • Output to file (JSON / txt)
  • Burp Suite integration
  • Full recon and attack surface mapping modules
  • Humanoid Intelligence — AI layer (coming in future versions)

Legal & ethical use

Only use HumanoidProbe against targets you have explicit permission to test. Unauthorised testing is illegal. This tool is built for legitimate security research and bug bounty programmes only.


About

HumanoidProbe is the first tool from CyberSafeLabs — an independent cybersecurity research initiative focused on protecting digital assets through offensive research, vulnerability discovery, and practical security tooling.

The long-term vision: Humanoid Intelligence — an AI-powered security research platform built from real hunting experience.

CyberSafeLabs — protecting digital assets through research

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

humanoidprobe-1.0.11.tar.gz (13.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

humanoidprobe-1.0.11-py3-none-any.whl (14.3 kB view details)

Uploaded Python 3

File details

Details for the file humanoidprobe-1.0.11.tar.gz.

File metadata

  • Download URL: humanoidprobe-1.0.11.tar.gz
  • Upload date:
  • Size: 13.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for humanoidprobe-1.0.11.tar.gz
Algorithm Hash digest
SHA256 e1836d13327980c05bf790e6ed64837228723dfab32e4dd9f9ffd107f29b9550
MD5 9e9dff54d1b0aaa9c430df3ebf1b76ba
BLAKE2b-256 11493c0a5ba071f064851003b02108426981087a982d58519f63a9d4b5a113d4

See more details on using hashes here.

File details

Details for the file humanoidprobe-1.0.11-py3-none-any.whl.

File metadata

  • Download URL: humanoidprobe-1.0.11-py3-none-any.whl
  • Upload date:
  • Size: 14.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.12

File hashes

Hashes for humanoidprobe-1.0.11-py3-none-any.whl
Algorithm Hash digest
SHA256 4dd22b9891c764909594150ddcb7f55bb2ad0694025c95db5b50a8a65917f5a0
MD5 dde034adc7c41ec9d14c2b670d7814a8
BLAKE2b-256 dd532ecf66b449220452c982a7916239aa5fc846b47f960e360f0aff1d3b1571

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page