Metadata-Version: 2.4
Name: phrona
Version: 0.1.1
Summary: High-performance metasearch engine library - Rust core with Python bindings
License-Expression: AGPL-3.0-only
Project-URL: Homepage, https://github.com/alvaro-co/phrona
Project-URL: Repository, https://github.com/alvaro-co/phrona
Keywords: phrona,search-engine,web-search,api,mcp
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Rust
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Requires-Python: <3.14,>=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# phrona (Python)

Python bindings for the [phrona](https://crates.io/crates/phrona)
high-performance metasearch engine (Rust core via pyo3). Queries 26 search
engines across 5 categories in parallel and returns merged, deduplicated and
ranked results.

## Install

```bash
pip install phrona
```

Wheels are published for CPython 3.9-3.13 on linux (x86_64 / aarch64),
macOS (x86_64 / arm64) and Windows (x86_64), plus an sdist for other
platforms (needs a Rust toolchain).

## Quick start

```python
import phrona

phrona.search("rust programming", engines=["bing", "brave"])
phrona.suggest("rus")
```

## Features

- 26 engines, 5 categories (web, images, news, videos, books) + suggestions.
- Impersonated HTTP/2 with TLS fingerprint spoofing.
- Cross-engine merging: dedup, ranking, per-engine error reporting.
- Time ranges, safesearch, regions, per-engine filter strings, proxies.

See the [Python reference](https://github.com/alvaro-co/phrona/blob/main/docs/python.md)
for the full API.

## License

AGPL-3.0 — see the main repository for details.
