clawifi
Official Python SDK, CLI, and MCP server for Clawifi, 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 (hosted API version 1.4.0 at time of release). 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 · clawifi.qzz.io/trust · clawifi.qzz.io/status.
Install
pip install clawifi
Get an API key
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:
export CLAWIFI_API_KEY="clawifi_live_..."
Quicktest
clawifi quicktest --url https://example.com
Use as an MCP server
clawifi mcp config
prints a ready-to-paste MCP client config. The MCP server itself runs as:
clawifi-mcp
reading CLAWIFI_API_KEY from the environment.
Use as a Python SDK
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. With query, only the passages that answer it. |
scrape |
Scrape a URL with source-aware routing and return structured content. With query, only the passages that answer it. |
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 for the full API reference, MCP tool list, and CLI command reference.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for clawifi 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| clawifi-0.2.0.tar.gz | 14.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| clawifi-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 28.4 kB
Release files / clawifi-0.2.0.tar.gz
| Download URL | clawifi-0.2.0.tar.gz |
|---|---|
| Size | 14.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5df6fe95cc7a8c6072ac0c4149e976a80617614b17b85eb5af709ea55600eb62
|
|
BLAKE2b-256 checksum How to use checksums |
e7de8786f5d60e2309f8e2215b36b68bbc36e34ce57e103a111b9a86484455a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.7
|
Release files / clawifi-0.2.0-py3-none-any.whl
| Download URL | clawifi-0.2.0-py3-none-any.whl |
|---|---|
| Size | 13.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bb618728f1a1d019b22064aab5e6c1da75df5427cbbf61a82262a8cbb248d14d
|
|
BLAKE2b-256 checksum How to use checksums |
70a336af6fe8d0e5d2595c5c4566b4f65ad929cdb700931ebe22bff8d26b60f9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.7
|
Security for clawifi 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
