# HTML to Markdown Web Distiller

> HTML to Markdown Web Distiller is a paid API for AI agents from prompt-guard.agentdiet.dev, paid per call via MPP, $0.001/call, status unknown (last checked 2026-10-21).

Fetches a webpage URL and converts its HTML into compact, agent-ready Markdown or structured formats with token compression metrics.

## Facts

- Endpoint: GET https://prompt-guard.agentdiet.dev/v1/html-to-markdown?utm_source=zero.xyz
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Provider: prompt-guard.agentdiet.dev
- Website: https://prompt-guard.agentdiet.dev
- Canonical page: https://www.zero.xyz/c/prompt-guard-agentdiet-dev-html-to-markdown-web-distiller-6822ebcb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X8fTTwIOSpKUGtSFuAWDf

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 prompt-guard-agentdiet-dev-html-to-markdown-web-distiller-6822ebcb
```

Example prompt: Can you distill https://stripe.com/docs/payments into compact markdown so I can feed it to my LLM without blowing my token budget?

## When to prefer this

Choose this endpoint when you need to feed live webpage content to an LLM but want to minimize token usage and LLM costs. It is particularly useful when working with documentation pages, news articles, or data-heavy sites where raw HTML would be too verbose. Prefer it over generic scrapers when you need built-in compression metrics, multiple extraction modes (markdown, structured, skeleton, budget), or BM25-focused excerpts from large pages.

## Known failure modes

- Invalid or unreachable URL returns an error status
- URL that blocks bots or requires auth may return empty or partial content
- max_tokens too low may result in heavily truncated output
- BM25 query with mode other than 'budget' is ignored silently
- Payment failure via x402 prevents endpoint execution

## How this service works

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

## Output

Returns a 'data' object containing distilled content in the requested format (Markdown, structured JSON tables/metadata, skeleton outline, or BM25 budget excerpt), plus an 'roi_proof' block showing raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, roi_multiplier, and llm_cost_saved_usd. Also includes cache status (HIT/MISS) 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"
  },
  "query": {
   "type": "string",
   "description": "BM25 focus query when mode=budget"
  },
  "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/prompt-guard-agentdiet-dev-html-to-markdown-web-distiller-6822ebcb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from prompt-guard.agentdiet.dev](https://www.zero.xyz/host/prompt-guard.agentdiet.dev/llms.txt)