{"uid":"cap_SRpL4r4q_BEcJcPB8gj6u","slug":"alpha-stream-agentdiet-dev-web-url-html-distiller-with-bm25-budget-6c108023","name":"Web 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://alpha-stream.agentdiet.dev/v1/clean-html)","url":"https://alpha-stream.agentdiet.dev/v1/clean-html?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_vV5jZRBiTENzUvXUdvIVs","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"alpha-stream.agentdiet.dev","brandSlug":"alpha-stream-agentdiet-dev-mpp","brandBaseUrl":"https://alpha-stream.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a URL or raw HTML and distills it into compact, agent-ready tokens with configurable extraction modes and strict token budgets","exampleAgentPrompt":"Can you fetch https://stripe.com/docs/payments and distill it into compact markdown, keeping it under 2000 tokens so I can use it in my prompt without blowing my context window?","exampleUseCases":[{"title":"Focused research on a documentation page","prompt":"Pull the content from https://docs.openai.com/api-reference and use budget mode with the query 'rate limits' — I only want the parts about rate limits, and keep it under 500 tokens."},{"title":"Cost-efficient web page reading for agent pipeline","prompt":"Distill https://techcrunch.com/2024/06/01/ai-funding-roundup into clean markdown so my agent can read it without wasting tokens on ads and nav menus."},{"title":"Structured data extraction from a webpage","prompt":"Fetch https://news.ycombinator.com and give me the page content in structured mode so I can see the stories and metadata as a clean JSON table."}],"resultDescription":"Returns a distilled representation of the webpage or HTML in the requested format (markdown, structured JSON, skeleton outline, or BM25-focused excerpt), along with an ROI proof block showing raw vs distilled token counts, compression ratio, and estimated LLM cost saved. Also includes cache status and billing confirmation.","failureModes":["URL is unreachable or returns non-200 status — endpoint may return an error status","HTML too large to process within timeout","Invalid mode enum value — defaults to markdown or returns validation error","max_tokens set below minimum of 20 — returns validation error","Missing required 'url' parameter — returns 400 bad request","Payment failure via x402 — endpoint returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need to read web content inside an LLM prompt and want to minimize token consumption. It is especially valuable when dealing with verbose HTML pages, documentation sites, or any URL where only a portion of the content is relevant to your query. The BM25 budget mode makes it uniquely suited for targeted extraction when you have a specific question about a page and a strict token ceiling. Prefer it over raw HTML fetching whenever LLM cost or context window size is a constraint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:24:21.839Z","isFirstParty":false,"canonicalSlug":"alpha-stream-agentdiet-dev-web-url-html-distiller-with-bm25-budget-6c108023"}