{"uid":"cap_-mv6ylTlxQndBIBn_04LT","slug":"whale-momentum-agentdiet-dev-web-distillation-with-bm25-budget-control-478e4b15","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://whale-momentum.agentdiet.dev/v1/rag-diet)","url":"https://whale-momentum.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_VEt-h05vmr8K4rVOmWUJN","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"whale-momentum.agentdiet.dev","brandSlug":"whale-momentum-agentdiet-dev-mpp","brandBaseUrl":"https://whale-momentum.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and distills a URL or raw HTML into clean Markdown, structured JSON, a skeleton outline, or a BM25-ranked token-budget excerpt focused on a query.","exampleAgentPrompt":"Pull the content from https://docs.stripe.com/payments and distill it into clean markdown, keeping it under 2000 tokens focused on 'payment intents' so I can feed it into my LLM without blowing the context window.","exampleUseCases":[{"title":"RAG pipeline doc ingestion","prompt":"Fetch https://docs.openai.com/api-reference and distill it into structured JSON tables — I need the parameters and descriptions cleanly extracted so I can index them for retrieval."},{"title":"Token-budget focused research","prompt":"Distill https://en.wikipedia.org/wiki/Transformer_(machine_learning_model) down to at most 1500 tokens, using BM25 budget mode focused on the query 'attention mechanism', so I only get the most relevant passages."},{"title":"Clean markdown from raw HTML","prompt":"I have a raw HTML string from a scraped e-commerce page — can you run it through distillation in markdown mode so I get clean readable content without all the nav, ads, and boilerplate?"}],"resultDescription":"Returns a status field, a data object containing the distilled content (Markdown string, structured JSON, skeleton outline, or BM25 excerpt depending on mode), an roi_proof object with raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, roi_multiplier, and llm_cost_saved_usd, plus optional cache hit/miss metadata and billing details.","failureModes":["URL is unreachable or returns non-200 — distillation fails with fetch error","HTML payload is empty or malformed — parser returns minimal or empty output","max_tokens set below minimum of 20 — rejected with validation error","BM25 query omitted when mode=budget — may return unranked or error response","Rate limit or payment failure via x402 — returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need to preprocess web content before feeding it to an LLM and want provable token savings with an ROI breakdown. It is especially valuable in RAG pipelines where you must respect strict context windows, or when you want BM25-ranked relevance filtering to a specific query rather than full-page content. Prefer it over generic scrapers when token efficiency and structured output modes (markdown, JSON tables, skeleton, budget) matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T06:37:44.142Z","isFirstParty":false,"canonicalSlug":"whale-momentum-agentdiet-dev-web-distillation-with-bm25-budget-control-847a3290"}