{"uid":"cap_ui95owX4L9ghKqu7haLVM","slug":"defi-yield-agentdiet-dev-web-url-markdown-distiller-with-bm25-budget-27878e23","name":"Web URL 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://defi-yield.agentdiet.dev/v1/markdown-distill)","url":"https://defi-yield.agentdiet.dev/v1/markdown-distill?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_j8K40rTw2E7bH-SUYUgAS","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"defi-yield.agentdiet.dev","brandSlug":"defi-yield-agentdiet-dev-mpp","brandBaseUrl":"https://defi-yield.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches a URL or raw HTML and distills it into compact, agent-ready Markdown, structured JSON, skeleton outline, or BM25-focused budget excerpt with token savings metrics","exampleAgentPrompt":"Distill https://stripe.com/docs/payments into compact markdown, use budget mode with a max of 2000 tokens and focus the BM25 query on 'payment intents API'.","exampleUseCases":[{"title":"Token-budget research on competitor pricing page","prompt":"Fetch and distill https://openai.com/pricing into budget mode, keep it under 1500 tokens, and focus the BM25 query on 'API pricing per token' so I can compare costs without burning my context window."},{"title":"Structured table extraction from financial report","prompt":"Pull the structured data out of https://investor.apple.com/sec-filings/annual-reports — I need it in structured mode so I get the tables and metadata cleanly formatted for my analysis."},{"title":"Skeleton outline of long documentation page","prompt":"Give me a skeleton outline of https://docs.aws.amazon.com/lambda/latest/dg/welcome.html so I can see the high-level structure of the Lambda docs without reading the whole thing."}],"resultDescription":"Returns a JSON object containing the distilled content in the requested mode (Markdown text, structured JSON tables/metadata, skeleton outline, or BM25-focused excerpt), plus an roi_proof block with raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, and llm_cost_saved_usd. Also includes cache status (HIT/MISS) and billing details.","failureModes":["Invalid or unreachable URL returns an error status","Target page blocks crawlers or requires JavaScript rendering, yielding incomplete content","max_tokens set too low may truncate critical content","BM25 query with no matching terms in budget mode may return minimal output","Raw HTML input that is malformed may produce poor distillation quality","Rate limiting or payment failure via x402 may block the request"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read a web page but must minimize token consumption before passing content to an LLM. It is ideal for agentic pipelines that fetch external URLs, research tasks with tight context windows, or any workflow where LLM cost per page matters. The BM25 budget mode makes it uniquely suited when you have a specific query focus and a strict token ceiling — unlike generic scrapers that return full raw HTML or uncompressed markdown.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:51:18.348Z","isFirstParty":false,"canonicalSlug":"defi-yield-agentdiet-dev-web-url-markdown-distiller-with-bm25-budget-27878e23"}