コンテンツにスキップ

人間らしい入力行動

人間らしい入力動作により、ページとのやり取りはCloakBrowserの 人間のようなマウス、キーボード、スクロールレイヤーを経由して行われます。これは、QAにおいて、 標準的な自動化機能よりもさらに現実的な操作ペース、ポインタの動き、タイピングのリズム、およびスクロール動作が 求められる場合に役立ちます。

このブリッジは、新しいブラウザツールを追加したり、上流のPlaywright MCPの スキーマを変更したりすることはありません。Playwright MCPの ページ初期化時にCloakBrowserのページ操作パッチを適用するため、既存のツールはこれまでと同じ入力で引き続き動作します。

変更点

CLOAK_PLAYWRIGHT_MCP_HUMANIZE=trueの場合、CloakBrowserは次のような一般的なページ操作を 人間らしい操作に変換できます：

  • マウスの動きとクリック；
  • キーボードの入力とキーの押下；
  • フォームへの入力とフィールドの切り替え；
  • スクロールおよび要素へのスクロール動作。

これにより、インタラクションのタイミングや動作パターンに影響が生じます。ただし、ページの コンテンツ、ネットワークのルーティング、プロキシ設定、およびブラウザの位置情報には影響しません。

グローバル設定

すべての 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 のセットアップ

同じ環境変数をコンテナに渡します：

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 での Streamable 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 を受け入れ、そのセッションに対して CloakBrowser のヒューマン ビヘイビアプリセットを選択します。 これだけでは人間らしい挙動は有効になりません 。 humanize: true を設定するか、CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true を有効にする必要があります。 carefulプリセットは、defaultよりも動作が遅く、より慎重です。

既存のHTTPセッションは変更できません。標準の動作と人間らしい動作を切り替えるには、 別のStreamable HTTPセッションを作成してください。

ユースケース

  • フォーム QA

より現実的なキーボード cadence で、入力、入力補完、フォーカス変更、検証フローを確認します。

  • チェックアウトフロー

入力、クリック、フィールド切り替えの timing がクライアント側検証に影響する、 操作の多い購入経路をテストします。

  • 操作に敏感な UI チェック

ページが非常に速い入力や完全に直線的な入力に異なる反応を示す場合、 標準自動化と人間らしい操作を比較します。

  • スクロール中心のページ

より滑らかなスクロール動作で、長いページ、フィード、商品リスト、lazy-loading コンテンツを検証します。

  • デモと録画

product demo、walkthrough、録画された QA 証跡で、機械的に見えにくいブラウザーセッションを作成します。

優先順位と制限

領域 動作
Stdio プロセスレベルの環境変数と CLI フラグのみを使用します。
Streamable HTTP の既定値 runtime メタデータが指定されていない場合、プロセスレベルの環境変数と CLI フラグを使用します。
Streamable HTTP メタデータ initialize.params._meta["io.github.swimmwatch/cloakbrowser-mcp"].humanize は、1 セッションの人間らしい動作を上書きできます。humanPreset は default または careful を選択できます。
既存セッション initialize 中に取得された humanize 設定を保持します。
ブラウザーエンジン PLAYWRIGHT_MCP_BROWSER_ENGINE=cloak の場合のみ適用されます。
ツール schema Upstream Playwright MCP のブラウザーツール schema は変更されません。
カスタム設定 humanConfig は意図的にまだ受け付けていません。構造化設定には明示的な検証 schema が必要です。

この機能は、正当な品質保証（QA）、操作のリアリティ、および一貫性の テストを目的としています。アクセス制御やポリシー チェックを迂回する手段として扱ってはなりません。

関連する設定

  • 設定 には、すべてのブリッジおよびアップストリームの環境変数が記載されています。
  • GeoIP プロキシのマッチング では、地域に一貫性のあるプロキシプロファイルについて説明しています。
  • ツール では、アップストリームの Playwright MCP ブラウザツールが変更されずに転送される理由について説明しています。

追加の実用パス

upstream Playwright MCP とこのパッケージのどちらを使うかは比較を参照してください。短い作業手順にはレシピを使います: 永続プロファイル、拡張機能、reverse proxy、リージョン QA、Claude Desktop、Codex CLI、CI スモークテスト。