{"uid":"cap_B5XPZsSfYhAWIvRrHsSUu","slug":"onchain-risk-agentdiet-dev-web-distillation-with-bm25-budget-control-e1710745","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://onchain-risk.agentdiet.dev/v1/rag-diet)","url":"https://onchain-risk.agentdiet.dev/v1/rag-diet?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_XC-Tr4EA2tzeawtLnSXwM","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"onchain-risk.agentdiet.dev","brandSlug":"onchain-risk-agentdiet-dev-mpp","brandBaseUrl":"https://onchain-risk.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a URL or accepts raw HTML and distills it into compact, token-efficient content using BM25-ranked budget control for query-focused extraction","exampleAgentPrompt":"Distill this URL https://stripe.com/docs/api into budget mode with a query about 'payment intents' and cap the output at 500 tokens so I can fit it into my context window.","exampleUseCases":[{"title":"Cost-saving RAG pipeline preprocessing","prompt":"Fetch https://docs.openai.com/api-reference and distill it in budget mode with the query 'rate limits' keeping the output under 300 tokens — I want only the most relevant parts without blowing my LLM token budget."},{"title":"Structured data extraction from a product page","prompt":"Take this raw HTML from an e-commerce product page and distill it in structured mode so I get the tables, metadata, and key fields in JSON format without all the nav and footer noise."},{"title":"Skeleton outline of a long article","prompt":"Distill https://en.wikipedia.org/wiki/Large_language_model in skeleton mode so I get just the outline and section headings — I need to understand the document structure before deciding which sections to read in full."}],"resultDescription":"Returns a JSON object containing the distilled content (Markdown, structured JSON, skeleton outline, or BM25-ranked excerpt depending on mode), an ROI proof object showing raw token count, distilled token count, tokens saved, compression ratio percentage, and estimated LLM cost saved in USD, plus optional billing and cache metadata.","failureModes":["URL is unreachable or returns non-200 — fetch failure with error status","HTML payload is malformed or empty — distillation returns empty or error","max_tokens set below minimum of 20 — validation error","BM25 query not provided when mode=budget — may degrade to full content","Payment/402 auth failure — endpoint returns 402 with payment instructions","Rate limiting or upstream timeout on large pages"],"whenToPreferThis":"Choose this endpoint when you need to feed webpage content into an LLM and want to minimize token usage through intelligent compression. It is especially valuable when you have a specific query focus (mode=budget with BM25 ranking) and need to stay within a strict token ceiling. Prefer it over generic scrapers when you care about token efficiency, ROI metrics, and getting only the semantically relevant portion of a page rather than raw HTML or full-page markdown dumps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T12:40:03.830Z","isFirstParty":false,"canonicalSlug":"onchain-risk-agentdiet-dev-web-distillation-with-bm25-budget-control-e1710745"}