patchright-cli 0.6.0__tar.gz → 0.8.0__tar.gz

{patchright_cli-0.6.0 → patchright_cli-0.8.0}/.claude-plugin/marketplace.json

@@ -5,7 +5,7 @@
   },
   "metadata": {
     "description": "Anti-detect browser automation CLI & Skills for AI agents, powered by Patchright",
-    "version": "0.5.0"
+    "version": "0.8.0"
   },
   "plugins": [
     {

{patchright_cli-0.6.0 → patchright_cli-0.8.0}/.gitignore

@@ -8,3 +8,5 @@ build/
 docs/reddit-post.md
 docs/superpowers/
 .worktrees/
+.claude/settings.local.json
+=*

{patchright_cli-0.6.0 → patchright_cli-0.8.0}/CLAUDE.md

@@ -57,10 +57,10 @@ CLI (cli.py) --TCP:9321--> Daemon (daemon.py) --Patchright--> Chrome
 
 - Always uses persistent browser context (`launch_persistent_context`) with real Chrome (`channel="chrome"`), not Chromium
 - Headed by default (headless is more detectable)
-- Default daemon port: 9321, profiles stored at `~/.patchright-cli/profiles/<session-name>`
+- Default daemon port: 9321, profiles stored at `~/.patchright-cli/profiles/<profile-name>`; a session's profile defaults to its session name (`--profile=<name>` overrides, a value with `/` or `\` is a directory). One session per profile at a time
 - CLI-daemon protocol: length-prefixed (4-byte big-endian `!I`) JSON over TCP
 - CLI parses argv manually in `main()` — click is only used for `click.echo()`, not subcommands. New commands must be added to both `COMMANDS_HELP` dict and the `handle_command()` if/elif chain in daemon.py
-- Version must be updated in both `pyproject.toml` and `src/patchright_cli/__init__.py` (then run `uv lock` to sync the lock file)
+- Version must be updated in `pyproject.toml`, `src/patchright_cli/__init__.py` and `.claude-plugin/marketplace.json` (then run `uv lock` to sync the lock file; `tests/test_packaging.py` checks they match)
 - `python -m patchright_cli` works via `__main__.py`
 - Uses hatchling as build backend, ruff for linting (line-length=120, target py310)
 - Ruff rules: E, F, I, W, UP, B, SIM (ignores E501, SIM105, E402)

patchright_cli-0.8.0/GLOSSARY.md

@@ -0,0 +1,58 @@
+# patchright-cli
+
+An anti-detect browser automation CLI: callers drive real Chrome through short commands sent to a long-running daemon.
+
+## Sessions and browsers
+
+**Session**:
+A named handle on one browser context that callers drive with commands; selected with `-s`.
+_Avoid_: Browser, instance, profile
+
+**Default Session**:
+The Session used when no `-s` is given.
+
+**Launched Session**:
+A Session whose Chrome patchright-cli started itself and therefore owns outright.
+
+**Profile**:
+A named, persistent store of browser state — cookies, storage, logins, history — that a Launched Session runs on; at most one Session uses a Profile at a time. Unless told otherwise, a Session's Profile is named after the Session.
+_Avoid_: User data dir, profile directory, persistent context
+
+**Attached Session**:
+A Session connected to a Chrome that something else started, reached over CDP.
+_Avoid_: Connected session, remote session
+
+**Host**:
+Whatever started and owns the Chrome an Attached Session connects to — a person, a script, or a product such as a workspace manager.
+_Avoid_: External browser, owner
+
+**Host Context**:
+The Host's own browser context, carrying its profile's cookies, storage and logins; at most one Session may use a given Host Context.
+_Avoid_: Default context, existing context, persistent context
+
+**Isolated Context**:
+A fresh browser context an Attached Session creates inside the Host's Chrome, sharing none of the Host's state.
+_Avoid_: Incognito context
+
+## Tabs and pages
+
+**Page**:
+One browser tab as Chrome sees it.
+_Avoid_: Tab (except in the playwright-cli-compatible `tab-*` command names, which act on Pages)
+
+**Tab**:
+A named workspace inside a Session — its own Page, element refs and navigation history — selected with `--tab`.
+_Avoid_: Lane, worker
+
+**Default Tab**:
+The Tab used when no `--tab` is given; it follows whichever Page is currently selected rather than owning one.
+
+## Ending a Session
+
+**Close**:
+Ending a Session by destroying what it owns: its Tabs' Pages and, for a context it owns, the context itself.
+_Avoid_: Quit, kill (except `kill-all`)
+
+**Detach**:
+Letting go of an Attached Session while leaving the Host's Chrome, and anything the Host owns, untouched.
+_Avoid_: Disconnect, release

{patchright_cli-0.6.0 → patchright_cli-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: patchright-cli
-Version: 0.6.0
+Version: 0.8.0
 Summary: Anti-detect browser automation CLI using Patchright (undetected Playwright fork)
 Project-URL: Homepage, https://github.com/AhaiMk01/patchright-cli
 Project-URL: Repository, https://github.com/AhaiMk01/patchright-cli
@@ -26,9 +26,12 @@ Requires-Dist: click
 Requires-Dist: patchright
 Requires-Dist: pyyaml
 Provides-Extra: dev
+Requires-Dist: fastmcp<5,>=3.0; extra == 'dev'
 Requires-Dist: pre-commit; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: fastmcp<5,>=3.0; extra == 'mcp'
 Description-Content-Type: text/markdown
 
 # patchright-cli
@@ -149,7 +152,7 @@ graph LR
 |-----------|------|
 | **Daemon** (`daemon.py`) | Long-running process managing browser sessions via Patchright. Auto-starts on first `open`. |
 | **CLI** (`cli.py`) | Thin client — connects, sends command, prints result, disconnects. Browser stays open. |
-| **Snapshot** (`snapshot.py`) | `TreeWalker`-based DOM scan assigning `data-patchright-ref` attributes for element targeting. |
+| **Snapshot** (`snapshot.py`) | Playwright `aria_snapshot()` accessibility tree, annotated with sequential `[ref=eN]` handles for element targeting. |
 
 ---
 
@@ -159,9 +162,12 @@ graph LR
 ### Core
 ```bash
 patchright-cli open [url]              # Launch browser
-patchright-cli open --persistent       # With persistent profile
+patchright-cli open --profile=work     # Named profile any session can use (logins persist)
 patchright-cli open --headless         # Run headless
-patchright-cli open --profile=<path>   # Custom profile directory
+patchright-cli open --profile=./dir    # A value with / or \ is a profile directory
+patchright-cli --tab <name> open <url> # Named tab: shared browser, own page/refs
+patchright-cli open --mobile           # Emulate a generic mobile device (Pixel 7)
+patchright-cli open --device="Pixel 5" # Emulate a specific Playwright device
 patchright-cli goto <url>              # Navigate
 patchright-cli click <ref>             # Click element
 patchright-cli click <ref> right       # Right-click
@@ -180,8 +186,13 @@ patchright-cli drag <from> <to>        # Drag and drop
 patchright-cli snapshot                # Accessibility snapshot
 patchright-cli snapshot -i             # Interactive elements only (recommended)
 patchright-cli snapshot --depth=3      # Limit depth
+patchright-cli snapshot --selector=CSS  # Snapshot a CSS-scoped subtree
 patchright-cli snapshot <ref>          # Snapshot element subtree
 patchright-cli snapshot --filename=f   # Save to custom path
+patchright-cli find "text"             # Search snapshot for text
+patchright-cli find --regex "a|b"      # Search by regex
+patchright-cli find "text" --all       # Include text/paragraph nodes
+patchright-cli find "text" --limit=50  # Cap hits (default 20)
 patchright-cli eval <expr>             # Run JavaScript
 patchright-cli eval --file=script.js   # Run JS from file
 patchright-cli run-code <code>         # Run JS with return value
@@ -190,6 +201,7 @@ patchright-cli screenshot              # Page screenshot
 patchright-cli screenshot --full-page  # Full scrollable page
 patchright-cli screenshot <ref>        # Element screenshot
 patchright-cli screenshot --filename=f # Save to custom path
+patchright-cli screenshot --hires      # Capture at device pixel ratio
 patchright-cli close                   # Close session
 ```
 
@@ -198,6 +210,10 @@ patchright-cli close                   # Close session
 patchright-cli go-back
 patchright-cli go-forward
 patchright-cli reload
+patchright-cli wait 500                 # Wait a fixed number of milliseconds
+patchright-cli wait --url="**/dashboard" # Wait for the URL to match (`*` never crosses a `/`)
+patchright-cli wait-for <ref>           # Wait until an element is visible
+patchright-cli wait-for <ref> --state=hidden
 ```
 
 ### Keyboard / Mouse
@@ -285,6 +301,9 @@ patchright-cli tracing-stop            # Saves .zip trace file
 patchright-cli video-start             # Start video recording (CDP screencast)
 patchright-cli video-stop              # Stop and save video (requires ffmpeg for .webm)
 patchright-cli video-stop --filename=recording.webm
+patchright-cli show --annotate          # Ask a human to mark up the page, wait for it
+patchright-cli video-show-actions       # Annotate each action in the recording
+patchright-cli video-hide-actions       # Stop annotating actions
 patchright-cli pdf --filename=page.pdf
 ```
 
@@ -317,13 +336,15 @@ patchright-cli install --skills        # Auto-install skills for detected AI age
 
 ### Sessions
 ```bash
-patchright-cli -s=mysession open https://example.com --persistent
+patchright-cli -s=mysession open https://example.com
 patchright-cli -s=mysession click e6
 patchright-cli -s=mysession close
 patchright-cli list                    # List all sessions
 patchright-cli close-all
 patchright-cli kill-all
-patchright-cli delete-data             # Delete persistent profile
+patchright-cli delete-data             # Delete the profile named after the session
+patchright-cli profile-list           # Profiles, size, and which session uses each
+patchright-cli profile-delete <name>  # Delete an idle named profile
 patchright-cli --port=9322 open        # Custom daemon port
 ```
 
@@ -354,6 +375,34 @@ patchright-cli install --skills
 
 </details>
 
+### MCP server
+
+MCP support is optional so the base CLI install stays small:
+
+```bash
+pip install 'patchright-cli[mcp]'
+
+# stdio (default)
+patchright-cli mcp
+
+# Streamable HTTP
+patchright-cli mcp --http --host=127.0.0.1 --port=8000
+```
+
+![How a remote MCP call reaches Chrome](docs/mcp-architecture.svg)
+
+The HTTP endpoint is `/mcp`. Set `PATCHRIGHT_CLI_MCP_TOKEN` to require `Authorization: Bearer <token>` on every request, and always set it before binding to `0.0.0.0`.
+
+File paths passed to MCP tools (uploads, state and cookie files, screenshot/PDF/snapshot output, profile directories) must be absolute and beneath the MCP root, so a client cannot reach arbitrary host files. Outputs without a path land in `<root>/output/`, which `browser_delete_output` can clean up. `patchright_eval` and `patchright_run_code` still run arbitrary JavaScript in the page, so protect HTTP deployments regardless.
+
+| Variable | Default | Effect |
+|---|---|---|
+| `PATCHRIGHT_CLI_MCP_TOKEN` | unset (no auth) | Bearer token required by the HTTP transport |
+| `PATCHRIGHT_CLI_MCP_ROOT` | working directory | Root that tool file paths must sit beneath |
+| `PATCHRIGHT_CLI_MCP_UNRESTRICTED_FILESYSTEM` | unset | `1` drops the path check and enables `patchright_install_skills` |
+| `PATCHRIGHT_CLI_MCP_HEADLESS` | unset (headed) | `1` makes `patchright_open` default to headless, for hosts without a display |
+| `PATCHRIGHT_CLI_MCP_DAEMON_PORT` | `9321` | Daemon port the tools talk to |
+
 ### Skill docs
 
 | File | Topic |

{patchright_cli-0.6.0 → patchright_cli-0.8.0}/README.md

@@ -116,7 +116,7 @@ graph LR
 |-----------|------|
 | **Daemon** (`daemon.py`) | Long-running process managing browser sessions via Patchright. Auto-starts on first `open`. |
 | **CLI** (`cli.py`) | Thin client — connects, sends command, prints result, disconnects. Browser stays open. |
-| **Snapshot** (`snapshot.py`) | `TreeWalker`-based DOM scan assigning `data-patchright-ref` attributes for element targeting. |
+| **Snapshot** (`snapshot.py`) | Playwright `aria_snapshot()` accessibility tree, annotated with sequential `[ref=eN]` handles for element targeting. |
 
 ---
 
@@ -126,9 +126,12 @@ graph LR
 ### Core
 ```bash
 patchright-cli open [url]              # Launch browser
-patchright-cli open --persistent       # With persistent profile
+patchright-cli open --profile=work     # Named profile any session can use (logins persist)
 patchright-cli open --headless         # Run headless
-patchright-cli open --profile=<path>   # Custom profile directory
+patchright-cli open --profile=./dir    # A value with / or \ is a profile directory
+patchright-cli --tab <name> open <url> # Named tab: shared browser, own page/refs
+patchright-cli open --mobile           # Emulate a generic mobile device (Pixel 7)
+patchright-cli open --device="Pixel 5" # Emulate a specific Playwright device
 patchright-cli goto <url>              # Navigate
 patchright-cli click <ref>             # Click element
 patchright-cli click <ref> right       # Right-click
@@ -147,8 +150,13 @@ patchright-cli drag <from> <to>        # Drag and drop
 patchright-cli snapshot                # Accessibility snapshot
 patchright-cli snapshot -i             # Interactive elements only (recommended)
 patchright-cli snapshot --depth=3      # Limit depth
+patchright-cli snapshot --selector=CSS  # Snapshot a CSS-scoped subtree
 patchright-cli snapshot <ref>          # Snapshot element subtree
 patchright-cli snapshot --filename=f   # Save to custom path
+patchright-cli find "text"             # Search snapshot for text
+patchright-cli find --regex "a|b"      # Search by regex
+patchright-cli find "text" --all       # Include text/paragraph nodes
+patchright-cli find "text" --limit=50  # Cap hits (default 20)
 patchright-cli eval <expr>             # Run JavaScript
 patchright-cli eval --file=script.js   # Run JS from file
 patchright-cli run-code <code>         # Run JS with return value
@@ -157,6 +165,7 @@ patchright-cli screenshot              # Page screenshot
 patchright-cli screenshot --full-page  # Full scrollable page
 patchright-cli screenshot <ref>        # Element screenshot
 patchright-cli screenshot --filename=f # Save to custom path
+patchright-cli screenshot --hires      # Capture at device pixel ratio
 patchright-cli close                   # Close session
 ```
 
@@ -165,6 +174,10 @@ patchright-cli close                   # Close session
 patchright-cli go-back
 patchright-cli go-forward
 patchright-cli reload
+patchright-cli wait 500                 # Wait a fixed number of milliseconds
+patchright-cli wait --url="**/dashboard" # Wait for the URL to match (`*` never crosses a `/`)
+patchright-cli wait-for <ref>           # Wait until an element is visible
+patchright-cli wait-for <ref> --state=hidden
 ```
 
 ### Keyboard / Mouse
@@ -252,6 +265,9 @@ patchright-cli tracing-stop            # Saves .zip trace file
 patchright-cli video-start             # Start video recording (CDP screencast)
 patchright-cli video-stop              # Stop and save video (requires ffmpeg for .webm)
 patchright-cli video-stop --filename=recording.webm
+patchright-cli show --annotate          # Ask a human to mark up the page, wait for it
+patchright-cli video-show-actions       # Annotate each action in the recording
+patchright-cli video-hide-actions       # Stop annotating actions
 patchright-cli pdf --filename=page.pdf
 ```
 
@@ -284,13 +300,15 @@ patchright-cli install --skills        # Auto-install skills for detected AI age
 
 ### Sessions
 ```bash
-patchright-cli -s=mysession open https://example.com --persistent
+patchright-cli -s=mysession open https://example.com
 patchright-cli -s=mysession click e6
 patchright-cli -s=mysession close
 patchright-cli list                    # List all sessions
 patchright-cli close-all
 patchright-cli kill-all
-patchright-cli delete-data             # Delete persistent profile
+patchright-cli delete-data             # Delete the profile named after the session
+patchright-cli profile-list           # Profiles, size, and which session uses each
+patchright-cli profile-delete <name>  # Delete an idle named profile
 patchright-cli --port=9322 open        # Custom daemon port
 ```
 
@@ -321,6 +339,34 @@ patchright-cli install --skills
 
 </details>
 
+### MCP server
+
+MCP support is optional so the base CLI install stays small:
+
+```bash
+pip install 'patchright-cli[mcp]'
+
+# stdio (default)
+patchright-cli mcp
+
+# Streamable HTTP
+patchright-cli mcp --http --host=127.0.0.1 --port=8000
+```
+
+![How a remote MCP call reaches Chrome](docs/mcp-architecture.svg)
+
+The HTTP endpoint is `/mcp`. Set `PATCHRIGHT_CLI_MCP_TOKEN` to require `Authorization: Bearer <token>` on every request, and always set it before binding to `0.0.0.0`.
+
+File paths passed to MCP tools (uploads, state and cookie files, screenshot/PDF/snapshot output, profile directories) must be absolute and beneath the MCP root, so a client cannot reach arbitrary host files. Outputs without a path land in `<root>/output/`, which `browser_delete_output` can clean up. `patchright_eval` and `patchright_run_code` still run arbitrary JavaScript in the page, so protect HTTP deployments regardless.
+
+| Variable | Default | Effect |
+|---|---|---|
+| `PATCHRIGHT_CLI_MCP_TOKEN` | unset (no auth) | Bearer token required by the HTTP transport |
+| `PATCHRIGHT_CLI_MCP_ROOT` | working directory | Root that tool file paths must sit beneath |
+| `PATCHRIGHT_CLI_MCP_UNRESTRICTED_FILESYSTEM` | unset | `1` drops the path check and enables `patchright_install_skills` |
+| `PATCHRIGHT_CLI_MCP_HEADLESS` | unset (headed) | `1` makes `patchright_open` default to headless, for hosts without a display |
+| `PATCHRIGHT_CLI_MCP_DAEMON_PORT` | `9321` | Daemon port the tools talk to |
+
 ### Skill docs
 
 | File | Topic |

patchright_cli-0.8.0/docs/mcp-architecture.svg

@@ -0,0 +1,120 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="470" viewBox="0 0 1200 470" role="img" aria-label="A remote MCP client sends tools/call over HTTP across a network boundary guarded by an optional Bearer token to the patchright-cli MCP server on the host. The server spawns one short-lived CLI process per call, which sends length-prefixed JSON over TCP to the long-lived daemon. The daemon drives real Chrome over CDP; headed Chrome draws on an Xvfb display and loads websites over HTTPS. Output files land in the root's output directory on the host.">
+        <style>
+  svg { --bg: #ffffff; --fg: #1b2230; --muted: #5d6778; --line: #c9cfd9; --accent: #c2410c; --host: #eef1f6;
+        color: var(--fg); font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; }
+  @media (prefers-color-scheme: dark) {
+    svg { --bg: #0d1117; --fg: #e6edf3; --muted: #9aa4b4; --line: #3a4352; --accent: #fb923c; --host: #161b22; }
+  }
+  .bg { fill: var(--bg); }
+  .box { fill: var(--bg); stroke: currentColor; stroke-width: 1.4; }
+  .ghost { fill: var(--bg); stroke: var(--line); stroke-width: 1.2; }
+  .hostbg { fill: var(--host); stroke: var(--line); stroke-width: 1.2; }
+  .t { fill: currentColor; font-size: 14px; font-weight: 600; text-anchor: middle; }
+  .s { fill: var(--muted); font-size: 11.5px; text-anchor: middle; }
+  .m { fill: var(--muted); font-family: ui-monospace, Consolas, monospace; font-size: 11px; text-anchor: middle; }
+  .lbl { fill: currentColor; font-size: 12px; text-anchor: middle; paint-order: stroke; stroke: var(--bg); stroke-width: 5px; stroke-linejoin: round; }
+  .lbl.start { text-anchor: start; }
+  .region { fill: var(--muted); font-family: ui-monospace, Consolas, monospace; font-size: 11px; letter-spacing: 0.05em; text-transform: uppercase; }
+  .edge { stroke: currentColor; stroke-width: 1.4; fill: none; }
+  .edge.dim { stroke: var(--muted); stroke-dasharray: 4 3; }
+  .boundary { stroke: var(--accent); stroke-width: 1.6; stroke-dasharray: 6 5; }
+  .warn { fill: var(--accent); font-size: 12px; font-weight: 600; text-anchor: middle; paint-order: stroke; stroke: var(--bg); stroke-width: 5px; }
+  .head { fill: currentColor; }
+  .head.dim { fill: var(--muted); }
+</style>
+        <rect class="bg" x="0" y="0" width="1200" height="470"/>
+        <defs>
+          <marker id="ah" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">
+            <path class="head" d="M0,0 L10,5 L0,10 z"/>
+          </marker>
+          <marker id="ahd" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="8" markerHeight="8" orient="auto-start-reverse">
+            <path class="head dim" d="M0,0 L10,5 L0,10 z"/>
+          </marker>
+        </defs>
+
+        <!-- host region -->
+        <rect class="hostbg" x="250" y="30" width="820" height="420" rx="10"/>
+        <text class="region" x="268" y="54">Host · container or server</text>
+        <text class="region" x="20" y="54">Remote machine</text>
+        <text class="region" x="1100" y="54">Internet</text>
+
+        <!-- trust boundary -->
+        <line class="boundary" x1="205" y1="24" x2="205" y2="456"/>
+        <text class="warn" x="205" y="300">trust boundary</text>
+        <text class="warn" x="205" y="317" style="font-weight:400">optional Bearer token</text>
+
+        <!-- client -->
+        <rect class="box" x="20" y="170" width="140" height="80" rx="6"/>
+        <text class="t" x="90" y="205">MCP client</text>
+        <text class="s" x="90" y="225">Claude Code, agents</text>
+
+        <!-- client <-> server -->
+        <line class="edge" x1="160" y1="195" x2="268" y2="195" marker-end="url(#ah)"/>
+        <text class="lbl" x="215" y="187">tools/call</text>
+        <line class="edge" x1="270" y1="228" x2="162" y2="228" marker-end="url(#ah)"/>
+        <text class="lbl" x="215" y="246">text · PNG · YAML</text>
+
+        <!-- MCP server -->
+        <rect class="box" x="270" y="170" width="170" height="80" rx="6"/>
+        <text class="t" x="355" y="198">MCP server</text>
+        <text class="m" x="355" y="217">mcp --http :8000/mcp</text>
+        <text class="s" x="355" y="236">checks session, paths</text>
+
+        <!-- server -> CLI -->
+        <line class="edge" x1="440" y1="210" x2="518" y2="210" marker-end="url(#ah)"/>
+        <text class="lbl" x="479" y="202">spawns</text>
+
+        <!-- CLI process stack -->
+        <rect class="ghost" x="536" y="158" width="160" height="80" rx="6"/>
+        <rect class="ghost" x="528" y="164" width="160" height="80" rx="6"/>
+        <rect class="box" x="520" y="170" width="160" height="80" rx="6"/>
+        <text class="t" x="600" y="198">CLI process</text>
+        <text class="m" x="600" y="217">python -m patchright_cli</text>
+        <text class="s" x="600" y="236">one per call, exits</text>
+
+        <!-- CLI -> daemon -->
+        <line class="edge" x1="696" y1="210" x2="778" y2="210" marker-end="url(#ah)"/>
+        <text class="lbl" x="737" y="202">TCP · JSON</text>
+        <text class="s" x="737" y="229">starts it</text>
+        <text class="s" x="737" y="243">if absent</text>
+
+        <!-- daemon -->
+        <rect class="box" x="780" y="170" width="120" height="80" rx="6"/>
+        <text class="t" x="840" y="198">Daemon</text>
+        <text class="m" x="840" y="217">127.0.0.1:9321</text>
+        <text class="s" x="840" y="236">long-lived</text>
+
+        <!-- daemon -> chrome -->
+        <line class="edge" x1="900" y1="210" x2="948" y2="210" marker-end="url(#ah)"/>
+        <text class="lbl" x="924" y="202">CDP</text>
+
+        <!-- chrome -->
+        <rect class="box" x="950" y="170" width="100" height="80" rx="6"/>
+        <text class="t" x="1000" y="205">Chrome</text>
+        <text class="s" x="1000" y="225">headed or headless</text>
+
+        <!-- xvfb -->
+        <rect class="ghost" x="950" y="72" width="100" height="48" rx="6"/>
+        <text class="t" x="1000" y="96" style="font-weight:500">Xvfb :99</text>
+        <text class="s" x="1000" y="112">headed only</text>
+        <line class="edge dim" x1="1000" y1="120" x2="1000" y2="168" marker-end="url(#ahd)"/>
+        <text class="lbl start" x="1008" y="149" style="fill:var(--muted)">DISPLAY</text>
+
+        <!-- chrome -> web -->
+        <line class="edge" x1="1050" y1="210" x2="1098" y2="210" marker-end="url(#ah)"/>
+        <text class="lbl" x="1075" y="202">HTTPS</text>
+        <rect class="box" x="1100" y="170" width="80" height="80" rx="6"/>
+        <text class="t" x="1140" y="214">Websites</text>
+
+        <!-- output dir -->
+        <rect class="box" x="520" y="350" width="380" height="60" rx="6"/>
+        <text class="m" x="710" y="375" style="fill:currentColor;font-size:12px">&lt;root&gt;/output/</text>
+        <text class="s" x="710" y="395">screenshots · PDFs · snapshots · state files</text>
+
+        <line class="edge" x1="840" y1="250" x2="840" y2="348" marker-end="url(#ah)"/>
+        <text class="lbl start" x="848" y="304">writes files</text>
+        <line class="edge dim" x1="600" y1="252" x2="600" y2="348" marker-end="url(#ahd)"/>
+        <text class="lbl start" x="608" y="304" style="fill:var(--muted)">cwd</text>
+        <polyline class="edge dim" points="355,250 355,380 518,380" marker-end="url(#ahd)"/>
+        <text class="lbl" x="437" y="372" style="fill:var(--muted)">delete_output</text>
+      </svg>

{patchright_cli-0.6.0 → patchright_cli-0.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "patchright-cli"
-version = "0.6.0"
+version = "0.8.0"
 description = "Anti-detect browser automation CLI using Patchright (undetected Playwright fork)"
 license = "Apache-2.0"
 requires-python = ">=3.10"
@@ -54,16 +54,21 @@ markers = [
 ]
 
 [project.optional-dependencies]
+mcp = [
+    "fastmcp>=3.0,<5",
+]
 dev = [
     "pytest>=8.0",
     "pytest-asyncio>=0.23",
     "pre-commit",
+    "fastmcp>=3.0,<5",
 ]
 
 [dependency-groups]
 dev = [
     "pytest>=8.0",
     "pytest-asyncio>=0.23",
+    "fastmcp>=3.0,<5",
 ]
 
 [tool.ruff]