{"uid":"cap_O4SBrOv3RCu_maoF6cdyJ","slug":"cve-intel-agentdiet-dev-url-to-markdown-web-distiller-with-bm25-aaadcb4d","name":"URL to Markdown Web 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://cve-intel.agentdiet.dev/v1/url-to-markdown)","url":"https://cve-intel.agentdiet.dev/v1/url-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_xlaDIn7TIdaya8OunWoHO","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"cve-intel.agentdiet.dev","brandSlug":"cve-intel-agentdiet-dev-mpp","brandBaseUrl":"https://cve-intel.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a webpage by URL (or accepts raw HTML) and distills it into compact, token-efficient markdown, structured data, skeleton outline, or BM25-focused excerpt with configurable token budget ceiling.","exampleAgentPrompt":"Can you fetch https://stripe.com/docs/payments and distill it into compact markdown, keeping it under 2000 tokens and focusing on the query 'payment intents'?","exampleUseCases":[{"title":"Summarize documentation for agent context","prompt":"Grab the Stripe docs page at https://stripe.com/docs/api and distill it into markdown under 1500 tokens so I can feed it to my agent without blowing the context window."},{"title":"Extract structured data from a news article","prompt":"Fetch https://techcrunch.com/2025/01/15/openai-news/ and convert it to structured JSON tables and metadata so I can parse the key facts programmatically."},{"title":"Focus on relevant content using BM25 query","prompt":"Go to https://docs.python.org/3/library/asyncio.html and give me only the parts relevant to 'event loop lifecycle' using budget mode, capped at 800 tokens."}],"resultDescription":"Returns a JSON object with 'data' containing the distilled content (markdown text, structured JSON, skeleton outline, or BM25-focused excerpt depending on mode), an 'roi_proof' object showing raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, and llm_cost_saved_usd, a 'cache' object indicating HIT or MISS with latency, and a 'billing' object with the fee charged in USD.","failureModes":["Invalid or unreachable URL returns an error status","Token budget too low (below 20) is rejected by schema validation","Private/blocked URLs (firewalled or login-gated) may return empty or partial content","Raw HTML input malformed may yield poor distillation quality","Rate limiting or payment failure (x402) blocks the request","Unsupported mode value returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need to reduce the token footprint of a webpage before passing it to an LLM, especially when working with large documentation pages, news articles, or any public URL where token cost is a concern. Prefer budget mode with a BM25 query when only a portion of the page is relevant to your task. Use structured mode when you need parseable tables or metadata rather than prose. This is especially useful for agents that routinely access web content and need predictable, budget-controlled context injection.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:51:33.179Z","isFirstParty":false,"canonicalSlug":"cve-intel-agentdiet-dev-url-to-markdown-web-distiller-with-bm25-aaadcb4d"}