# AgentDiet RAG Token Diet — Web URL Distiller

> AgentDiet RAG Token Diet — 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 webpage (or accepts raw HTML) and distills it into compact, agent-ready tokens using multiple extraction modes including BM25 budget-controlled summarization

## Facts

- Endpoint: GET https://preflight.agentdiet.dev/v1/rag-token-diet?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-rag-token-diet-web-url-distiller-19b65b4f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dVAXPy1xavYORN5njebf_

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-rag-token-diet-web-url-distiller-19b65b4f
```

Example prompt: Distill the Stripe docs at https://docs.stripe.com/payments into compact markdown, keeping it under 800 tokens and focusing on payment intents.

## When to prefer this

Use this endpoint when an AI agent needs to ingest web content but must stay within a strict token budget, or when feeding raw HTML into an LLM context would be wasteful. It is especially valuable in RAG pipelines where relevance-focused extraction (BM25 mode) is needed over simple truncation, or when structured/skeleton modes are needed to understand a page's layout before deeper processing. Prefer over generic scrapers when token economics and LLM cost savings matter.

## Known failure modes

- URL is unreachable or returns non-200 status — endpoint may return an error status
- Raw HTML too large for processing — may time out or exceed internal limits
- BM25 query too vague — budget excerpt may be low quality or poorly focused
- max_tokens set too low — content may be severely truncated or empty
- Payment not provided or insufficient — HTTP 402 returned, no content delivered
- Invalid mode enum value — returns validation error

## How this service works

Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://preflight.agentdiet.dev/v1/rag-token-diet)

## Output

Returns a JSON object containing the distilled content (as markdown, structured tables, skeleton outline, or BM25-ranked excerpt depending on mode), plus ROI proof metrics including raw token count, distilled token count, tokens saved, compression ratio percentage, and estimated LLM cost saved in USD. Also includes 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 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/preflight-agentdiet-dev-agentdiet-rag-token-diet-web-url-distiller-19b65b4f/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)