Metadata-Version: 2.4
Name: PyMCP_Browser
Version: 2.0.0
Summary: Browser-control API (REST + MCP) — Playwright/Patchright/Camoufox engines with macro recording, stealth, IMAP/SMTP helpers, and a typed FastAPI surface.
Author: Caddie253
License: MIT
Project-URL: Homepage, https://codeberg.org/pymcpbrowser/PyMCP_Browser
Project-URL: Source, https://codeberg.org/pymcpbrowser/PyMCP_Browser
Keywords: browser-automation,playwright,patchright,camoufox,mcp,fastapi,macros,stealth
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Framework :: FastAPI
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: playwright>=1.49
Requires-Dist: fastapi>=0.115
Requires-Dist: uvicorn>=0.30
Requires-Dist: pydantic>=2.7
Requires-Dist: pydantic-settings>=2.4
Requires-Dist: typer>=0.12
Requires-Dist: loguru>=0.7
Requires-Dist: sqlmodel>=0.0.22
Requires-Dist: jsonschema>=4.21
Requires-Dist: browserforge>=1.2
Requires-Dist: tf-playwright-stealth>=1.1
Requires-Dist: mcp>=1.2
Requires-Dist: anyio>=4.4
Requires-Dist: httpx>=0.27
Requires-Dist: aioimaplib>=1.0.1
Requires-Dist: aiosmtplib>=3.0
Requires-Dist: pyotp>=2.9
Requires-Dist: faker>=33.0
Requires-Dist: phonenumbers>=8.13
Requires-Dist: pyperclip>=1.9
Provides-Extra: patchright
Requires-Dist: patchright>=1.49.0; extra == "patchright"
Provides-Extra: camoufox
Requires-Dist: camoufox[geoip]>=0.4; extra == "camoufox"
Provides-Extra: all-engines
Requires-Dist: patchright>=1.49.0; extra == "all-engines"
Requires-Dist: camoufox[geoip]>=0.4; extra == "all-engines"
Dynamic: license-file

# PyMCP_Browser

Browser-control API exposing a typed FastAPI REST surface **and** an MCP (Model Context Protocol) server over the same engine. Supports Playwright, Patchright, and Camoufox backends with stealth, macro recording, and IMAP/SMTP helpers built in.

## Install

```
pip install PyMCP_Browser
```

Optional engines:

```
pip install "PyMCP_Browser[patchright]"
pip install "PyMCP_Browser[camoufox]"
pip install "PyMCP_Browser[all-engines]"
```

After install, fetch the browser binaries:

```
playwright install chromium
```

## Quick start

Run the REST + MCP server:

```
pymcp-v2 serve
```

Or invoke as a module:

```
python -m pymcp_browser.v2 serve
python -m pymcp_browser.v2 mcp     # MCP-only mode
```

## Features

- **Multiple stealth engines** — Playwright, Patchright, Camoufox (opt-in via extras).
- **REST + MCP** — same engine, two transports.
- **Macro recording / replay** — JSONL macros captured live, replayed deterministically.
- **Session pool** — bounded concurrent sessions with idle TTL.
- **Stealth out-of-the-box** — `tf-playwright-stealth` + `browserforge` fingerprints.
- **Account helpers** — IMAP/SMTP/OTP utilities for sign-up automation flows.

## Configuration

Copy `.env.example` to `.env` and tune. See `CLAUDE.md` for architecture notes.

## License

MIT
