# Web URL to Markdown Distiller with BM25 Budget Control

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

Fetches a web URL (or raw HTML) and distills it into compact, agent-ready markdown, structured JSON, skeleton outline, or BM25-focused token-budgeted excerpts

## Facts

- Endpoint: GET https://serp-extract.agentdiet.dev/v1/docs-to-markdown?utm_source=zero.xyz
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Provider: serp-extract.agentdiet.dev
- Website: https://serp-extract.agentdiet.dev
- Canonical page: https://www.zero.xyz/c/serp-extract-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-dbf75806
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RfOMnwaIvrgLdkTsQdmRh

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 serp-extract-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-dbf75806
```

Example prompt: Fetch the page at https://docs.stripe.com/api/charges and distill it into compact markdown, keeping it under 2000 tokens using budget mode focused on the query 'charge creation parameters'.

## When to prefer this

Choose this endpoint when you need to feed web page content to an LLM but want to minimize token usage and cost — especially when operating under strict context window budgets. The BM25 budget mode makes it uniquely suited for focused extraction around a specific query topic. Prefer it over generic web scrapers when token efficiency and compression metrics matter, or when you need structured JSON tables or skeleton outlines rather than raw HTML dumps.

## Known failure modes

- URL unreachable or returns non-200 status — endpoint may return error status
- Malformed or empty HTML produces empty or minimal distilled output
- max_tokens set below 20 triggers validation error
- BM25 query provided without mode=budget may be ignored
- Payment/402 authentication failure if agent_id or payment not configured
- Very large pages may exceed processing limits or increase latency significantly

## How this service works

Distill a web URL into compact agent-ready tokens (Live x402 v2, IETF MPP & MCP endpoint at https://serp-extract.agentdiet.dev/v1/docs-to-markdown)

## Output

Returns a JSON object containing distilled content (markdown text, structured JSON tables/metadata, skeleton outline, or BM25-focused excerpt depending on mode), plus an roi_proof object showing raw vs distilled token counts, tokens saved, compression ratio percentage, estimated LLM cost saved in USD, and optionally cache hit/miss status and billing details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "minLength": 1,
   "description": "Target webpage URL to distill (or builtin://stripe-docs)"
  },
  "mode": {
   "enum": [
    "markdown",
    "structured",
    "skeleton",
    "budget"
   ],
   "type": "string",
   "default": "markdown",
   "description": "Extraction mode: markdown, structured, skeleton, or budget"
  },
  "limit": {
   "type": "integer",
   "default": 20,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum number of items to return per page (1-100)"
  },
  "query": {
   "type": "string",
   "description": "BM25 focus query when mode=budget"
  },
  "cursor": {
   "type": "string",
   "description": "Opaque pagination cursor for fetching the next page"
  },
  "max_tokens": {
   "type": "integer",
   "minimum": 20,
   "description": "Strict token 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/serp-extract-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-dbf75806/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from serp-extract.agentdiet.dev](https://www.zero.xyz/host/serp-extract.agentdiet.dev/llms.txt)