# Web search and page reading for Claude Code

> One command gives Claude Code a set of web tools: search many engines as one, read pages and PDFs, and get back the passages that answer the question, each with its source.

Canonical page: https://clawifi.dev/for/claude-code

## What Clawifi gives Claude Code

Claude Code works in your terminal and your repository. With Clawifi connected it can check a library’s current docs, read a changelog or an issue thread, and quote the passage it relied on, without leaving the session.

- **Search:** `search_free` searches many engines as one and returns ranked results with their sources.
- **Read:** `fetch_url` and `scrape_url` read pages and PDFs as Markdown; with a `query`, `scrape_url` returns only the passages that answer it.
- **Parse and discover:** `extract_url` pulls structured fields from a page; `map_site` lists a site’s URLs; `start_crawl` and `get_crawl` read several pages.
- **Jobs, history and monitors:** `create_job`, `get_job`, `list_history` and `list_monitors` for longer runs and scheduled checks.
- **Cost first:** `estimate` prices a call before it runs, and the account tools show your credits.

## Set it up

### 1. Get an API key

Create an account at [clawifi.dev/signup](https://clawifi.dev/signup). The Free plan includes 1,000 credits a month. Copy the key the console shows you (it is shown once) and keep it in an environment variable, `CLAWIFI_API_KEY`.

### 2. Add the hosted server

Run this once. It registers Clawifi’s hosted MCP server over HTTP and sends your key as a bearer token; nothing to install.

**Claude Code**

```sh
claude mcp add --transport http clawifi https://api.clawifi.dev/mcp \
  --header "Authorization: Bearer $CLAWIFI_API_KEY"
```

### 3. Or run it locally

If you prefer a local server, install the package and add it with your key. Both use the same tools and credits.

**Terminal**

```sh
pip install clawifi
claude mcp add clawifi -e CLAWIFI_API_KEY=your_key -- clawifi-mcp
```

### 4. Ask for something on the web

Start a new session and ask a question that needs the web, naming Clawifi if you want Claude Code to use it.

Sources for this setup: [Clients](https://clawifi.dev/docs/clients) · [Remote MCP](https://clawifi.dev/docs/remote-mcp). Clawifi works with Claude Code; it is not affiliated with its makers.

## Example prompts

> Use Clawifi to read the release notes of the latest httpx version and tell me whether anything breaks our use of `AsyncClient`. Quote the passages you used.

> Search the web with Clawifi for how other projects pin `ruff` in pre-commit, read the two most relevant results, and suggest a config for this repo.

> Read https://docs.python.org/3/whatsnew/3.13.html with Clawifi and list the changes that affect asyncio, with the passages you used.

> Before you call anything expensive, use Clawifi’s `estimate` to price crawling 50 pages of our docs site, then tell me the credit cost.

## Questions

### How do I add Clawifi to Claude Code?

Run `claude mcp add --transport http clawifi https://api.clawifi.dev/mcp --header "Authorization: Bearer $CLAWIFI_API_KEY"` with your key in `CLAWIFI_API_KEY`. The local alternative is `pip install clawifi` and `claude mcp add clawifi -e CLAWIFI_API_KEY=your_key -- clawifi-mcp`.

### Should I use the hosted server or the local one?

Either. The hosted server needs no install and no Python; the local `clawifi-mcp` runs on your machine and calls the same API. Tools, limits and credits are the same.

### Do I need a key to try it?

Without a key, `search_free`, `fetch_url`, `scrape_url` and `map_site` work on the hosted server as a trial: 12 calls a minute and 50 a day per address. A [free API key](https://clawifi.dev/signup) includes 1,000 credits a month and opens every tool.

### What does it cost?

Most calls cost 1 credit and a browser render 3. Cache hits and failures on Clawifi’s side cost 0; a page whose site answers with an error (such as a 404) is charged as usual. The Free plan includes 1,000 credits a month. See [Pricing](https://clawifi.dev/pricing).

## Other agents and frameworks

- [Clawifi for Cursor](https://clawifi.dev/for/cursor): Add Clawifi to Cursor and its agent can search the web, read docs pages and PDFs, and bring back the passages that answer the question, each with its source, while it edits your code.
- [Clawifi for Codex](https://clawifi.dev/for/codex): Add Clawifi to Codex and it can search the web, read pages and PDFs, and return the passages that answer the question, each with its source.
- [Clawifi for Claude Desktop](https://clawifi.dev/for/claude-desktop): Add Clawifi to Claude Desktop and Claude can search the web, read pages and PDFs, and quote the passages that answer your question, each with its source.
- [All agent guides](https://clawifi.dev/for): Every client and framework.

Next: [Integrations](https://clawifi.dev/integrations) · [Docs](https://clawifi.dev/docs) · [Pricing](https://clawifi.dev/pricing)