{"uid":"cap_aFhyn2fpTUSiWyFMhY-qa","slug":"json-repair-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-5a045dbc","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://json-repair.agentdiet.dev/v1/html-to-markdown)","url":"https://json-repair.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_cEGItTbmeUgAANR7DHSCH","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"json-repair.agentdiet.dev","brandSlug":"json-repair-agentdiet-dev-mpp","brandBaseUrl":"https://json-repair.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a webpage or raw HTML and distills it into compact, agent-ready Markdown or structured output with configurable token budgets and BM25 relevance filtering","exampleAgentPrompt":"Fetch https://stripe.com/docs/payments and distill it into compact Markdown using budget mode, focused on 'payment intents', with a max of 800 tokens.","exampleUseCases":[{"title":"Research assistant reading documentation","prompt":"Pull the content from https://docs.openai.com/api-reference and compress it into clean Markdown in budget mode, focused on 'function calling', keeping it under 500 tokens."},{"title":"Competitive pricing page analysis","prompt":"Distill https://www.notion.so/pricing into structured tables and metadata so I can compare their plan tiers without burning through my token budget."},{"title":"News article summarization for agent briefing","prompt":"Fetch https://techcrunch.com/2024/05/01/anthropic-raises-funding/ and give me a skeleton outline of the article so I can quickly understand the structure before reading the full thing."}],"resultDescription":"Returns a JSON object containing the distilled content (Markdown text, structured JSON tables/metadata, skeleton outline, or BM25-filtered excerpt depending on mode), along with ROI proof metrics including raw token count, distilled token count, tokens saved, compression ratio percentage, and estimated LLM cost saved in USD. Also includes cache status (HIT/MISS) and billing details.","failureModes":["Invalid or unreachable URL returns an error status","HTML payload too large may be truncated or rejected","BM25 query with no matching content may return minimal excerpt","Missing required 'url' parameter returns a validation error","Payment failure via x402 blocks the request","Rate limiting if too many requests are made in quick succession"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read a webpage but must stay within a token budget, or when raw HTML is too noisy and verbose for direct LLM consumption. It is especially useful when you want relevance-filtered content via BM25 (mode=budget), structured extraction of tables and metadata, or a skeleton outline for navigation. Prefer this over raw HTTP fetch or generic scrapers when token cost reduction and agent-readiness are the primary goals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:24:27.607Z","isFirstParty":false,"canonicalSlug":"json-repair-agentdiet-dev-web-url-to-markdown-distiller-with-bm25-5a045dbc"}