Metadata-Version: 2.1
Name: hostdirect-client
Version: 1.0.1
Summary: Read-only HostDirect hosting comparison SDK and CLI
Author: HostDirect.nl
Home-page: https://hostdirect.nl/
Project-URL: Documentation, https://hostdirect.nl/docs/
Project-URL: Source, https://hostdirect.nl/sdk/hostdirect_client.py
Project-URL: Issues, https://hostdirect.nl/contact/
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent

# HostDirect public catalogue SDK and CLI

Read-only Python client for [HostDirect.nl](https://hostdirect.nl/), a Dutch editorial comparison site for hosting, email and cloud-storage packages. Python 3.9 or newer; no dependencies, account or API key.

## Use

```python
from hostdirect_client import Client, HostDirectError
client = Client(timeout=20)
result = client.compare(["cloud86", "mijnhost"])
print(result["providers"])
```

```text
python -m hostdirect_client search --category email
hostdirect provider cloud86
hostdirect compare cloud86 mijnhost
```

`catalog()` obtains the complete public catalogue in one request. `search()`, `provider()` and `compare()` filter locally. No user questions or credentials are transmitted. Errors raise `HostDirectError`; the CLI writes JSON errors to stderr and exits with code 1. There are no automatic retries.

## Source and price limitations

Preserve `price.status`, original checked dates and source URLs. Historical prices are not current offers; null is unknown, not zero. The selected providers are not the entire market. Purchases take place at the provider. The client does not create accounts, purchase hosting, change DNS or access private data.

- [API, MCP and SDK documentation](https://hostdirect.nl/docs/)
- [Agent usage guide](https://hostdirect.nl/AGENTS.md)
- [OpenAPI](https://hostdirect.nl/openapi.json)
- [Editorial methodology](https://hostdirect.nl/redactionele-verantwoording/)
- [Contact and corrections](https://hostdirect.nl/contact/)

Version 1.0.1 improves distribution metadata; the public read-only API remains compatible.
