Menschliches Eingabeverhalten¶
Durch das humanisierte Eingabeverhalten werden Seiteninteraktionen über die menschähnliche Maus-, Tastatur- und Scroll-Ebene von CloakBrowser geleitet. Dies ist nützlich, wenn die Qualitätssicherung ein realistischeres Tempo, realistischere Zeigerbewegungen, eine realistischere Tippgeschwindigkeit und ein realistischeres Scrollverhalten benötigt, als es die Standardautomatisierung bietet.
Die Brücke fügt keine neuen Browser-Tools hinzu und verändert auch nicht die Upstream-Schemas von Playwright MCP. Sie wendet den Patch für die Seiteninteraktion von CloakBrowser während der Initialisierung der Playwright-MCP-Seite an, sodass bestehende Tools weiterhin mit denselben Eingaben funktionieren.
Was sich dadurch ändert¶
Wenn CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true aktiviert ist, kann CloakBrowser gängige Seitenaktionen humanisieren, darunter:
- Mausbewegungen und Klicks;
- Tastatureingaben und Tastenanschläge;
- Ausfüllen von Formularen und Wechseln zwischen Feldern;
- Scrollen und das Verhalten beim Scrollen zu einem bestimmten Element.
Dies wirkt sich auf das Timing der Interaktionen und die Bewegungsmuster aus. Es hat keine Auswirkungen auf den Seiteninhalt, die Netzwerkweiterleitung, die Proxy-Einstellungen oder die Standortbestimmung des Browsers.
Globale Einstellungen¶
Verwenden Sie die Umgebungsvariable, wenn jede stdio-Sitzung oder jede standardmäßige Streamable-HTTP- Sitzung ein benutzerfreundliches Verhalten anwenden soll:
CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true \
CLOAK_PLAYWRIGHT_MCP_HUMAN_PRESET=careful \
npx -y cloakbrowser-mcp@latest
Die gleiche Einstellung funktioniert auch mit dem expliziten CLI-Flag:
Docker-Einrichtung¶
Übergeben Sie dieselbe Umgebungsvariable an den Container:
docker run --rm -i \
-e CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true \
-e CLOAK_PLAYWRIGHT_MCP_HUMAN_PRESET=careful \
-v "$PWD/artifacts:/data" \
swimmwatch/cloakbrowser-mcp:latest
Bei „Streamable HTTP“ in Docker wird die Umgebungsvariable zur Standardeinstellung für neue HTTP-Sitzungen:
docker run --rm -p 127.0.0.1:3000:3000 \
-e CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true \
-e CLOAK_PLAYWRIGHT_MCP_HUMAN_PRESET=careful \
-v "$PWD/artifacts:/data" \
swimmwatch/cloakbrowser-mcp:latest \
--transport streamable-http --http-host 0.0.0.0 --http-port 3000
Einrichtung von „Streamable HTTP“ pro Sitzung¶
Streamable-HTTP-Clients können bei der Initialisierung der MCP-Sitzung ein „humanisiertes“ Verhalten wählen. Dadurch kann ein Server das Standardverhalten mit dem „humanisierten“ Interaktionsverhalten vergleichen, ohne neu gestartet werden zu müssen.
Senden Sie die Bridge-Metadaten in der Anfrage initialize:
{
"params": {
"_meta": {
"io.github.swimmwatch/cloakbrowser-mcp": {
"humanize": true,
"humanPreset": "careful"
}
}
}
}
humanize überschreibt die Einstellung auf Prozessebene für diese HTTP-Sitzung. Verwenden Sie true, um ein benutzerfreundliches Verhalten zu aktivieren, oder false, um es zu deaktivieren, selbst wenn der Server mit CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true gestartet wurde.
humanPreset akzeptiert default oder careful und wählt die CloakBrowser-Voreinstellung für menschliches Verhalten für die Sitzung aus. Es aktiviert das humanisierte Verhalten nicht von selbst; sondern muss humanize: true festgelegt oder CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true aktiviert werden. Die Voreinstellung careful ist langsamer und vorsichtiger als default.
Bestehende HTTP-Sitzungen sind unveränderlich. Erstellen Sie eine weitere „Streamable“-HTTP-Sitzung, um zwischen dem Standardverhalten und dem humanisierten Verhalten zu wechseln.
Anwendungsfälle¶
- Formular-QA
Prüfe Tippen, Ausfüllen, Fokuswechsel und Validierungsabläufe mit realistischerer Tastaturkadenz.
- Checkout-Abläufe
Teste interaktionsreiche Kaufpfade, bei denen Timing von Tippen, Klicken und Feldwechseln die clientseitige Validierung beeinflussen kann.
- Interaktionssensible UI-Prüfungen
Vergleiche Standardautomatisierung mit humanisierter Interaktion, wenn eine Seite anders auf sehr schnelle oder perfekt lineare Eingaben reagiert.
- Scroll-intensive Seiten
Prüfe lange Seiten, Feeds, Produktlisten und lazy-loading Inhalte mit sanfterem Scrollverhalten.
- Demos und Aufzeichnungen
Erzeuge Browser-Sitzungen, die bei Produktdemos, walkthroughs oder aufgezeichneten QA-Nachweisen weniger mechanisch wirken.
Rangfolge und Grenzen¶
| Bereich | Verhalten |
|---|---|
| Stdio | Verwendet nur Umgebungsvariablen und CLI-Flags auf Prozessebene. |
| Streamable-HTTP-Standard | Verwendet Umgebungsvariablen und CLI-Flags auf Prozessebene, wenn keine runtime-Metadaten angegeben sind. |
| Streamable-HTTP-Metadaten | initialize.params._meta["io.github.swimmwatch/cloakbrowser-mcp"].humanize kann humanisiertes Verhalten für eine Sitzung überschreiben. humanPreset kann default oder careful auswählen. |
| Bestehende Sitzungen | Behalten die während initialize erfasste humanize-Einstellung. |
| Browser-Engine | Gilt nur bei PLAYWRIGHT_MCP_BROWSER_ENGINE=cloak. |
| Tool-Schemata | Upstream Playwright-MCP-Browser-Tool-Schemata bleiben unverändert. |
| Benutzerdefinierte Konfiguration | humanConfig wird absichtlich noch nicht akzeptiert; strukturierte Konfiguration benötigt ein explizites Validierungsschema. |
Diese Funktion ist für legitime Qualitätssicherung, die Überprüfung des Interaktionsrealismus und Konsistenztests vorgesehen. Sie sollte nicht als Möglichkeit zur Umgehung von Zugriffskontrollen oder Richtlinienprüfungen betrachtet werden.
Zugehörige Konfiguration¶
- Konfiguration listet alle Bridge- und Upstream-Umgebungsvariablen auf.
- GeoIP-Proxy-Zuordnung erläutert regionenkonsistente Proxy-Profile.
- Werkzeuge erläutert, warum Upstream-Browser-Tools von Playwright MCP unverändert weitergeleitet werden.
Weitere praktische Pfade¶
Für die Entscheidung zwischen upstream Playwright MCP und diesem Paket nutzen Sie den Vergleich. Für kurze Aufgaben nutzen Sie die Rezepte: persistentes Profil, Erweiterungen, reverse proxy, regionale QA, Claude Desktop, Codex CLI und CI-Smoke-Test.
CloakBrowser¶
Die aktuelle CloakBrowser-Abhängigkeit ist ^0.6.3. Bei humanisierter Eingabe überlappen sich Tastendrücke und die Abstände zwischen den Tasten variieren. Die Dauer einer Mausbewegung hängt von der Entfernung ab. Das Scrollen verwendet ganze Mausradrasten für die simulierte Plattform; kleine angeforderte Bewegungen können daher gerundet werden. Interaktionen unterstützen Modaldialoge mit fester Position sowie absolut positionierte Elemente außerhalb übergeordneter Scrollcontainer. Die Auswahl einer Option, die eine Navigation auslöst, liefert die ausgewählten Werte statt eines Fehlers wegen eines veralteten Elements zurück.
Für CloakBrowser 0.6.2/0.6.3 navigiert die Bridge vor der Eingabe in native Datums- und Uhrzeiteditoren mit ArrowLeft zum ersten Segment. So landen nach dem ersten Klick nicht alle Ziffern im Jahresfeld. Die Werte werden per Tastatur eingegeben, ohne programmatische Zuweisung.
CloakBrowser 0.6.2 korrigiert die Sichtbarkeitsprüfungen humanisierter Aktionen mit Playwright 1.64. Die Bridge übergibt die tatsächliche Sichtbarkeit übergeordneter iframe an beide Prüfpfade für den Elementzustand statt des bedingungslosen true aus Upstream.
Humanisierte Aktionen folgen der Playwright-Selektorsemantik einschließlich des strikten Modus. Mehrdeutige Locators und nicht unterstützte Aktionen lösen Fehler aus, statt still auf normale Aktionen zurückzufallen. Beispielsweise kann humanisiertes fill() kein input[type=color] bedienen; deaktivieren Sie humanize für eine Sitzung, die diesen Vorgang benötigt.
Bei aktiviertem humanize akzeptiert die Bridge nur geprüfte Abhängigkeitsversionen und Quellcode-Hashes. Sie prüft die Sichtbarkeit übergeordneter iframe und hält schwache Referenzen auf gefundene DOM-Elemente, damit entfernte Elemente freigegeben werden können. Nicht unterstützte Versionen oder veränderte Quellen werden abgelehnt; verwenden Sie bis zur Unterstützung CLOAK_PLAYWRIGHT_MCP_HUMANIZE=false.
CloakBrowser 0.6.1 führt inputValue(), textContent(), innerText(), innerHTML(), getAttribute() und dispatchEvent() für Page, Frame, Locator und ElementHandle im isolierten Kontext von humanize aus. Bei verborgenen oder überlappenden ElementHandle-Elementen sowie Ereignisargumenten mit einem JSHandle verwendet die Upstream-Implementierung für Lesezugriffe und Ereignisse den ursprünglichen Playwright-Aufruf als Rückfalllösung.
Die Auswahl in Dropdowns verwendet die Suche über eingegebene Präfixe und unterstützt wiederholte Auswahlvorgänge. Unter macOS kann ein Eintrag, dessen Beschriftung mit einem Emoji beginnt, durch humanisierte Eingabe unerreichbar sein; der Fehler wird über MCP weitergegeben. Wenn eine programmatische Auswahl zulässig ist, verwenden Sie ausdrücklich die Upstream-Methode page._original.selectOption().