# AgentDiet Web URL Distiller

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

Fetches a web URL and compresses it into compact, agent-ready tokens via multiple extraction modes (markdown, structured, skeleton, or BM25 budget)

## Facts

- Endpoint: GET https://preflight.agentdiet.dev/v1/distill?utm_source=zero.xyz
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Provider: preflight.agentdiet.dev
- Website: https://preflight.agentdiet.dev
- Canonical page: https://www.zero.xyz/c/preflight-agentdiet-dev-agentdiet-web-url-distiller-f70aaa91
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Oo3j37CSIgVa9XP-32cSX

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 preflight-agentdiet-dev-agentdiet-web-url-distiller-f70aaa91
```

Example prompt: Distill https://stripe.com/docs/payments into compact markdown — I want to save as many tokens as possible, so use budget mode with a focus query on 'payment intents' and cap it at 500 tokens.

## When to prefer this

Choose this endpoint when an AI agent needs to ingest web page content but must minimize token usage and LLM cost. It is especially valuable when feeding documentation, news articles, or reference pages into a constrained context window. Prefer it over raw web fetchers when compression metrics and BM25 query-focused filtering matter. The budget mode with max_tokens is ideal for cost-sensitive pipelines where only a relevant excerpt is needed.

## Known failure modes

- Invalid or unreachable URL returns an error status
- mode=budget without a query may produce unfiltered results
- max_tokens set below content minimum may truncate critically
- Paywalled or JavaScript-heavy pages may yield poor extraction quality
- Payment failure (x402) blocks the request if funds are insufficient

## How this service works

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

## Output

Returns a 'data' object containing the distilled content in the requested format (markdown text, structured JSON tables/metadata, skeleton outline, or BM25-filtered excerpt), plus an 'roi_proof' object showing raw vs distilled token counts, compression ratio percentage, tokens saved, and estimated LLM cost saved in USD. Also includes optional cache 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"
  },
  "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/preflight-agentdiet-dev-agentdiet-web-url-distiller-f70aaa91/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from preflight.agentdiet.dev](https://www.zero.xyz/host/preflight.agentdiet.dev/llms.txt)
