Skip to main content
Glama

YeepForge Agent

Der KI-Penetrationstester, der arbeitet, während du schläfst

capture0x - powered by tmrswrr

Agent OWASP SAST Python Ollama License

Gib ihm eine URL. Gib ihm Quellcode. Schau zu, wie er hackt.


Was macht YeepForge anders?

Die meisten Security-Tools sind Menüs mit Befehlen, die du manuell ausführst.

YeepForge Agent ist anders. Er ist eine KI, die wie ein Penetrationstester denkt – er liest das Ziel, entscheidet, was als Nächstes angegriffen wird, verwebt Erkenntnisse miteinander und liefert einen professionellen, mit CVSS bewerteten Report. Du gibst eine URL an. Den Rest erledigt der Agent.

./run.sh --target https://your-target.com
# Select [33] YeepForge Agent → [1] Autonomous Pentest
# Go grab coffee.

Der Agent

Wie er denkt

Der Agent führt keine Tools zufällig aus. Nach jedem Ergebnis analysiert er, was er gefunden hat, und entscheidet, was der intelligenteste nächste Schritt ist:

[ROUND 1] recon_target       → Apache/2.4 + PHP/7.4 + login form detected
             ↓ context: login found
[ROUND 2] test_authentication → Tries default creds: admin:admin → FAILED
             ↓ context: PHP app, has .git?
[ROUND 3] find_sensitive_files→ /.git/config exposed! (Critical)
             ↓ context: /.git exposed = source code leak
[ROUND 4] analyze_source_code → SAST: 3 SQL injections, 2 XSS in source code
             ↓ context: SQLi in /login confirmed in code
[ROUND 5] test_sql_injection  → Dynamic confirm: error-based SQLi at /login
[ROUND 6] report_finding      → CVSS 9.8 - Critical SQL Injection recorded
...
[ROUND N] finish_assessment   → HTML + JSON report generated

Ein Befehl. Vollständige Bewertung. Professioneller Report.


Agent-Intelligenz - kontextabhängige Entscheidungsfindung

Was der Agent entdeckt

Was er als Nächstes tut

Login-Formular auf einer Seite

→ Springt sofort zu test_authentication

WordPress / Drupal / Joomla

→ Setzt CMS-Schwachstellen-Scan auf höchste Priorität

SQL-Fehler in einer Antwort

→ Stuft test_sql_injection hoch

.git oder .env offengelegt

→ Stuft als „Critical" ein, gräbt tiefer

API-Endpunkte in JS-Dateien

→ Wechselt zu GraphQL/JSON-Verzeichnisscan

WAF blockiert Anfragen

→ Aktiviert WAF-Bypass-Payloads

Quellcode bereitgestellt

→ Führt SAST vor den dynamischen Tests aus

SAST findet SQLi im Code

→ Bestätigt mit dynamischer test_sql_injection

PHP erkannt

→ Priorisiert Path-Traversal und File-Inclusion nbsp;


Agent-Modi

[1] Autonomous Pentest   - Full tool-use loop. Set target, press enter, get report.
[2] Interactive Chat     - Talk to the AI. Ask questions, get payloads, explore.
[3] Payload Generator    - "Give me 20 SQLi payloads for WAF bypass" → instant list.
[4] Code Analysis (SAST) - Point to source code → 14 AI skills scan every file.
[5] Set Source Code Path - Enable SAST for the autonomous mode.

Agent-Backends - kostenlos lokal oder Cloud

Backend

Kosten

Speed

Qualität

Aufsetzung

Ollama - mistral (Standard)

Kostenlos

Schnell

Exzellent

ollama pull mistral

Ollama - llama3.2:3b

Kostenlos

Schnellste

Gut

ollama pull llama3.2:3b

Ollama - qwen2.5-coder

Kostenlos

Mittel

Exzellent

ollama pull qwen2.5-coder

Claude API

Kostenpflichtig

Mittel

Hervor

ANTHROPIC_API_KEY=sk-ant-...

Es ist kein API-Key erforderlich. Sie läuft mit Ollama komplett offline.

# Free setup - works out of the box
ollama serve
ollama pull mistral
./run.sh  →  [33] Agent  →  [1] Autonomous Pentest

MCP-Server - YeepForge einsetzen in Claude Code / Cursor / Claude Desktop

YeepForge ist auch als MCP-Server verfügbar: Er legt alle 28 Scan-Tools (recon_target, crawl_target, test_sql_injection, nuclei_scan, … ) plus set_engagement über das Model Context Protocol dar, und ein Host, der bereits ein LLM besitzt, treibt das Engagement mit seiner eigenen Subscription – ohne ANTHROPIC_API_KEY und ohne lokales Modell auf der YeepForge-Seite. Der Host ist das Gehirn; YeepForge ist der Werkzeugkasten.

cd YeepForge && claude          # .mcp.json is auto-loaded; approve "yeepforge"
# then: "set the engagement to https://app.example.com, recon and crawl it,
#        test the params for SQLi/XSS, and write a report"

Setze das Ziel einmalig mit set_engagement, und YeepForge bettet es (plus Cookies/Proxy/Auth) in jeden späteren Aufruf ein. Komplette Beschreibung für Claude Code, Cursor und Claude Desktop: docs/mcp.md.


Agent Skills - geführte Pentest-Workflows

YeepForge enthält dreiZeit [Claude Agent Skills](https://docs, one line) unter .claude/skills/, die von Claude Code automatisch erkannt werden:

  • yeepforge-pentest – orchestriert ein vollständiges Engagement über die MCP-Tools: Authorization Gate → Recon → Crawling → OWASP-Tests → Exploit → Report.

  • yeepforge-sast – steuert die Quellcode-Analyse (analyze_source_code).

  • security-fuzz · security-payloads · security-patterns – SecLists-Payload/Wortlisten/Secret-Pattern-Referenzen für manuelle Tests.

Diese drei security-*-Skills stammen aus awesome-skills-security (MIT, distribution von SecLists); Web-Shell-Payloads wurden absichtlich ausgeschlossen. Siehe .claude/skills/NOTICE.md für die Quellenangabe.


SAST-Code-Analyse - 14 AI-Fähigkeiten

Der Agent kann Quellcode parallel zum dynamischen Testen analysieren. Bei bereitgestelltem Quellcode:

  1. Agent liest Architektur, Frameworks, Einstiegspunkte

  2. trackt jede Benutzereingabe durch den Code

  3. findet SQLi/XSS/Code-RCE/SSRF/JWT/IDOR im Quellcode

  4. Danach bestätigt er die Befunde mit dynamischen Tests

  5. Kombinierter Report: statische + dynamische Befunde

[4] Code Analysis menu:

  ○ [ 1]  Architecture Analysis  - tech stack · entry points · trust boundaries
  ○ [ 2]  SQL Injection          - string concat · ORM raw queries · 2nd order
  ○ [ 3]  Cross-Site Scripting   - HTML/JS sinks · DOM XSS · template injection
  ○ [ 4]  SSRF                   - outbound HTTP · user-controlled destinations
  ○ [ 5]  Remote Code Execution  - eval · exec · deserialization · OS commands
  ○ [ 6]  XXE                    - XML parsers without entity hardening
  ○ [ 7]  File Upload            - extension bypass · webshell upload paths
  ○ [ 8]  Path Traversal         - file reads with user-controlled paths
  ○ [ 9]  SSTI                   - template engines rendering user data
  ○ [10]  JWT Security           - algorithm confusion · missing validation
  ○ [11]  IDOR                   - missing ownership/authorization checks
  ○ [12]  Missing Auth           - unauthenticated sensitive endpoints
  ○ [13]  Business Logic         - price manipulation · workflow bypass
  ○ [14]  GraphQL                - injection · introspection · batching abuse
  ○ [ F]  Full Scan              - all 14 skills + final consolidated report
  ○ [ R]  Generate Report        - consolidate completed skill results

Funktionsumfang im Überblick

Automatisierte Engine

Key

Modul

Funktionsumfang

[A]

Auto-Full-Scan

Crawlen → alle OWASP-Tests → nikto → nuclei → CVSS-Report

[C]

Web Crawler

Verweise, Formulare, JS-APIs, robots.txt, Sitemap – plus optionales Headless-Rendering für SPAs

[W]

WAF-Bypass

14+ WAF-Fingerabdrücke · 100+ Bypass-Payloads pro Kategorie

[O]

OOB-Collaborator

interacts-Callbacks zur Bestätigung von Blind-SQLi, SSRF, XXE, Log4Shell, CMDi

[33]

AI-Agent

Autonom-Pentest · Chat · Payloads · SAST-Codeanalyse

OWAS-Top 10 (2021)

Vulnerable

Key

Bereiche

A01 Broken Access Control

[2]

IDOR · path traversal · forced browsing · JWNTS

A02 Cryptographic Failures

[3]

Sensitive Files · Klartext · schwache Hashs · JavaScript-Secrets

A03 Injection

[4]

SQLi · XSS · CDN · CMDi · XXE · NoSQL · LDAP

A04 Unsicheres Design

[5]

Business-Logik · Race conditions · Mass Assignment

A05 Security-Misconfiguration

[6]

Headers · CORS · Debug-Endpoints · Standard-Credentials

A06 Vulnerable2& Outdated Components

[7]

CVE-Scan · nikto · CMS-Scanner · Log4Shell

A07 Authentication Failures

[8]

Brute-Force · Session-Hijacking · MFA-Bypass · Credential Stuffing

A08 Integrity Failures

[9]

Deserialization · SIGO · CI/CD-Exposedness

A09 Security Logging Failures

[10]

Log-Injection · Stacktrace-Leak · Lock Error-Fallback

A10 SSRF

[11]

interne Ports · Cloud-Metadaten · gopher-Protokoll · blindes OOB

Erweiterte Exploitation

Modul

Techniken

[17] HTTP Request Smuggling

CL.TE · TE.CL · TE-Obfuscation · H2.TE-Downgrade

[18] OAuth / SAML / OIDC

Redirect-URI-Bypass · State-CSR-Token · SAML WS/XXE/Replay

[19] WebSocket-Security

CSWSH · Message-Injection · Origin-Bypass

[20] Cache Poisoning

Unkeyed-headers · Fat-GET · Cache Deception · DoS

[21] API-Security

GraphQL introspection & Abuse-Attack · REST enumeration

Attacks on Web App

Modul

Techniken

[26] Open Redirect

17 Bypass-Varianten · Scheme-Abuse · ATO-Explanation

[27] Clickjacking

Frame-Erkennung · PoC-Generator · Sandbox-Bypass

[28] CRLF-Injection

Header-Injection · Response-Splitting · Log-Injection

[29] Takeover

25 Service-Fingerprints · CNAME-Hijacking · nuclei-Scan

[30] Account Override

Passwort-Reset/ Passwort · E-Mail-Change-Exploit · 2FA-Bypass

[31] Advanced File-Upload

Polyglot File · SVG XSS · Zip-Slip · ImageMagick-Exploits

[32] HTTP Parameter Pollution

WAF 缓存 · API-Logik · DOM-HPP

[37] CSRF

Token-Erkennung · Bypass-Ansätze · PoC-Stack · SameSite-Methoden

[38] HTTP Verbufen

PUT/DELETE/TRACE · XST · Verb-Overwrite

[39] Prototype Pollution

JS __proto__ Injection · PHP type juggling XPath · E-Mail-Injection

[40] LFI / RFI / PHP-Wrapper

Local/Remote Datei-Inclusion · Log-Poisoning · php://-Streams

[41] Webshells

Generate · Upload · Interact · Obfuscate · Reverse-Shell

[42] Session Security

Cookie-Security · Session-Fixierung · Timeout · Logout-Flags · Cache

[43] XXE-Injection

Klassische XXE · Blind-OOB-Verifikation · Billion-Laughs · XXE via Header-Verletzung.

[44] Race-Conditions & IDOR

TOCTOU · Limit-Overrunning · IDOR-Automation · „Business-Logik“ (logic hacking)

[45] Passive Recon (AAV)

DNS · Google Dork · GitHub Newlines-Lecks · Shodan-Zertifizier-Daten –0-Ziel-Traffic


Schnellstart

1. Installation

git clone https://github.com/capture0x/YeepForge
cd YeepForge
chmod +x install.sh run.sh
./install.sh

2. Starte Ollama (kostenloses KI-Backend)

ollama serve &
ollama pull mistral        # Best instruction following
# or
ollama pull llama3.2:3b   # Fastest

3. Agent starten

./run.sh

# Session Setup:
#   Target URL: https://target.example.com

# Main menu → [33] YeepForge Agent → [1] Autonomous Pentest
# Watch the AI work. Get a report.

Agent + SAST (wenn du Quellcode hast)

./run.sh

# Main menu → [33] YeepForge Agent
#   [5] Set Source Code Path → /path/to/app/source
#   [1] Autonomous Pentest   → runs dynamic + SAST combined
# or:
#   [4] Code Analysis (SAST) → select individual skills

Reports

Jeder Scan erstellt einen professionellen CP-Report:

CONFIDENTIAL - WEB APPLICATION PENETRATION TEST REPORT

┌─ Overall Risk: CRITICAL (CVSS 9.8) ─────────────────────────┐
│  Critical: 2  High: 5  Medium: 8  Low: 3  Total: 18          │
└──────────────────────────────────────────────────────────────┘

Executive Summary ........ auto-generated narrative
Findings Overview ........ sortable table with CVSS v3.1 scores
Detailed Findings ........ cards with: severity · CVSS · OWASP · remediation
OWASP Top 10 Coverage .... visual grid - tested vs not tested
Remediation Priority ..... P1 (24h) / P2 (7d) / P3 (30d) / P4 (quarterly)

Formats: HTML (druckfertig) · Markdown · JSON (CI/CD-fähig)

12.

[34] Generate Report → [4] All formats
# → reports/yeepforge_report_20260521_143022.html

Installation & Vorraussetzung

Abhängigkeiten

# Python
pip install anthropic requests   # LLM backends + Ollama HTTP

# Headless crawling (optional, ~150MB - needed to see a SPA's attack surface)
pip install playwright && playwright install chromium

# APT security tools
apt install nmap nikto sqlmap gobuster ffuf hydra hashcat \
            wpscan feroxbuster wafw00f whatweb masscan dirb

# Go tools (optional but recommended)
go install github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
go install github.com/hahwul/dalfox/v2@latest
go install github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest

KI-Backend-Einrichten

# Ollama (recommended - free, local, no key needed)
curl -fsSL https://ollama.com/install.sh | sh
ollama pull mistral              # Best for pentesting
ollama pull llama3.2:3b          # Fastest option
ollama pull qwen2.5-coder:7b     # Best for code analysis

# Claude API (optional - better quality, requires key)
export ANTHROPIC_API_KEY=sk-ant-...
# or add to .env: ANTHROPIC_API_KEY=sk-ant-...

Configuration (.env)

TARGET_URL=https://target.example.com
ENGAGEMENT_NAME=Q4-2026-Pentest
COOKIES=sessionid=abc123; csrftoken=xyz
AUTH_TOKEN=Bearer eyJhbGci...
PROXY=http://127.0.0.1:8080
ANTHROPIC_API_KEY=              # Leave empty to use Ollama
YEEPFORGE_OPSEC=normal          # loud / normal / stealth

Modulreferenz

AUTOMATED
  [A] Auto Full Scan    [C] Web Crawler
  [W] WAF Bypass        [O] OOB Collaborator

OWASP TOP 10
  [1]  Recon            [2]  Broken Access Control
  [3]  Crypto Failures  [4]  Injection
  [5]  Insecure Design  [6]  Security Misconfig
  [7]  Vuln Components  [8]  Auth Failures
  [9]  Integrity        [10] Logging
  [11] SSRF             [12] SAST Code Analysis (AI)

ADVANCED EXPLOITATION
  [17] HTTP Smuggling   [18] OAuth/SAML/OIDC
  [19] WebSocket        [20] Cache Poisoning
  [21] API Security

WEB APPLICATION ATTACKS
  [26] Open Redirect    [27] Clickjacking
  [28] CRLF Injection   [29] Subdomain Takeover
  [30] Account Takeover [31] File Upload (Advanced)
  [32] HTTP Param Poll. [37] CSRF
  [38] Verb Tampering   [39] Prototype Pollution
  [40] LFI / RFI        [41] Webshells
  [42] Session Security [43] XXE Injection
  [44] Race / IDOR      [45] Passive Recon (OSINT)

AI AGENT
  [33] YeepForge Agent  ← START HERE
       [1] Autonomous Pentest
       [2] Interactive Chat
       [3] Payload Generator
       [4] Code Analysis (SAST)
       [5] Set Code Path

UTILITIES
  [34] Generate Report  [35] Session Manager
  [36] Tool Checker

Architektur

YeepForge/
├── main.py                      # Entry point, menu router
├── modules/
│   ├── agent/                   ← The Brain
│   │   ├── _core.py             # 27 tools, smart routing, SAST integration
│   │   ├── backends.py          # Ollama (mistral/llama/qwen) + Claude adapters
│   │   ├── constants.py         # Model config, timeout, OPSEC settings
│   │   └── logger.py            # Live markdown report writer
│   ├── auto_scanner.py          # Automated OWASP orchestrator
│   ├── crawler.py               # Smart web crawler (links/forms/JS/APIs)
│   ├── waf_bypass.py            # WAF fingerprint + 100+ bypass payloads
│   ├── oob_server.py            # OOB HTTP listener (blind vuln detection)
│   ├── sast_skills/             # 14 analysis skills + report generator (SKILL.md)
│   └── [attack modules]         # Full OWASP + Advanced + Web App coverage
├── reports/                     # HTML/MD/JSON professional reports
└── output/                      # Scan results, agent logs, crawl data

CLI-Referenz

./run.sh [OPTIONS]

  --target URL       Set target URL directly
  --module KEY       Run module by key (A, C, W, O, 1-45, 33...)
  --session PATH     Load saved session
  --scope PATTERNS   In-scope hosts: '*.example.com,!admin.example.com'
  --proxy URL        Route every request through Burp/ZAP
  --rps N            Cap requests per second (default 10, 0 = unlimited)
  --scope-audit      Warn on out-of-scope requests instead of blocking
  --browser          Render pages in headless Chromium (see a SPA's surface)
  --no-browser       Parse served HTML only; never launch a browser
  --no-banner        Skip ASCII banner
  --list-modules     Print every menu key with its module path and exit
  --non-interactive  Never block on a prompt; use with --module for automation

# Examples
./run.sh --target https://example.com
./run.sh --target https://example.com --scope '*.example.com,!admin.example.com'
./run.sh --target https://example.com --proxy http://127.0.0.1:8080 --rps 4
./run.sh --module 33          # Launch AI Agent directly
./run.sh --module A           # Auto full scan
./run.sh --module 34          # Generate report

# Agent chat commands
/quit               Exit chat
/model mistral      Switch Ollama model
/findings           Show current findings
/context            Show session context
/auto               Toggle auto-execution of CMD suggestions

Engagement-Sicherheit - Scope, Rate-Limiting, Nachweise

Jede Anfrage, die über die Engine unter utils/856 ergeht

  • Scope-checked – Out-of-Scope-Hosts werden blockiert, bevor die Anfrage deinen Rechner verlässt. Ohne Explizites --scope gelten der Ziel-Host und dessen Subdomains als Scope, damit ein nie auf fremde Systeme wechs.

  • Rate-Limited – ein gemeinsames Budget für den gesamten Lauf (--rps, Default 10), Retry-After wird zugrunde gelegt. Das hält dich von der Banliste des Programmes fern.

  • Proxy: Der Server benutzt für jede Anfrage einen --proxy, der Burp-Historie wird dadurch zum kompletten Engagement-Log.

  • Protokolliert: Ein Befund kann neben Raw Requests/Responses auch curl-Reproduktionszeilen belegen – rendered in HTML- und Markdown-Reports. Findings enthalten zudem eine Confidence-Stufe (Confirmed / Firm / Tentative).

./run.sh --target https://example.com \
         --scope '*.example.com,!admin.example.com' \
         --proxy http://127.0.0.1:8080 --rps 4

Für die vollständige Konfiguration und für das Schreiben eigener Module check docs/engine.md.


Ethical Use & Legalitation

YeepForge is intended for:

  • Autorisierte Penetrationstests/Aufträge

  • Bug-Bounty-Programme (nur erlaubte Ziele)

  • CTF-Wettbewerbe

  • Security-Forschung (auf eigenen Systemen) *Lernen und Bildung

Never instrument auf Systemen ohne schriftliche Erlaubnis.

Der Autor übernimmt keine Haftung für Missbrauch. Durch die Nutzung von YeepForge bestätigen Sie, dass Sie über die entsprechende Autorisierung für alle Ziele verfügen.

YeepForge führt angreiferkontrollierte Daten auf Ihrem Rechner aus – siehe SECURITY.md für die eigene Sicherheitslage des Tools, wie Sie es sicher ausführen und wie Sie eine Schwachstelle in YeepForge selbst melden können.


Mitwirken

Pull-Requests sind willkommen. CONTRIBUTING.md behandelt das Entwicklungs-Setup, das Hinzufügen eines Moduls und die zwei nicht verhandelbaren Regeln: Der gesamte HTTP-Verkehr läuft über utils/http.py, und kein Wert wird jemals in eine Shell-Zeichenkette interpoliert.


YeepForge v1.0 – Agent-First-Websicherheit

capture0x – unterstützt von tmrswrr

./run.sh → [33] YeepForge Agent → The AI does the rest.

-
license - not tested
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.

  • Zero-config MCP security scanner for AI-generated apps. 25K+ vulnerability patterns.

  • Offline methodology engine for authorized penetration testing, CTF, and security research.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/capture0x/YeepForge'

If you have feedback or need assistance with the MCP directory API, please join our Discord server