Back to Directory/Search & Knowledge

Clawifi

Agent-native internet gateway: typed search, fetch, scrape, crawl, and extract via the Clawifi API.

Search & KnowledgePythonv0.1.1

clawifi

PyPI Python License MCP GitHub stars

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

ToolWhat it does
fetchFetch a single URL and return its extracted content.
scrapeScrape a URL with source-aware routing and return structured content.
search_freeRun a free-tier web search and return results.
extractExtract structured data from a URL.
map_siteMap a site's discoverable URLs starting from a seed URL.
crawlStart an asynchronous crawl from a seed URL; returns a crawl_id to poll.
get_crawlGet the current status and results of a crawl.
create_jobCreate an asynchronous job for a billable operation; returns a job_id to poll.
get_jobGet the current status and results of a job.
accountGet the authenticated account's profile and plan.
creditsGet the authenticated account's credit usage and remaining balance.
list_historyList past requests for the authenticated account.
list_monitorsList 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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx clawifi

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-atakanelik34-clawifi-mcp": {
      "command": "uvx",
      "args": [
        "clawifi"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

clawifipypi

Compatible MCP Clients

Clawifi works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More