{"uid":"cap_Nbx4yceSt_8b3RyNgBd-l","slug":"alpha-stream-agentdiet-dev-web-url-markdown-distiller-with-bm25-f65cfb2b","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://alpha-stream.agentdiet.dev/v1/markdown-distill)","url":"https://alpha-stream.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_ycvSZZTH8U2S6ryTqCWhR","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 markdown, structured JSON, skeleton outline, or BM25-focused token budget excerpt","exampleAgentPrompt":"Distill the content at https://stripe.com/docs/payments into clean markdown and tell me how many tokens you saved compared to the raw page.","exampleUseCases":[{"title":"Token-budget research on competitor docs","prompt":"Fetch https://docs.openai.com/api-reference and distill it in budget mode with the query 'rate limits' and a max of 500 tokens so I can fit it into my context window."},{"title":"Structured data extraction from a product page","prompt":"Pull the content from https://news.ycombinator.com and give it to me in structured mode so I get the tables and metadata in clean JSON."},{"title":"Skeleton outline before deep reading","prompt":"Grab https://en.wikipedia.org/wiki/Large_language_model and give me just the skeleton outline so I can see the high-level structure before I decide which sections to read in full."}],"resultDescription":"Returns a distilled representation of the webpage in the requested mode (markdown text, structured JSON with tables and metadata, skeleton outline, or BM25-focused token excerpt), along with ROI proof metrics including raw token count, distilled token count, tokens saved, compression ratio percentage, and estimated LLM cost saved in USD. Also includes optional billing and cache hit/miss status.","failureModes":["URL is unreachable or returns non-200 status — distillation fails with fetch error","max_tokens set below minimum of 20 — request rejected","mode=budget used without a query parameter — BM25 ranking cannot be applied","Raw HTML provided via html param is malformed — parser may produce empty or garbled output","Payment not settled via x402 — endpoint returns HTTP 402 before processing"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read or process web content but must stay within a token budget — especially for LLM pipelines where full HTML would be prohibitively expensive. It is superior to raw HTML fetching when you need clean markdown, structured extraction, or BM25-ranked excerpt in a single call with built-in ROI metrics. Prefer over generic scrapers when you need token-aware compression with quantified savings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:23:37.936Z","isFirstParty":false,"canonicalSlug":"alpha-stream-agentdiet-dev-web-url-markdown-distiller-with-bm25-f65cfb2b"}