Metadata-Version: 2.4
Name: clawifi
Version: 0.1.0
Summary: Official Python SDK, CLI, and MCP server for Clawifi, the agent-native internet gateway.
License-Expression: MIT
Project-URL: Homepage, https://clawifi.qzz.io
Project-URL: Documentation, https://clawifi.qzz.io/docs
Project-URL: Repository, https://github.com/atakanelik34/clawifi-mcp
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27.2
Requires-Dist: mcp>=1.2.0
Provides-Extra: test
Requires-Dist: pytest>=8.3.3; extra == "test"
Requires-Dist: pytest-asyncio>=0.24.0; extra == "test"
Dynamic: license-file

# clawifi

<!-- mcp-name: io.github.atakanelik34/clawifi-mcp -->

Official Python SDK, CLI, and MCP server for [Clawifi](https://clawifi.qzz.io), the agent-native internet gateway.

This package is a thin client over the hosted Clawifi API. It does not include the Clawifi server, browser runtime, or Playwright — those run on Clawifi's infrastructure.

## Install

```bash
pip install clawifi
```

## Get an API key

```bash
clawifi signup --email you@example.com --password "a strong password"
```

This creates an account, grants 1,000 free credits, and prints an API key. Export it:

```bash
export CLAWIFI_API_KEY="clawifi_live_..."
```

## Quicktest

```bash
clawifi quicktest --url https://example.com
```

## Use as an MCP server

```bash
clawifi mcp config
```

prints a ready-to-paste MCP client config. The MCP server itself runs as:

```bash
clawifi-mcp
```

reading `CLAWIFI_API_KEY` from the environment.

## Use as a Python SDK

```python
from clawifi import Clawifi

client = Clawifi()  # reads CLAWIFI_API_KEY from the environment
page = client.fetch("https://example.com")
print(page["success"])
```

An async client is also available as `clawifi.AsyncClawifi`.

## Documentation

See [clawifi.qzz.io/docs](https://clawifi.qzz.io/docs) for the full API reference, MCP tool list, and CLI command reference.

## License

MIT
