Clawifi

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