offensive-tools/api/kiterunner/SKILL.md
Context-aware API route discovery and brute-forcing using real-world API schema wordlists. Use when enumerating API endpoints, discovering hidden routes on REST/gRPC services, or replacing dirbusting for API surfaces.
npx skillsauth add aeondave/malskill kiterunnerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Context-aware API route brute-forcer using real-world API schema wordlists (Assetnote).
# Download binary from https://github.com/assetnote/kiterunner/releases
# Scan with default wordlist
kr scan https://target.com -w routes-small.kite
# Scan from file of hosts
kr scan hosts.txt -w routes-large.kite -x 20
# Replay a finding with full request detail
kr replay -w routes-small.kite "GET 403 [ 191, 9, 1] https://target.com/api/v1/user"
| Flag | Purpose |
|------|---------|
| -w FILE | Kite wordlist (.kite or .txt) |
| -x N | Concurrent requests |
| --ignore-length N | Filter by response length |
| -H "K:V" | Custom header |
| -A "bearer:TOKEN" | Auth header shorthand |
| --fail-status-codes | Codes treated as failures |
| --success-status-codes | Codes treated as hits |
| -o json | JSON output |
| --delay N | Per-request delay (ms) |
Authenticated API scan:
kr scan https://api.target.com -w routes-large.kite -A "bearer:$TOKEN" -x 30
Filter noise — ignore typical 404/400 lengths:
kr scan https://api.target.com -w routes-small.kite --ignore-length 19
Replay to inspect full response:
kr replay -w routes-large.kite "POST 200 [ 512, 10, 2] https://api.target.com/api/v2/admin"
| File | When to load |
|------|--------------|
| references/ | Wordlist sources and API fingerprinting notes |
development
Auth/lab ref: Unicorn Engine CPU-only emulation for shellcode, decryptors, custom VM handlers, instruction tracing, memory hooks, and register-level experiments.
development
Auth/lab ref: Renode board and SoC simulation for MCU/RTOS firmware, UART/GPIO/peripheral modeling, GDB remote debugging, REPL platforms, and RESC scripts.
development
Auth/lab ref: Qiling OS-layer binary emulation for PE/ELF/Mach-O/UEFI/shellcode with rootfs, syscall/API hooks, filesystem mapping, and runtime patching.
databases
Auth/lab ref: QEMU user-mode and full-system emulation for cross-arch binaries, firmware, kernels, disks, serial consoles, networking, and GDB stubs.