Metadata-Version: 2.4
Name: auto-browser-client
Version: 1.2.1
Summary: Python client SDK and MCP stdio bridge for Auto Browser
License: MIT
Project-URL: Homepage, https://github.com/LvcidPsyche/auto-browser
Project-URL: Repository, https://github.com/LvcidPsyche/auto-browser
Project-URL: Changelog, https://github.com/LvcidPsyche/auto-browser/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/LvcidPsyche/auto-browser/issues
Keywords: auto-browser,mcp,browser-automation,playwright
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-asyncio; extra == "dev"
Requires-Dist: respx; extra == "dev"

# auto-browser-client

Python SDK and MCP stdio bridge for the [Auto Browser](https://github.com/LvcidPsyche/auto-browser) REST API.

## SDK

```python
from auto_browser_client import AutoBrowserClient

client = AutoBrowserClient("http://localhost:8000", token="secret")
session = client.create_session(start_url="https://example.com")
client.navigate(session["id"], "https://example.com/dashboard")
client.close_session(session["id"])
```

## MCP stdio bridge

This package also ships the `auto-browser-mcp` console script, which bridges
stdio MCP clients (Claude Desktop, Cursor, ...) to a running Auto Browser
controller:

```bash
auto-browser-mcp --base-url http://127.0.0.1:8000/mcp
```

Or zero-install via [uv](https://docs.astral.sh/uv/): `uvx auto-browser-mcp`
(resolved through the [auto-browser-mcp](https://pypi.org/project/auto-browser-mcp/)
metapackage).

The server itself is Docker-first — see the
[Auto Browser repository](https://github.com/LvcidPsyche/auto-browser) to run it.
