Metadata-Version: 2.5
Name: blazecrawl
Version: 0.1.1
Summary: Python SDK for BlazeCrawl Core (self-hosted web-data engine).
Project-URL: Homepage, https://github.com/danishxsethi/blazecrawl
Project-URL: Repository, https://github.com/danishxsethi/blazecrawl
Project-URL: Issues, https://github.com/danishxsethi/blazecrawl/issues
Project-URL: Documentation, https://github.com/danishxsethi/blazecrawl/tree/main/sdks/python
License: Apache-2.0
Requires-Python: >=3.9
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# blazecrawl (Python SDK)

Python API client for a running BlazeCrawl Core server.

## Install

```bash
pip install blazecrawl==0.1.1
```

The server is separate. Run `blazecrawl-core` locally or point the client at a
self-hosted instance with `base_url`.

## Authenticate and scrape

```python
from blazecrawl import BlazeCrawl, BlazeCrawlError

try:
    with BlazeCrawl(
        api_key="blz_local_...",
        base_url="http://127.0.0.1:8000",
    ) as client:
        document = client.scrape("https://example.com")
        print(document["markdown"])
except BlazeCrawlError as exc:
    print(f"BlazeCrawl request failed: {exc}")
```

`map()` discovers site URLs. `crawl()` starts a crawl and returns its job
reference; poll that job through the client API until it completes.
