{"uid":"cap_nO-oshTZA5UuSDmtK6rXZ","slug":"mesh-agentdiet-dev-url-to-markdown-web-distiller-c36cac5b","name":"URL to Markdown Web 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/url-to-markdown)","url":"https://mesh.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_QrN4smxmyWsIyZy8FjymV","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 webpage (or accepts raw HTML) and distills it into compact, agent-ready Markdown, structured JSON, skeleton outline, or BM25-focused budget excerpt with token savings reporting","exampleAgentPrompt":"Can you fetch https://stripe.com/docs/payments and distill it into compact markdown — use budget mode with a focus on 'payment intents' and keep it under 500 tokens?","exampleUseCases":[{"title":"Research doc compression for agent","prompt":"Fetch https://docs.openai.com/api-reference and distill it into structured JSON tables so I can query the API reference without blowing my token budget."},{"title":"Focused Q&A grounding from live page","prompt":"Grab https://en.wikipedia.org/wiki/Transformer_(deep_learning_architecture) and extract just the content relevant to 'attention mechanism' in budget mode with a max of 300 tokens."},{"title":"Skeleton outline of a long article","prompt":"Distill https://www.paulgraham.com/startupideas.html into a skeleton outline so I can see the high-level structure of the essay without reading the whole thing."}],"resultDescription":"Returns a distilled representation of the target webpage in the requested mode (Markdown, structured JSON, skeleton, or BM25 budget excerpt), along with ROI metadata including 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":["URL unreachable or returns non-200 status — endpoint may return an error status","URL points to a non-HTML resource (PDF, binary) — distillation may fail or return empty","max_tokens set too low for meaningful extraction — truncated or empty budget excerpt","BM25 query does not match any content on the page — sparse or empty result","Raw HTML input is malformed — distillation quality may degrade","Payment not authorized — 402 response with payment required details"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read and act on live web content but wants to minimize LLM token consumption. It is especially valuable when the target page is verbose and only a focused subset of content is needed (use budget mode with a BM25 query). Prefer it over generic web scrapers when you need built-in token budgeting, compression metrics, and structured output modes in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T15:01:51.127Z","isFirstParty":false,"canonicalSlug":"mesh-agentdiet-dev-url-to-markdown-web-distiller-c36cac5b"}