{"uid":"cap_E_3DN5_xnH4v4q9Ojf2hs","slug":"mesh-agentdiet-dev-web-url-to-compact-markdown-distiller-efb3a24a","name":"Web URL to Compact Markdown Distiller","description":"Distill a URL or raw HTML payload with BM25 budget control (Live x402 v2, IETF MPP & MCP endpoint at https://mesh.agentdiet.dev/v1/html-to-markdown)","url":"https://mesh.agentdiet.dev/v1/html-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_xhHhdMYlxZN15KHwsC1eN","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"mesh.agentdiet.dev","brandSlug":"mesh-agentdiet-dev-mpp","brandBaseUrl":"https://mesh.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a URL or raw HTML and distills it into compact, agent-ready Markdown or structured data with optional BM25 token-budget control","exampleAgentPrompt":"Can you fetch https://stripe.com/docs/payments and distill it into compact markdown, keeping it under 2000 tokens and focused on the topic 'payment intents'?","exampleUseCases":[{"title":"Research article extraction for agent","prompt":"Pull the content from https://news.ycombinator.com and distill it into clean markdown so I can read just the headlines and links without all the HTML noise."},{"title":"Budget-capped context for LLM pipeline","prompt":"Fetch https://docs.openai.com/api-reference and give me a BM25-filtered excerpt focused on 'function calling', keeping the output under 1500 tokens so it fits in my prompt."},{"title":"Structured data extraction from product page","prompt":"Distill https://www.apple.com/iphone/ in structured mode so I get the key tables and metadata in JSON format rather than raw markdown."}],"resultDescription":"Returns a 'data' object containing distilled content (Markdown text, structured JSON tables/metadata, skeleton outline, or BM25-filtered excerpt depending on mode), plus an 'roi_proof' object showing raw token count, distilled token count, tokens saved, compression ratio percentage, and estimated LLM cost saved in USD. Also includes cache hit/miss status and billing details.","failureModes":["Invalid or unreachable URL returns an error status","URL blocks crawlers or returns non-HTML content (e.g. PDF, binary)","max_tokens set below minimum of 20 returns validation error","mode=budget without a query may produce unfiltered output","Rate limiting or payment failure (x402) blocks the request","Very large pages may exceed processing limits even with budget mode"],"whenToPreferThis":"Choose this endpoint when you need to convert a live webpage or raw HTML into compact, LLM-friendly content while minimizing token consumption. It is ideal when you want BM25-based relevance filtering to extract only the parts of a page relevant to a specific query, or when you need structured extraction (tables, metadata) rather than raw text. Prefer it over generic scraping tools when token budget control and compression ratio reporting matter for cost-sensitive LLM pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:47:57.716Z","isFirstParty":false,"canonicalSlug":"mesh-agentdiet-dev-web-url-to-compact-markdown-distiller-efb3a24a"}