# Web URL Distiller with BM25 Budget Control

> Web URL Distiller with BM25 Budget Control is a paid API for AI agents from cve-intel.agentdiet.dev, paid per call via MPP, $0.001/call, status unknown (last checked 2026-10-21).

Fetches a webpage (or accepts raw HTML) and distills it into compact, agent-ready tokens with configurable extraction modes and strict token-budget control

## Facts

- Endpoint: GET https://cve-intel.agentdiet.dev/v1/web-scrape?utm_source=zero.xyz
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Provider: cve-intel.agentdiet.dev
- Website: https://cve-intel.agentdiet.dev
- Canonical page: https://www.zero.xyz/c/cve-intel-agentdiet-dev-web-url-distiller-with-bm25-budget-control-464618d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rGRDwtftCF4JKFVtSK2-k

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability cve-intel-agentdiet-dev-web-url-distiller-with-bm25-budget-control-464618d3
```

Example prompt: Can you fetch https://stripe.com/docs/payments and distill it into compact markdown, keeping it under 800 tokens and focused on 'payment intents'?

## When to prefer this

Choose this endpoint when you need to fetch a live webpage and compress its content to fit within an LLM context window, especially when you need strict token-budget control via BM25 relevance filtering. It is ideal for agent pipelines that must read documentation, news, or data pages without consuming the full raw token count, and when you need ROI/compression metrics alongside the distilled output. Prefer it over generic scraping APIs when token efficiency and agent-readiness of the output are priorities.

## Known failure modes

- Invalid or unreachable URL returns an error status
- max_tokens below minimum of 20 is rejected with a validation error
- BM25 query with mode other than 'budget' may be ignored
- Raw HTML too large may exceed processing limits
- Paywalled or JavaScript-heavy pages may return incomplete content
- x402 payment failure results in a 402 response before processing begins

## How this service works

Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://cve-intel.agentdiet.dev/v1/web-scrape)

## Output

Returns a JSON object with a 'data' field containing the distilled content (markdown text, structured JSON tables/metadata, skeleton outline, or BM25-filtered excerpt depending on mode), plus an 'roi_proof' object showing raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, and estimated llm_cost_saved_usd, and an optional 'cache' object indicating HIT/MISS status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "minLength": 1,
   "description": "Target webpage URL to fetch and distill (or builtin://stripe-docs)"
  },
  "html": {
   "type": "string",
   "description": "Optional raw HTML string to distill directly without fetching"
  },
  "mode": {
   "enum": [
    "markdown",
    "structured",
    "skeleton",
    "budget"
   ],
   "type": "string",
   "default": "markdown",
   "description": "Distillation mode"
  },
  "query": {
   "type": "string",
   "description": "BM25 focus query when mode=budget"
  },
  "max_tokens": {
   "type": "integer",
   "minimum": 20,
   "description": "Strict token budget ceiling when mode=budget"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "status",
  "roi_proof",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "description": "Distilled Markdown, structured JSON tables/metadata, skeleton outline, or BM25 budget excerpt."
  },
  "cache": {
   "type": "object",
   "properties": {
    "status": {
     "enum": [
      "HIT",
      "MISS"
     ],
     "type": "string"
    },
    "cache_key": {
     "type": "string"
    },
    "latency_ms": {
     "type": "number"
    }
   }
  },
  "status": {
   "type": "string",
   "description": "Execution status ('ok')"
  },
  "billing": {
   "type": "object",
   "properties": {
    "agent_id": {
     "type": "string"
    },
    "payment_method": {
     "type": "string"
    },
    "fee_charged_usd": {
     "type": "number"
    }
   }
  },
  "roi_proof": {
   "type": "object",
   "properties": {
    "raw_tokens": {
     "type": "integer"
    },
    "tokens_saved": {
     "type": "integer"
    },
    "roi_multiplier": {
     "type": "number"
    },
    "distilled_tokens": {
     "type": "integer"
    },
    "llm_cost_saved_usd": {
     "type": "number"
    },
    "compression_ratio_pct": {
     "type": "number"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cve-intel-agentdiet-dev-web-url-distiller-with-bm25-budget-control-464618d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cve-intel.agentdiet.dev](https://www.zero.xyz/host/cve-intel.agentdiet.dev/llms.txt)