{"uid":"cap_XTgOHfMUhWPnHk93xe8Mh","slug":"workflows-agentdiet-dev-agentdiet-html-to-markdown-web-distiller-b1da4671","name":"AgentDiet HTML-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://workflows.agentdiet.dev/v1/html-to-markdown)","url":"https://workflows.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_6i3YaJWIe3qKOm5emjf5S","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"workflows.agentdiet.dev","brandSlug":"workflows-agentdiet-dev-mpp","brandBaseUrl":"https://workflows.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a webpage by URL (or accepts raw HTML) and distills it into compact Markdown, structured JSON, skeleton outline, or BM25-budgeted excerpts for token-efficient agent consumption","exampleAgentPrompt":"Can you fetch https://stripe.com/docs/payments and distill it into compact markdown, keeping it under 2000 tokens — use budget mode focused on the query 'payment intents'?","exampleUseCases":[{"title":"Token-budget research on pricing pages","prompt":"Grab the pricing page at https://openai.com/pricing and distill it in budget mode with the query 'API pricing tiers', capped at 1500 tokens — I want just the parts relevant to cost."},{"title":"Structured extraction from a product page","prompt":"Fetch https://www.shopify.com/plus and convert it into structured mode so I get the tables and metadata as JSON instead of raw HTML."},{"title":"Skeleton outline of documentation","prompt":"Pull https://docs.github.com/en/actions and give me a skeleton outline so I can see the high-level structure of the docs without loading all the content."}],"resultDescription":"Returns a JSON object with a 'data' field containing the distilled content (Markdown text, structured JSON tables/metadata, skeleton outline, or BM25-focused excerpt depending on mode), plus an 'roi_proof' object showing raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, and llm_cost_saved_usd. Also includes optional cache status (HIT/MISS) and billing details.","failureModes":["URL is unreachable or returns non-200 — endpoint may return an error status","Paywalled or JavaScript-heavy pages may yield sparse or empty content","Token budget too low (min 20) causes truncated or empty results","Invalid mode enum value causes bad request","Missing required 'url' parameter returns validation error","Rate limiting or payment failure via x402 if USDC balance insufficient"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read web content without blowing its context window — especially when token cost matters. It is distinctly useful over raw fetch because it provides compression ratio proof, multiple distillation modes (markdown, structured, skeleton, budget), and BM25 relevance filtering. Prefer it over generic scrapers when you need quantified token savings, structured JSON output from messy HTML, or strict token ceiling enforcement for a specific query focus.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T15:01:49.330Z","isFirstParty":false,"canonicalSlug":"workflows-agentdiet-dev-agentdiet-html-to-markdown-web-distiller-b1da4671"}