{"uid":"cap_yGf6jfd9kdRp8knpePFo9","slug":"sec-intel-agentdiet-dev-web-url-markdown-distiller-with-bm25-budget-465f6f24","name":"Web URL Markdown 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://sec-intel.agentdiet.dev/v1/markdown-distill)","url":"https://sec-intel.agentdiet.dev/v1/markdown-distill?utm_source=zero.xyz","method":"GET","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_n4bTMLFhIe_3rYiTKqjFi","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"sec-intel.agentdiet.dev","brandSlug":"sec-intel-agentdiet-dev-mpp","brandBaseUrl":"https://sec-intel.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a webpage or raw HTML and distills it into compact, token-efficient markdown or structured output with optional BM25 keyword-focused budget trimming","exampleAgentPrompt":"Can you distill https://stripe.com/docs/api into compact markdown using budget mode, focused on the query 'payment intents', keeping it under 500 tokens?","exampleUseCases":[{"title":"Token-efficient research from documentation","prompt":"Fetch the OpenAI API docs page at https://platform.openai.com/docs/overview and distill it into clean markdown so I can read the key points without burning through my context window."},{"title":"Query-focused budget extraction for RAG","prompt":"Distill https://en.wikipedia.org/wiki/Transformer_(machine_learning_model) in budget mode with the query 'attention mechanism' and a max of 300 tokens — I only need the parts relevant to how attention works."},{"title":"Structured data extraction from a web page","prompt":"Pull https://news.ycombinator.com and distill it in structured mode so I get a clean JSON of the top posts with their titles and links, without all the surrounding HTML noise."}],"resultDescription":"Returns a JSON object containing the distilled content (markdown, structured JSON, skeleton, or BM25 budget excerpt), an ROI proof block showing raw vs distilled token counts, compression ratio, and estimated LLM cost saved, plus optional cache hit/miss status and billing details.","failureModes":["URL is unreachable or returns a non-200 HTTP status — distillation fails with an error status","Paywalled or JavaScript-heavy pages may not render correctly and return incomplete content","max_tokens set too low may produce heavily truncated output that omits critical content","query parameter missing when mode=budget causes BM25 scoring to fall back to general distillation","Payment not processed (x402 flow failure) results in no response or 402 error","Invalid or malformed URL input causes immediate validation failure"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read a webpage but must minimize token consumption — especially in RAG pipelines, agentic browsing, or multi-step research tasks where context window cost matters. It is preferable over raw HTML fetching or generic scrapers when you need clean markdown or structured output with quantified compression savings. The BM25 budget mode makes it uniquely suited for query-focused extraction where only a specific topic within a large page is relevant.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:37:52.552Z","isFirstParty":false,"canonicalSlug":"sec-intel-agentdiet-dev-web-url-markdown-distiller-with-bm25-budget-465f6f24"}