Clawifi
Agent-native internet gateway: typed search, fetch, scrape, crawl, and extract via the Clawifi API.
Open source Open in the app JSON README (API)
About
Agent-native internet gateway: typed search, fetch, scrape, crawl, and extract via the Clawifi API.
Details
- Kind
- MCP servers
- Topic
- Web search, scraping & browser
- Publisher
- atakanelik34
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.0
- Last push
- 2026-07-28T06:06:06Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:02:27
- Updated
- 2026-08-29 03:02:27
- Origin id
io.github.atakanelik34/clawifi-mcp
README
# clawifi
<!-- mcp-name: io.github.atakanelik34/clawifi-mcp -->
[](https://pypi.org/project/clawifi/)
[](https://pypi.org/project/clawifi/)
[](LICENSE)
[](https://clawifi.qzz.io/docs)
[](https://github.com/atakanelik34/clawifi-mcp/stargazers)
Official Python SDK, CLI, and MCP server for [Clawifi](https://clawifi.qzz.io), the agent-native internet gateway: one typed API and MCP surface for fetching, scraping, searching, and crawling the web on behalf of an agent, with Cloudflare-challenge handling and realistic browser fingerprinting behind it.
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. Live capability evidence and uptime: [clawifi.qzz.io/benchmarks](https://clawifi.qzz.io/benchmarks) · [clawifi.qzz.io/trust](https://clawifi.qzz.io/trust) · [clawifi.qzz.io/status](https://clawifi.qzz.io/status).
## 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`.
## MCP tools
| Tool | What it does |
| --- | --- |
| `fetch` | Fetch a single URL and return its extracted content. |
| `scrape` | Scrape a URL with source-aware routing and return structured content. |
| `search_free` | Run a free-tier web search and return results. |
| `extract` | Extract structured data from a URL. |
| `map_site` | Map a site's discoverable URLs starting from a seed URL. |
| `crawl` | Start an asynchronous crawl from a seed URL; returns a `crawl_id` to poll. |
| `get_crawl` | Get the current status and results of a crawl. |
| `create_job` | Create an asynchronous job for a billable operation; returns a `job_id` to poll. |
| `get_job` | Get the current status and results of a job. |
| `account` | Get the authenticated account's profile and plan. |
| `credits` | Get the authenticated account's credit usage and remaining balance. |
| `list_history` | List past requests for the authenticated account. |
| `list_monitors` | List configured Evidence Monitor checks for the authenticated account. |
## 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