ttcd77/agent-browser-runtime

Was macht agent-browser-runtime?

Lokale DevTools/F12-Evidenz-Laufzeitumgebung für KI-Agenten und AppSec-Workflows.

Beschreibung

Die agent-browser-runtime ist eine leistungsstarke lokale Laufzeitumgebung, die es KI-Agenten ermöglicht, auf Browser-Entwicklertools (F12) zuzugreifen und Beweise (Evidenz) für Anwendungssicherheits-Workflows (AppSec) zu sammeln. Sie bietet eine programmatische Schnittstelle, um Netzwerkaktivitäten, Konsolenprotokolle, Leistungsmetriken und Sicherheitsheader zu erfassen und zu analysieren.

Funktionen

• Netzwerküberwachung: Erfasst alle HTTP/HTTPS-Anfragen und -Antworten inkl. Header und Nutzdaten.
• Konsolenprotokollierung: Zeichnet console.log, console.warn, console.error und andere Konsolenausgaben auf.
• DOM-Snapshot: Erstellt Momentaufnahmen des DOM-Baums zu beliebigen Zeitpunkten.
• Sicherheitsanalyse: Prüft auf CORS, CSP, X-Frame-Options und andere sicherheitsrelevante Header.
• Leistungsprofil: Misst Ladezeiten, Skriptausführungszeiten und Rendering-Performance.

Unterstützte Plattformen

• Claude Code
• Cursor
• Codex
• Andere KI-Agenten-Plattformen mit API-Unterstützung

Installation

npm install @ttcd77/agent-browser-runtime

Verwendung

const BrowserRuntime = require('@ttcd77/agent-browser-runtime');

const runtime = new BrowserRuntime({
    headless: true,
    port: 9222
});

await runtime.start();

const evidence = await runtime.collectEvidence({
    url: 'https://example.com',
    captureNetwork: true,
    captureConsole: true,
    captureSecurity: true
});

console.log(evidence);
await runtime.stop();

API-Referenz

Methode	Beschreibung	Parameter
start()	Startet die Browser-Laufzeitumgebung	{ headless, port }
collectEvidence()	Sammelt Browser-Evidenz	{ url, captureNetwork, captureConsole, captureSecurity }
stop()	Stoppt die Laufzeitumgebung	Keine

Konfiguration

Umgebungsvariablen:

• BROWSER_RUNTIME_PORT - Port für die Debugging-Schnittstelle (Standard: 9222)
• BROWSER_RUNTIME_HEADLESS - Headless-Modus aktivieren/deaktivieren (Standard: true)
• BROWSER_RUNTIME_TIMEOUT - Timeout für Evidenz-Sammlung in ms (Standard: 30000)

Sicherheitshinweise

Wichtig: Diese Laufzeitumgebung ist für lokale Entwicklungs- und Testumgebungen konzipiert. Verwenden Sie sie nicht in Produktionsumgebungen ohne entsprechende Sicherheitsvorkehrungen.

Lizenz

MIT