{"uid":"cap_Mj2mxlEtxFRZRUlwpHoZ_","slug":"llms-generator-agentdiet-dev-url-to-markdown-web-distiller-with-bm25-82061951","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://llms-generator.agentdiet.dev/v1/url-to-markdown)","url":"https://llms-generator.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_skJQ-P-J5p0vWCweQBTNs","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"llms-generator.agentdiet.dev","brandSlug":"llms-generator-agentdiet-dev-mpp","brandBaseUrl":"https://llms-generator.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a URL or raw HTML and converts it into compact, token-efficient Markdown or structured data using configurable distillation modes and optional BM25-based budget trimming","exampleAgentPrompt":"Can you fetch https://stripe.com/docs/payments and distill it into compact markdown using budget mode, focused on 'payment intents', keeping it under 500 tokens?","exampleUseCases":[{"title":"Research page distillation for agent","prompt":"Pull down https://en.wikipedia.org/wiki/Transformer_(deep_learning_architecture) and convert it to clean markdown in structured mode so I can pass it to my agent without blowing my token budget."},{"title":"Token-budgeted competitor analysis","prompt":"Fetch https://openai.com/pricing and give me a BM25-focused excerpt about 'API pricing tiers' — keep it under 300 tokens."},{"title":"Stripe docs ingestion for coding agent","prompt":"Distill the Stripe docs into skeleton mode using the builtin://stripe-docs source so my coding agent gets a quick outline of available API endpoints without reading the whole thing."}],"resultDescription":"Returns a JSON object with a 'data' field containing the distilled content (Markdown text, structured JSON tables, skeleton outline, or BM25-focused excerpt depending on mode), plus an 'roi_proof' object showing raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, roi_multiplier, and llm_cost_saved_usd. Also includes cache status (HIT/MISS), billing details, and execution status.","failureModes":["Invalid or unreachable URL returns an error status","max_tokens set below minimum of 20 causes validation failure","BM25 query with no relevant content match may return minimal excerpt","Raw HTML too large may exceed processing limits","Missing required 'url' parameter returns 400-level error","Rate limiting or payment failure via x402 may block the request"],"whenToPreferThis":"Choose this endpoint when you need to feed web content into an LLM pipeline and want to minimize token usage. It is especially valuable when the target page is large or noisy, when you have a strict token budget (use budget mode with max_tokens), or when you want to focus only on query-relevant passages (BM25 mode). Prefer it over raw HTTP fetch when compression ratio and cost savings matter. Use structured or skeleton mode when you need machine-parseable tables or a quick outline rather than full prose.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T07:50:05.714Z","isFirstParty":false,"canonicalSlug":"llms-generator-agentdiet-dev-url-to-markdown-web-distiller-with-bm25-82061951"}