invisible_playwright_mcp

---

このブラウザーエージェントの2つの使い方

1. MCP経由でアシスタントから使う

Windows、PowerShellの場合：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"

Linuxの場合：

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

次に、アシスタントにインストールします。

Claude Code:

claude plugin marketplace add feder-cr/invisible_playwright_mcp
claude plugin install invisible-playwright-mcp@feder-cr

Codex:

codex plugin marketplace add feder-cr/invisible_playwright_mcp
codex plugin add invisible-playwright-mcp@feder-cr

Gemini CLI:

gemini extensions install https://github.com/feder-cr/invisible_playwright_mcp

2. 単独で使う：Web UI

インターフェースはこちらで用意します。OpenRouterのキーをご用意ください。 左側でチャットし、右側でブラウザーのライブ表示を確認できます。

Windows、PowerShellの場合：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
uvx invisible-playwright-mcp ui --openrouter-key sk-or-...

Linuxの場合：

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uvx invisible-playwright-mcp ui --openrouter-key sk-or-...

次に**http://127.0.0.1:8765**を開き、同じ内容を入力します。

---

Webブラウジングエージェントへの依頼例

APIではなくブラウザーで実際にWebを自動操作し、ページに表示された内容を人が判断する必要がある作業なら何でも依頼できます。

<paste the URL>にアクセスしてください。片道、ミラノからリスボン、エコノミー、預け入れ手荷物1個、 大人1人です。来月12日から16日までの日付を1日ずつすべて確認し、各日の最安運賃を読み取ってください。日付欄はカレンダーの ウィジェットなので、日付を入力するのではなく、各日をクリックしてください。空席がない日付は、そのように伝えてください。 数字を推測しないでください。

人が操作するようにページを操作します。ポインターが動き、キーが押されます。

オプション：プロキシ、プロファイル、シード

• --openrouter-key キー、またはOPENROUTER_API_KEY変数を指定します。
• --model OpenRouterのモデルID、またはINVISIBLE_MCP_MODELを指定します。デフォルトはz-ai/glm-5.3-flashです。
• --proxy 任意です。http://user:[email protected]:8080または socks5://proxy.example.com:1080を指定します。ホストとポートの両方が必要です。タイムゾーン、ロケール、外部への通信経路は プロキシに従います。
• --binary すでにお持ちのエンジンバイナリを指定します。封印で固定されたビルドである必要があります。異なる場合、起動は拒否されます。 これはダウンロードを省略するだけで、バージョンチェックは省略しません。
• --seed 整数を指定します。同じシードなら、実行のたびに同じブラウザーIDになります。
• --profile-dir プロファイルを保存するディレクトリを指定します。ログイン情報とCookieは再起動後も保持されます。
• --headed ブラウザーウィンドウを表示します。インターフェース上でもページを確認できます。
• --host、--port デフォルトは127.0.0.1と8765です。ホストを変更すると、認証のないインターフェースが公開されます。

コマンドの隣に置く .env

キーやバイナリのパスを何度も入力する代わりに、コマンドを実行する ディレクトリに .env を置いてください。

OPENROUTER_API_KEY=sk-or-...
STEALTHFOX_BINARY=/path/to/firefox

起動時に読み込まれます。読み込み時に、すでに設定されている値を決して上書きしません。そのため、優先順位は --flag > 環境変数 > .env > デフォルト値です。読み込まれるのは現在のディレクトリだけで、上位ディレクトリは検索しません。そのため、サブフォルダーから実行しても、別のキーが気付かないうちに読み込まれることはありません。起動時のメッセージには適用された変数名が表示されますが、値は表示されません。

--openrouter-key を渡すと、キーがシェルの履歴に残り、Linux ではプロセス一覧にも表示されます。環境変数または .env に OPENROUTER_API_KEY を設定すれば、どちらも避けられます。

Wiki：AI ブラウザーエージェントのガイド

エージェントに関する情報は Wikiにあります。AI ブラウザーエージェントの全体像：browser-use、Operator 系、computer-use エージェントの比較、 エージェントがブロックされた場合の確認事項、 OpenAI Operator はどうなったのかなどを掲載しています。実例、やり取りの記録、出力は articles/にあります。

ファミリーのその他のメンバー：engine、core

オプション 1 の MCP サーバーはこのパッケージに含まれています。サブコマンドなしの invisible_playwright_mcp はサーバー、invisible-playwright-mcp ui はインターフェースです。設定ファイルを使うクライアント向けの設定ブロック、設定項目、ツールについては、Wiki のページ The MCP serverをご覧ください。

• invisible_playwright プロンプトではなくコードを書くための、Python ライブラリとしてのエンジンです。API は Playwright のものです。
• invisible_core シードからフィンガープリント、設定、プロキシ、位置情報までを扱います。

責任を持って使用する

これは、利用者が管理するブラウザーを自動化します。アクセス先サイトの利用規約を確認し、レート制限を守り、人間が読んでいない内容を送信しないでください。

プライバシーポリシー

このブラウザーエージェントはお使いのマシン上で動作し、独自のサーバーはありません。コンピューターから送信される情報と送信先は次のとおりです。

• アクセスするサイトには、他の Firefox と同様にブラウザーが見えます。
• モデルプロバイダー。 Web UI は、会話内容とエージェントがページ上で読み取った内容を、利用者のキーを使って OpenRouter に送信します。MCP 経由の場合、接続先のクライアントが、使用するモデルに同じ情報を送信します。
• GitHub。 サーバーまたはインターフェースの初回起動時に、エンジンが GitHub のリリースからダウンロードされます。また、プロキシが設定されている場合は GeoIP データベースもダウンロードされます。ブラウザーを起動するたびに、GitHub のリリースから 1 行のカウンターファイルも取得されます。これによって起動回数を数えています。このリクエストには識別情報や利用者の情報は含まれず、GitHub に見えるのは、IP アドレスなど通常の HTTPS リクエストで確認できる情報です。

それ以外の情報は収集されず、作者に送信されることもありません。セッション、プロファイル、スクリーンショットはローカルに保存されます。INVISIBLE_MCP_HOME が設定されている場合はその場所に、設定されていない場合はシステムのアプリケーションデータディレクトリに保存されます。これらは利用者自身で削除できます。他の場所に保持されることはありません。お問い合わせは issuesまでお寄せください。

ライセンス

MIT。2026 年 9 月 2 日より前に配布されたものはすべて AGPL-3.0 で公開されており、引き続き同ライセンスが適用されます。