Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Clawifi

de ReARCLabsversión 0.4.1i★ 0iComputadora o nubeSitio oficial ↗
Nombre en el registroio.github.atakanelik34/clawifi-mcp

Cómo instalar

What it does

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

  • Connects Computadora o nube
  • Account or key Cloud: Works without a key · add Authorization if you have one (often raises limits) · Local: Needs CLAWIFI_API_KEY
  • Category Web y navegadores

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

de google-research★ 35.6381 skills

Skill · Guía de trabajo

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

de BigBodyCobain★ 11.6051 skills

Skill · Guía de trabajo

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

de gosom★ 82361 skills

Skill · Guía de trabajo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso20/100

Calidad: Pasó 4/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Clawifi. Sigue https://mcp.popnx.com/i/atakanelik34-clawifi-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 4/5 revisiones · Lo que preguntas pasa por el servidor del autor (api.clawifi.dev) · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreClawifi
    Remote MCP server URL · Direcciónhttps://api.clawifi.dev/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsClawifi

  4. Pruébalo

    Usa Clawifi y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Clawifi o muestra una herramienta de Clawifi en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreClawifi
    Connection · Direcciónhttps://api.clawifi.dev/mcp
  3. Elige Clawifi en un chat

    Abre un chat nuevo y elige Clawifi en tus plugins antes de escribir

  4. Pruébalo

    Usa Clawifi y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando Clawifi o muestra una herramienta de Clawifi en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user clawifi https://api.clawifi.dev/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver Clawifi en la lista como conectado

  4. Pruébalo

    Usa Clawifi y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Clawifi o muestra una herramienta de Clawifi en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa Clawifi y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Clawifi o muestra una herramienta de Clawifi en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa Clawifi y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Clawifi o muestra una herramienta de Clawifi en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://api.clawifi.dev/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Clawifi💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user clawifi https://api.clawifi.dev/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "clawifi": {
      "url": "https://api.clawifi.dev/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "clawifi": {
      "type": "http",
      "url": "https://api.clawifi.dev/mcp"
    }
  }
}

Instalado en tu computadora

Claude Code

claude mcp add --scope user clawifi --env CLAWIFI_API_KEY=your-value -- uvx clawifi

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "clawifi": {
      "command": "uvx",
      "args": [
        "clawifi"
      ],
      "env": {
        "CLAWIFI_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "clawifi": {
      "command": "uvx",
      "args": [
        "clawifi"
      ],
      "env": {
        "CLAWIFI_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "clawifi": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "clawifi"
      ],
      "env": {
        "CLAWIFI_API_KEY": "your-value"
      }
    }
  }
}

Valores que debes completar

  • CLAWIFI_API_KEY secreto obligatorio env
    Clave de API de Clawifi (clawifi_live_...). Puede crear una en https://clawifi.dev/signup
    Ver original en inglésClawifi API key (clawifi_live_...). Create one at https://clawifi.dev/signup.
  • Authorization secreto HTTP header
    Token Bearer con tu clave de API de Clawifi. Opcional: sin ella solo funcionan search_free, fetch_url, scrape_url y map_site, a 12/min y 50/día por dirección.
    Ver original en inglésBearer token with your Clawifi API key. Optional: without it only search_free, fetch_url, scrape_url and map_site work, at 12/min and 50/day per address.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
46/sem
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.4.1
Publicado en el registroi
10 nov 2026
Último cambio de códigoi
10 nov 2026
Última revisión
18 nov 2026
Creador
ReARCLabs
Paquetes
pypi: clawifi
Sitio web
clawifi.dev
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 18 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • fetch_url

    Fetch one URL (page or PDF) as clean markdown with route diagnostics. query returns only the top_k passages that answer it. content_scope="full" returns the whole page text, not just the main content. force_browser renders it in a browser (3 credits instead of 1); render="auto" d

  • scrape_url

    Scrape a URL into LLM-ready formats (markdown, text, links, metadata, html, screenshot, state_json). query keeps only the top_k passages of markdown and text that answer it. Returns formats. , metadata (title, final_url, canonical_url, excerpt), published_at/modified_at and conte

  • extract_url

    Extract structured fields from a URL: a preset (article, product, ...) or a field schema.

  • search_free

    Search the web and return ranked results: url, title, snippet, rank, and published_at when the engine gives a date. No page text; read a result with fetch_url. Fields: https://clawifi.dev/docs/search.

  • map_site

    List a site's discoverable URLs (sitemap, robots, links) from a seed URL; search filters them.

  • start_crawl

    Start a crawl from a seed URL in the background. Returns a crawl id for get_crawl.

  • get_crawl

    Status and pages of a crawl started with start_crawl.

  • read_artifact

    Read a stored artifact of the account by its id, such as a page get_crawl or fetch_url lists: an HTML page comes back as markdown (as_markdown=false for the raw HTML), capped at max_chars. Free.

  • create_job

    Run a billable operation (fetch, batch_fetch, extract, crawl, research, ...) as a background job. Returns a job id for get_job.

  • get_job

    Status and result of a job started with create_job.

  • list_history

    The account's past calls, newest first; operation filters by name (e.g. search_free).

  • list_monitors

    The account's Evidence Monitor checks.

  • estimate

    What a call would cost in credits before running it: minimum (what the balance must cover), maximum or a caveat, what raises it, the balance and would_402. operation is a tool name (fetch_url, start_crawl, research, ...) or a job operation; args are that call's arguments. Runs no

  • account

    The signed-in account: name, plan and this month's credits.

  • credits

    The credit balance, what this month's calls were charged, the plan's monthly credits and when they renew.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ! Precaución

    El creador coincide con el repo

    Quien lo publicó (atakanelik34) no es el dueño del repo (ReARCLabs); puede que otra persona lo haya listado

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 9 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 337 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 15 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para clawifi@0.4.1

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/atakanelik34-clawifi-mcp.svg)](https://mcp.popnx.com/en/servers/atakanelik34-clawifi-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Web y navegadoresi

  • Más estrellas que el 0% de los otros 1634 servidores de esta categoría
  • Publicado en el registro más recientemente que el 78% de los otros 1634 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 59% de los otros 1634 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Clawifi?

Superó 4 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: CLAWIFI_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 9 días, y la última versión (0.4.1) llegó al registro hace 9 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: Browser Use, changedetection.io (official), Apify MCP Server, Pomerado, Actionbook

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Browser Use

Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.

de browser-useMuy usado↓ 1,7 M/sem★ 121,5 milActualizado hace 29 días

Computadora o nube✓ del servicio · browser-use.com

Apify MCP Server

Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store ⚡

de apifyMuy usado★ 16,9 milActualizado anteayer

Se ejecuta en la nube✓ del servicio · apify.com

Pomerado

Connect your agents to any website. The cheaper, faster and more reliable alternative to browser use

de PomeradoEn crecimiento★ 1,8 milActualizado ayer

Se ejecuta en la nube✓ del servicio · pomerado.ai

Actionbook

Let your AI agent operate any website through a real, logged-in browser session.

de actionbookEn crecimiento★ 1,6 milActualizado hace 31 días

Se ejecuta en la nube✓ del servicio · actionbook.app
Comparado con otros parecidos
Este
Clawifi
Browser Usechangedetection.io (official)Apify MCP ServerPomeradoActionbook
Dónde se ejecutaEn la nube o instalado en tu equipoEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíSíNoSíNoNo
Se añade con + en ClaudeNoSíNoNoNoNo
Revisiones básicas4/55/53/34/44/44/4
LicenciaMITMITApache-2.0MITMITApache-2.0
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

clawifi

Official Python SDK, CLI, and MCP server for Clawifi, web search and page reading for AI agents: search many engines as one, read pages and PDFs, map and crawl sites, and get back only the passages that answer the question, each with its source. One typed API and MCP surface for all of it.

This package is a thin client over the hosted Clawifi API (hosted API version 1.12.1 at time of release); the Clawifi server is not included. Docs, pricing and status: clawifi.dev/docs · clawifi.dev/pricing · clawifi.dev/status · clawifi.dev/security.

One-click install (hosted server, no key needed to try)

Both add the hosted remote server https://api.clawifi.dev/mcp. No key to copy: the free tools work at once, and your client asks you to sign in (a free account, 1,000 credits a month) when a call needs one. One line for every other client (Claude Code, Codex, Claude, ChatGPT, Hermes): clawifi.dev/install.

Agent skill

npx skills add ReARCLabs/clawifi-mcp

Installs skills/clawifi/SKILL.md into your coding agent: when to use Clawifi, which tool fits, and what each call costs. The same file is at clawifi.dev/agent-onboarding/skill.md.

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

Set up your MCP client

clawifi init

finds the MCP clients installed on this machine (Claude Code, Codex, Cursor, Claude Desktop, VS Code) and prints, for each one, the install line for the local server (clawifi-mcp, stdio) and for the remote server, followed by a first call to try. It only prints; it never shows your key, only $CLAWIFI_API_KEY or a masked clawifi_live_****. clawifi init --all shows every client, found or not.

To have it edit a config file for you:

clawifi init --write cursor            # ~/.cursor/mcp.json, stdio entry

clawifi init --write cursor --remote # ~/.cursor/mcp.json, remote entry clawifi init --write claude-desktop # claude_desktop_config.json, stdio entry

--write asks before it changes anything and copies the existing file to .bak- first. Claude Code, Codex and VS Code have their own install commands, which init prints.

For Claude Code, for example:

# local (stdio)

claude mcp add --env CLAWIFI_API_KEY=$CLAWIFI_API_KEY --transport stdio clawifi -- clawifi-mcp

remote

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

Use as an MCP server

The local MCP server runs as:

clawifi-mcp

reading CLAWIFI_API_KEY from the environment. clawifi mcp config prints a minimal config for it. Every tool carries a title and the MCP hints readOnlyHint, destructiveHint, idempotentHint and openWorldHint; none is destructive.

The billable tools (fetch, scrape, extract, map_site, crawl, search_free) take their common options as parameters and any other API field in options, which is merged into the request body. They refuse dry_run: use the estimate tool to price a call. Arguments a tool does not declare are refused rather than ignored.

fetch takes content_scope ("main", the default, or "full" for the whole page text with scripts and styles removed) and render ("never", the default; "auto" opens the browser only for a JavaScript shell; "always" reads in the browser). A browser render costs 3 credits instead of 1, and estimate("fetch", {"url": ..., "render": "auto"}) quotes the range first. Any other value is refused and nothing is sent; both are sent only when they differ from the default. Each tool's description names the fields it returns (see Response fields).

Remote MCP

Clawifi also runs a hosted MCP server, so nothing needs installing:

  • URL: https://api.clawifi.dev/mcp (streamable HTTP)
  • Auth: Authorization: Bearer , or the X-Clawifi-Api-Key: header

The old host api.clawifi.qzz.io (API and /mcp) keeps working, so CLAWIFI_API_BASE=https://api.clawifi.qzz.io and existing remote configs need no change.

Without a key the remote server offers a keyless tier of four tools, search_free, fetch_url, scrape_url and map_site, at 12 calls a minute and 50 a day per address. With a key you get the full tool list.

Credits

Calls are charged per operation (a plain fetch is 1 credit, a browser render 3, a crawl 1 per page, and so on). See clawifi.dev/pricing, or print the current table, which needs no key:

clawifi credits

The credits MCP tool and client.credits() show your own usage and balance instead.

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.

search_content searches and reads the top results; it is compact by default and full=True returns the full output:

results = client.search_content("agent memory benchmarks", full=True)

Responses are returned as the API sends them, so fields such as published_at, modified_at and fetched_at come through untouched. Request fields are passed through as keyword arguments too:

page = client.fetch("https://example.com/pricing", content_scope="full")   # the whole page text

page = client.fetch("https://app.example.com", render="auto") # browser only for a JavaScript shell

Response fields

Every response field, and the fields a call does not return, is listed on the endpoint pages: search, search with content, fetch, scrape and extract.

Fields worth knowing (the search cache since hosted API 1.11.0, the page fields since 1.12.0):

  • search_free: cache_hit is true when an identical search within 60 seconds was answered from the cache; such an answer costs 0 credits. Each result carries url, title, snippet, rank, provider and, when the engine gives a date, published_at and modified_at.
  • fetch: data.page_text_chars (how much readable text the page holds), data.content_chars (the length of content_markdown before any query selection), data.scope_used (main, whole, selector or full) and data.language (the page's ). mode_used is browser when render: "auto" rendered a JavaScript shell; with the default render: "never" such a page answers content_status: "needs_javascript" and costs 0.
Estimates (hosted API 1.7.0 and later)
quote = client.estimate("fetch", url="https://example.com")

{"dry_run": true, "route": "POST /fetch", "estimate": {"minimum": ..., "maximum": ..., "raises": [...]},

"balance": ..., "would_402": ..., "would_429": ..., "binding_limit": ..., "charged": 0}

client.crawl("https://example.com", max_pages=50, dry_run=True)

estimate() and dry_run=True work for fetch, scrape, extract, map, crawl, search_free and search_content. Before the first dry run the client checks the API version at /product/manifest; an API older than 1.7.0 would ignore dry_run and run (and bill) the call, so the client raises ClawifiDryRunUnsupportedError and sends nothing. Pre-releases such as 1.7.0rc1 count as older than 1.7.0.

dry_run is sent only when it is True, and only as the JSON boolean true: a normal call, or dry_run=False, has no dry_run key in its body, and a value that is not a bool raises TypeError before anything is sent. The API answers any dry_run key (even false) on a route that cannot dry-run with a 422, so schema_assist drops dry_run=False and refuses dry_run=True.

The estimate MCP tool does the same from an agent: estimate(operation="fetch", args={"url": "https://example.com"}).

Rate limits

A 429 raises ClawifiAPIError with retry_after (seconds, from the Retry-After header) and limit_scope (which limit was hit, from details.limit_scope). Retryable calls wait out a Retry-After of up to 10 seconds before retrying; a longer one is raised straight away.

MCP tools

ToolWhat it does
fetchFetch one URL (page or PDF) as Markdown. With query, only the passages that answer it; content_scope="full" for the whole page text; render="auto" opens the browser only for a JavaScript shell.
scrapeScrape a URL with source-aware routing and return structured content. With query, only the passages that answer it.
search_freeSearch the web and return ranked results (url, title, snippet, rank, provider, dates when the engine gives them). An identical search within 60 s is a cache_hit for 0 credits.
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.
estimatePrice a fetch, scrape, extract, map, crawl, search_free or search_content call without running it or charging for it (hosted API 1.7.0+).
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.dev/docs for the full API reference, MCP tool list, and CLI command reference.

License

MIT