{"uid":"cap_wENGxuLCUZEjed5W4Fa3U","slug":"alpha-stream-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-4ba70b4e","name":"Web URL to 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/docs-to-markdown)","url":"https://alpha-stream.agentdiet.dev/v1/docs-to-markdown?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_cyHjw6Km16JADCS-j5C54","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-budgeted excerpts","exampleAgentPrompt":"Grab the Stripe docs page at https://stripe.com/docs/api/charges and distill it into clean markdown, keeping it under 2000 tokens and focusing on the 'create a charge' content.","exampleUseCases":[{"title":"Distill API docs for agent context","prompt":"Pull the OpenAI API reference at https://platform.openai.com/docs/api-reference and distill it into compact markdown so I can feed it into my agent without blowing up the context window."},{"title":"Budget-aware research page extraction","prompt":"Fetch https://en.wikipedia.org/wiki/Transformer_(machine_learning_model) and give me only the most relevant content about the attention mechanism, keeping it under 1500 tokens — use budget mode with that as the focus query."},{"title":"Structured data extraction from a product page","prompt":"Distill https://docs.anthropic.com/claude/reference/getting-started-with-the-api into structured JSON tables so I can programmatically read the model names and pricing from it."}],"resultDescription":"Returns a JSON object containing the distilled content (Markdown, structured JSON tables/metadata, skeleton outline, or BM25-focused excerpt depending on mode), plus ROI proof metrics showing raw vs. distilled token counts, tokens saved, compression ratio percentage, estimated LLM cost savings, and optional cache status and billing details.","failureModes":["Invalid or unreachable URL returns an error status","URL blocked by robots.txt or CORS restrictions causes fetch failure","max_tokens set too low may produce severely truncated output","BM25 query mode without a query string may fall back to full markdown","Raw HTML too large may exceed processing limits","Payment not completed (HTTP 402) if x402 micropayment is not handled"],"whenToPreferThis":"Choose this endpoint when you need to feed web content into an LLM context window efficiently and want automatic token compression with measurable ROI. Ideal for agent pipelines that need to stay within token budgets, or when you want to extract structured data or a skeleton outline from a page rather than raw HTML. Particularly valuable when working with large documentation pages, research articles, or any URL where boilerplate and navigation noise would otherwise waste tokens. Use the budget mode with a query when you need BM25-ranked relevance filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:21:33.111Z","isFirstParty":false,"canonicalSlug":"alpha-stream-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-4ba70b4e"}