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.2.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. |
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.2
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.2.tar.gz | 14.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| clawifi-0.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 27.7 kB
Release files / clawifi-0.1.2.tar.gz
| Download URL | clawifi-0.1.2.tar.gz |
|---|---|
| Size | 14.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
185deb0fb9f1ce2b67ded3f4afa77c9a7e177eda345a1cf679a62e176d0d692e
|
|
BLAKE2b-256 checksum How to use checksums |
b7e53073c941455fbece65e5d7712bc8959e8da75ec78a8b75f2bcdf81348d30
|
| 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.2-py3-none-any.whl
| Download URL | clawifi-0.1.2-py3-none-any.whl |
|---|---|
| Size | 13.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
247bacff8504a73510b82843de0a2a595f081557b465934791f6487696a4d7b9
|
|
BLAKE2b-256 checksum How to use checksums |
e3712fcbc5f0d7cd55db5533157596a6548d755a987c719b782b75d29c6de171
|
| 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.2
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.
