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. 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. |
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 for the full API reference, MCP tool list, and CLI command reference.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for clawifi 0.1.1
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.1.1.tar.gz | 14.1 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| clawifi-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 27.6 kB
Release files / clawifi-0.1.1.tar.gz
| Download URL | clawifi-0.1.1.tar.gz |
|---|---|
| Size | 14.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c0fa4c5667228d6ed1764e75e1e001d8ddaed86479b0f99068ebfcde9cb08a1b
|
|
BLAKE2b-256 checksum How to use checksums |
a7b2d48f52dc24bb61c31d67d6f42a8fdfe48ebdc329d8a82b26faf05b3ee355
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.7
|
Release files / clawifi-0.1.1-py3-none-any.whl
| Download URL | clawifi-0.1.1-py3-none-any.whl |
|---|---|
| Size | 13.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4d55d65af34aed55442183ccbbb7a394834a26902210bc3fe79254c862fe751e
|
|
BLAKE2b-256 checksum How to use checksums |
54e3a258a0b9c74e2661e045aeee09b898abc5890eda2eda30a60e70315abd2f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.7
|
Security for clawifi 0.1.1
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.
