{"uid":"cap_1MDL_vgu8a6INBv66dblA","slug":"hn-pulse-agentdiet-dev-rag-token-diet-url-html-distiller-with-bm25-7b08968b","name":"RAG Token Diet — URL/HTML Distiller 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://hn-pulse.agentdiet.dev/v1/rag-token-diet)","url":"https://hn-pulse.agentdiet.dev/v1/rag-token-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_zSsCUyLbqi4GuNXKe6j-6","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"hn-pulse.agentdiet.dev","brandSlug":"hn-pulse-agentdiet-dev-mpp","brandBaseUrl":"https://hn-pulse.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a URL or accepts raw HTML and distills it into compact Markdown, structured JSON, skeleton outline, or BM25-ranked token-budget excerpt for LLM consumption","exampleAgentPrompt":"Can you distill https://stripe.com/docs/payments into clean markdown using budget mode, focused on 'payment intents', and keep it under 500 tokens so I can feed it to my RAG pipeline without blowing my context window?","exampleUseCases":[{"title":"RAG pipeline cost-efficient web ingestion","prompt":"Distill https://docs.openai.com/api-reference into structured mode — I want clean JSON tables of the API parameters so I can index them in my vector store without wasting tokens on nav menus and boilerplate."},{"title":"BM25-focused research excerpt under token budget","prompt":"Pull https://en.wikipedia.org/wiki/Transformer_(machine_learning_model) and give me only the passages most relevant to 'attention mechanism', capped at 300 tokens — I need just the signal, not the whole article."},{"title":"Live webpage skeleton outline for agent navigation","prompt":"Fetch https://news.ycombinator.com and distill it in skeleton mode so I can see the outline structure of the page and decide which sections are worth reading in full."}],"resultDescription":"A JSON object containing: distilled content under 'data' (Markdown text, structured JSON tables/metadata, skeleton outline, or BM25-ranked excerpt depending on mode); an 'roi_proof' object showing raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, roi_multiplier, and llm_cost_saved_usd; a 'cache' object with HIT/MISS status and latency; and a 'billing' object with the fee charged in USD.","failureModes":["URL is unreachable or returns non-200 status — endpoint may error or return empty data","Raw HTML is malformed or empty — distillation may produce minimal output","mode=budget used without a query field — BM25 ranking has no focus signal","max_tokens set below minimum of 20 — validation error returned","URL behind authentication/paywall — content not accessible for distillation","Very large pages may hit internal processing limits before returning"],"whenToPreferThis":"Choose this endpoint when you need to feed live web content or raw HTML into an LLM pipeline and must stay within a token budget. It is ideal for RAG ingestion workflows where noise removal and compression ratio matter, especially when you want verifiable ROI metrics (tokens saved, cost saved). Prefer budget mode with a BM25 query when you need only topically relevant passages from a long page. Prefer structured or skeleton mode when you want navigable, machine-readable output rather than prose markdown.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T06:37:17.329Z","isFirstParty":false,"canonicalSlug":"hn-pulse-agentdiet-dev-rag-token-diet-url-html-distiller-with-bm25-7b08968b"}