BugReaper

Skill AI strutturata per il bug bounty web2 — 18 classi di vulnerabilità, 4 piattaforme bug bounty, zero AI slop. Compatibile con OpenClaw, Cursor, Claude Code, Antigravity e Windsurf.

BugReaper è una Agent Skill che trasforma qualsiasi agente AI compatibile in un disciplinato cacciatore di bug bounty web2. Impone una validazione basata sulle evidenze, simula un triage reale per HackerOne, Bugcrowd, Intigriti e YesWeHack e concatena bug a bassa severità in finding critici. Ogni finding richiede una PoC funzionante prima di essere segnalato.

Compatibilità con gli agenti

Il formato Agent Skills è diventato uno standard aperto nel dicembre 2025. BugReaper si installa in tutti gli agenti compatibili senza modifiche.

Cosa contiene

bug-reaper/
├── SKILL.md                     # Agent trigger + 4-phase workflow
├── references/
│   ├── recon.md                 # 7-phase recon methodology
│   ├── audit-rules.md           # Strict evidence requirements
│   ├── exploit-validation.md    # Input → sink tracing
│   ├── false-positive-elimination.md  # Adversarial FP checklist
│   ├── severity-guide.md        # CVSS scoring + platform tier map
│   ├── waf-bypass.md            # 15 WAF products, 10 bypass techniques
│   ├── chaining.md              # 8 chain templates (P3 → P1 escalation)
│   ├── platforms/               # HackerOne · Bugcrowd · Intigriti · YesWeHack
│   └── vulnerabilities/         # 18 hunting methodology files
└── scripts/
    ├── analyze_scope.py         # Parse program scope → structured JSON
    └── generate_report.py       # Generate platform-specific Markdown reports

18 metodologie di vulnerabilità — ciascuna con payload di conferma, tecniche di bypass, requisiti di evidenza e regole "da non segnalare" che riflettono i reali pattern di triage.

Installazione

OpenClaw / ClawHub

/install bug-reaper

Oppure cerca bug-reaper su ClawHub.

Cursor, Claude Code, Antigravity, Windsurf

# From your project root
git clone https://github.com/shaniidev/bug-reaper .cursor/skills/bug-reaper     # Cursor
git clone https://github.com/shaniidev/bug-reaper .claude/skills/bug-reaper     # Claude Code
git clone https://github.com/shaniidev/bug-reaper .agents/skills/bug-reaper     # Antigravity

La skill si attiva automaticamente quando menzioni bug bounty, pentest, find vulnerabilities o il nome di qualsiasi classe di vulnerabilità nella conversazione con il tuo agente.

Come funziona

Fase 1 — RECON (references/recon.md) Enumerazione passiva dei sottodomini, fingerprinting tecnologico, analisi dei bundle JS, scoperta di endpoint, mappatura della superficie d'attacco. Sette passaggi strutturati prima di toccare un singolo payload.

Fase 2 — AUDIT (references/vulnerabilities/) 18 classi di vulnerabilità ordinate per ROI del bounty. Legge il file di metodologia pertinente per ogni classe — payload di conferma, tecniche di bypass e quali difese verificare prima di dichiarare la sfruttabilità.

Fase 3 — VALIDATE (references/exploit-validation.md + references/false-positive-elimination.md) Traccia l'input controllato dall'attaccante dal punto di ingresso fino al sink pericoloso. Applica una checklist avversariale che cerca attivamente di confutare ogni finding prima che venga segnalato. I finding restano Teorici finché non viene fornito un vero output PoC.

Fase 4 — REPORT (references/platforms/ + scripts/generate_report.py) Genera un report appropriato per la piattaforma. Checklist di triage, punteggio di gravità e template del report corrispondono ai criteri di accettazione reali della piattaforma target.

Copertura delle vulnerabilità

Ogni file include: sonde di rilevamento · payload di conferma · tecniche di bypass delle difese · requisiti di evidenza · classificazione dell'impatto · regole "da non segnalare".

Script

Analizza un file di scope del programma:

python scripts/analyze_scope.py hackerone_program.md --output scope.json

Genera un report di vulnerabilità specifico per la piattaforma:

python scripts/generate_report.py \
  --platform hackerone \
  --vuln-type idor \
  --input finding.json \
  --output report.md

Piattaforme supportate: hackerone · bugcrowd · intigriti · yeswehack
Tipi di vulnerabilità supportati: xss · sqli · nosqli · ssrf · idor · auth · biz-logic · cors · csrf · rce · ssti · lfi · · · · · ·

Esempio di output di un finding

Quando BugReaper individua una vulnerabilità, utilizza questa struttura:

Title: IDOR on Order History — Any User's Orders Accessible
Severity: High
Confidence: Confirmed
Attack Prerequisites: Authenticated user (any account)
Vulnerable Endpoint: GET /api/v2/orders/{order_id}
Attack Path:
  1. Authenticate as User A, place an order → note order_id
  2. Authenticate as User B
  3. Request GET /api/v2/orders/<User_A_order_id>
  4. Full order details returned — items, address, payment summary
Why This Is Exploitable: No ownership check on the orders endpoint. The
  backend retrieves the order by ID alone with no session validation.
Realistic Impact: Any authenticated user reads another user's full order
  history including shipping address and last 4 card digits.
PoC Request:
  GET /api/v2/orders/10482 HTTP/1.1
  Authorization: Bearer <User_B_token>
Suggested Verification: Run the above request. Confirm order 10482 belongs
  to a different account than the token.
Recommended Fix: Validate req.user.id === order.userId before returning.

Contributi

PR benvenute — supporto per piattaforme aggiuntive, nuove classi di vulnerabilità, tecniche di bypass aggiornate o checklist di triage migliorate. Apri prima un issue per modifiche significative.

Licenza

MIT © 2026 shaniidev