Metadata-Version: 2.4
Name: botbrowser
Version: 0.1.0
Summary: Token-efficient web content extraction for LLM agents
Project-URL: Homepage, https://github.com/AmplifyCo/botbrowser
Project-URL: Repository, https://github.com/AmplifyCo/botbrowser
Project-URL: Issues, https://github.com/AmplifyCo/botbrowser/issues
License-Expression: MIT
Keywords: ai-agents,content-extraction,llm,token-optimization,web-scraping
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: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: markdownify>=0.13.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: trafilatura>=1.12.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# BotBrowser (Python)

Token-efficient web content extraction for LLM agents.

## Install

```bash
pip install botbrowser
```

## Usage

```python
from botbrowser import extract

result = extract("https://example.com")

print(result.content)                          # clean markdown
print(result.metadata.token_savings_percent)   # e.g. 94
print(result.title)                            # page title
print(result.links)                            # extracted links
```

## Options

```python
result = extract(
    "https://example.com",
    format="text",          # "markdown" (default) or "text"
    timeout=10000,          # request timeout in ms (default: 15000)
    include_links=False,    # extract links (default: True)
)
```

## Client Mode

If you're running the BotBrowser REST API server, you can use the client:

```python
from botbrowser import BotBrowserClient

client = BotBrowserClient("http://localhost:3000")
result = client.extract("https://example.com")
```

## License

MIT
