{"uid":"cap_Qham0EsmwaGvnaLkPGb0n","slug":"defi-yield-agentdiet-dev-web-distillation-with-bm25-budget-control-9d15a7c2","name":"Web Distillation with BM25 Budget Control","description":"Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://defi-yield.agentdiet.dev/v1/distill)","url":"https://defi-yield.agentdiet.dev/v1/distill?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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"}}}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.001","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_b2z6gtGxUz845miSM0-j2","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"defi-yield.agentdiet.dev","brandSlug":"defi-yield-agentdiet-dev-mpp","brandBaseUrl":"https://defi-yield.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and distills a URL or raw HTML into compressed Markdown, structured JSON, skeleton outlines, or BM25-ranked token-budget excerpts focused on a query.","exampleAgentPrompt":"Distill the content at https://stripe.com/docs/payments into clean markdown using budget mode, focused on the query 'payment intents', and keep it under 500 tokens.","exampleUseCases":[{"title":"LLM-ready doc summarization for RAG","prompt":"Fetch https://docs.openai.com/api-reference and distill it into structured markdown so I can feed it into my RAG pipeline without blowing my token budget."},{"title":"Query-focused excerpt for research agent","prompt":"Pull the page at https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=AAPL and extract only the sections relevant to 'annual filings' using budget mode with a max of 300 tokens."},{"title":"Webpage skeleton outline for navigation","prompt":"Give me a skeleton outline of https://github.com/openai/openai-python so I can understand the top-level structure of the repo documentation without reading everything."}],"resultDescription":"Returns a JSON object containing distilled content (Markdown text, structured tables/metadata, skeleton outline, or BM25-ranked excerpt depending on mode), plus an roi_proof block showing raw vs distilled token counts, compression ratio, tokens saved, estimated LLM cost saved in USD, and an ROI multiplier. Also includes cache status (HIT/MISS) and billing details.","failureModes":["URL unreachable or returns non-200 — distillation cannot proceed","HTML payload empty or malformed — skeleton/budget mode may return minimal output","max_tokens too low to produce meaningful excerpt — truncated or error response","query missing when mode=budget — BM25 scoring not applied, may fall back to default","Payment failure via x402 — HTTP 402 returned if USDC balance insufficient","Rate limiting or timeout on slow external URLs — latency spike or timeout error"],"whenToPreferThis":"Choose this endpoint when you need to feed web content to an LLM but want to minimize token usage and cost — especially when using BM25 budget mode to extract only query-relevant passages within a strict token ceiling. Prefer it over raw fetch/scrape endpoints when compression ratio, ROI tracking, and structured output modes (markdown, skeleton, structured JSON) are important. Also ideal when working with large documentation pages or HTML blobs that would otherwise overflow context windows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T06:35:59.942Z","isFirstParty":false,"canonicalSlug":"defi-yield-agentdiet-dev-web-distillation-with-bm25-budget-control-9d15a7c2"}