मानवीकृत इनपुट व्यवहार¶

ह्यूमनाइज़्ड इनपुट बिहेवियर, पेज इंटरैक्शन को क्लोकब्राउज़र के मानव-सदृश माउस, कीबोर्ड और स्क्रॉल लेयर के माध्यम से राउट करता है। यह तब उपयोगी होता है जब QA को मानक ऑटोमेशन की तुलना में अधिक यथार्थवादी गति, पॉइंटर की गति, टाइपिंग की लय और स्क्रॉल व्यवहार की आवश्यकता होती है।

ब्रिज नए ब्राउज़र टूल्स नहीं जोड़ता है या अपस्ट्रीम Playwright MCP स्कीमा को नहीं बदलता है। यह Playwright MCP पेज इनिशियलाइज़ेशन के दौरान CloakBrowser के पेज इंटरैक्शन पैच को लागू करता है, ताकि मौजूदा टूल्स उसी इनपुट के साथ काम करते रहें।

यह क्या बदलता है¶

जब CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true, क्लोकब्राउज़र सामान्य पेज क्रियाओं को मानवीय बना सकता है, जिनमें शामिल हैं:

माउस की मूवमेंट और क्लिक;
कीबोर्ड टाइपिंग और की प्रेस;
फॉर्म भरना और फ़ील्ड स्विचिंग;
स्क्रॉलिंग और स्क्रॉल-टू-एलिमेंट व्यवहार।

इससे इंटरैक्शन टाइमिंग और मूवमेंट पैटर्न प्रभावित होते हैं। यह पेज की सामग्री, नेटवर्क राउटिंग, प्रॉक्सी सेटिंग्स, या ब्राउज़र जियोलोकेशन को नहीं बदलता है।

वैश्विक सेटअप¶

जब हर stdio सत्र या डिफ़ॉल्ट Streamable HTTP सत्र को मानवीय व्यवहार का उपयोग करना चाहिए, तब पर्यावरण चर का उपयोग करें:

CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true \
CLOAK_PLAYWRIGHT_MCP_HUMAN_PRESET=careful \
npx -y cloakbrowser-mcp@latest

उसी सेटिंग स्पष्ट CLI फ़्लैग के साथ भी काम करती है:

npx -y cloakbrowser-mcp@latest --humanize --human-preset careful

डॉकर सेटअप¶

कंटेनर को वही पर्यावरण चर पास करें:

docker run --rm --init -i \
  -e CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true \
  -e CLOAK_PLAYWRIGHT_MCP_HUMAN_PRESET=careful \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest

Docker में स्ट्रीमएबल HTTP के लिए, एनवायरनमेंट वेरिएबल नए HTTP सत्रों के लिए डिफ़ॉल्ट बन जाता है:

docker run --rm --init -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

प्रति-सत्र स्ट्रीम करने योग्य HTTP सेटअप

स्ट्रीमएबल HTTP क्लाइंट MCP सत्र आरंभिकीकरण समय पर मानवीकृत व्यवहार चुन सकते हैं। यह एक सर्वर को बिना पुनः आरंभ किए मानक और मानवीकृत इंटरैक्शन व्यवहार की तुलना करने की अनुमति देता है।

initialize अनुरोध में ब्रिज मेटाडेटा भेजें:

{
  "params": {
    "_meta": {
      "io.github.swimmwatch/cloakbrowser-mcp": {
        "humanize": true,
        "humanPreset": "careful"
      }
    }
  }
}

humanize उस HTTP सत्र के लिए प्रक्रिया-स्तर की सेटिंग को ओवरराइड करता है। मानवीकृत व्यवहार को सक्षम करने के लिए true या false का उपयोग इसे अक्षम करने के लिए करें, भले ही सर्वर को CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true के साथ शुरू किया गया हो।

humanPreset स्वीकार करता है default या careful स्वीकार करता है और सत्र के लिए क्लोकब्राउज़र मानवीय व्यवहार प्रीसेट चुनता है। यह अपने आप मानवीकृत व्यवहार को सक्षम नहीं करता है; humanize: true सेट करें या CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true सक्षम करें। careful प्रीसेट, default की तुलना में धीमा और अधिक सतर्क है।

मौजूदा HTTP सत्र अपरिवर्तनीय हैं। मानक और मानवीकृत व्यवहार के बीच स्विच करने के लिए एक और स्ट्रीमएबल HTTP सत्र बनाएँ।

उपयोग के मामले¶

फ़ॉर्म QA

अधिक realistic keyboard cadence के साथ typing, filling, focus changes और validation flows test करें।

Checkout फ़्लो

Interaction-heavy purchase paths test करें जहां typing, clicking और field switching timing client-side validation को प्रभावित कर सकती है।

Interaction-sensitive UI जांच

जब page बहुत तेज या perfectly linear inputs पर अलग प्रतिक्रिया देता है, तो standard automation की humanized interaction से तुलना करें।

अधिक scroll वाली pages

Smoother scroll behavior के साथ long pages, feeds, product lists और lazy-loading content validate करें।

Demos और recordings

Product demos, walkthroughs या recorded QA evidence के दौरान कम mechanical दिखने वाले browser sessions बनाएं।

प्राथमिकता और सीमाएँ¶

क्षेत्र	व्यवहार
Stdio	केवल process-level environment variables और CLI flags उपयोग करता है।
Streamable HTTP default	Runtime metadata न दिए जाने पर process-level environment variables और CLI flags उपयोग करता है।
Streamable HTTP metadata	`initialize.params._meta["io.github.swimmwatch/cloakbrowser-mcp"].humanize` एक session के लिए humanized behavior override कर सकता है। `humanPreset` `default` या `careful` चुन सकता है।
Existing sessions	`initialize` के दौरान capture किए गए humanize setting को रखते हैं।
Browser engine	केवल `PLAYWRIGHT_MCP_BROWSER_ENGINE=cloak` होने पर लागू होता है।
Tool schemas	Upstream Playwright MCP browser tool schemas unchanged रहते हैं।
Custom config	`humanConfig` अभी intentionally accepted नहीं है; structured config को explicit validation schema चाहिए।

यह सुविधा वैध QA, इंटरैक्शन यथार्थवाद, और संगति परीक्षण के लिए है। इसे एक्सेस नियंत्रण या नीति जांचों को बायपास करने के तरीके के रूप में नहीं माना जाना चाहिए।

अतिरिक्त व्यावहारिक रास्ते¶

upstream Playwright MCP और इस package में चुनने के लिए तुलना देखें। तेज tasks के लिए रेसिपी उपयोग करें: persistent profile, extensions, reverse proxy, regional QA, Claude Desktop, Codex CLI और CI smoke test.