このプロジェクトについて

invisible_playwright_mcpは、AIアシスタントが実ブラウザを操作できるようにするセルフホスト型Python MCPサーバーです。anti-detectステルスFirefoxエンジン上に構築されているため、エージェントは通常なら自動化クライアントをブロックするページも閲覧できます。 使用方法は2通りあります。 1. アシスタントからMCP経由で使用する。uvをインストールし、ドキュメント化されたmarketplace/extensionコマンドでClaude Code、Codex、Gemini CLIにプラグインを追加します。サブコマンドなしで実行した場合、パッケージ自体がMCPサーバーとなります。 2. スタンドアロンWeb UI。`uvx invisible-playwright-mcp ui --openrouter-key ...`を実行し、http://127.0.0.1:8765 を開きます。左側にチャット、右側にブラウザのライブビューが表示されます。OpenRouterキーが必要で、デフォルトではz-ai/glm-5.3-flashモデルを使用します。 エージェントは人間と同じようにページを操作します。APIを呼び出すだけでなく、ポインターを動かしキーを押します。READMEの例はフライト検索タスクで、エージェントはカレンダーの日付を1つずつクリックし、推測せずに運賃を読み取る必要があります。 設定オプションは以下の通りです。 - --openrouter-key または OPENROUTER_API_KEY - --model または INVISIBLE_MCP_MODEL - --proxy（httpまたはsocks5、hostとportが必須。タイムゾーン、ロケール、egressはプロキシに従う） - --binary 既存のエンジンビルド用。固定バージョンと一致する必要がある - --seed 再現可能なブラウザID用 - --profile-dir ログインとCookieを永続化する - --headed ブラウザウィンドウを表示する - --host と --port（デフォルトは127.0.0.1:8765。hostを変更すると認証なしのインターフェースが公開される） カレントディレクトリの.envファイルにOPENROUTER_API_KEYとSTEALTHFOX_BINARYを格納できます。優先順位はフラグ、環境変数、.env、デフォルトの順です。読み取られるのはカレントディレクトリのみで、値は起動時に表示されません。 同じファミリーの関連プロジェクト：invisible_playwright（Playwright風APIを備えたPythonライブラリとしてのエンジン）とinvisible_core（seedからfingerprint、preferences、proxy、geolocationへ）。 READMEのプライバシーに関する注意：エージェントはローカルで実行され、作者が運営するサーバーはありません。訪問したサイトには通常のFirefoxが見えます。モデルプロバイダーは会話とページコンテンツを受け取ります。GitHubはエンジンのダウンロード、プロキシ設定時のGeoIPデータベース、1行の起動カウンターのために接触されます。セッション、プロファイル、スクリーンショットはINVISIBLE_MCP_HOMEまたはシステムのアプリケーションデータディレクトリの下にローカル保存されます。プロジェクトはMITライセンスで、2026年9月2日より前のリリースはAGPL-3.0のままです。READMEはまた、ユーザーにサイトの利用規約とレート制限を尊重するよう求めています。