{"uid":"cap_HyZuQJFA51Bgk5xMLG0u8","slug":"github-audit-agentdiet-dev-web-url-markdown-distiller-with-bm25-9be89dcc","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://github-audit.agentdiet.dev/v1/markdown-distill)","url":"https://github-audit.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_yjX-hN8_PktnNyYrp6rNN","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"github-audit.agentdiet.dev","brandSlug":"github-audit-agentdiet-dev-mpp","brandBaseUrl":"https://github-audit.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 token budget excerpts","exampleAgentPrompt":"Distill the content at https://stripe.com/docs/payments into compact markdown using budget mode, focused on 'payment intents', and keep it under 500 tokens.","exampleUseCases":[{"title":"Token-efficient doc reading for agents","prompt":"Fetch https://docs.openai.com/api-reference and distill it in budget mode with the query 'embeddings API' and a max of 300 tokens so I don't burn through my context window."},{"title":"Structured data extraction from a webpage","prompt":"Pull the page at https://en.wikipedia.org/wiki/Large_language_model and convert it to structured mode so I get the tables and metadata as JSON."},{"title":"Skeleton outline of a long article","prompt":"Give me a skeleton outline of https://www.nytimes.com/2024/01/15/technology/ai-agents.html — I just want the headings and section structure, not the full content."}],"resultDescription":"Returns a JSON object containing the distilled content (Markdown text, structured JSON, skeleton headings, or BM25-ranked excerpt depending on mode), along with ROI proof metrics (raw token count, distilled token count, tokens saved, compression ratio, estimated LLM cost saved), cache status (HIT/MISS), and billing details.","failureModes":["Invalid or unreachable URL returns an error status","Pages behind authentication or paywalls may return incomplete or empty content","Very large HTML payloads may exceed processing limits","max_tokens set too low may produce truncated or unusable output","BM25 query with no matching content may return minimal or empty excerpt","Payment failure (HTTP 402) if x402 micropayment is not properly configured"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to read a webpage but must conserve context window tokens or LLM costs. It is especially useful when the target page is long or noisy, and the agent only needs the relevant portion (use budget+query mode). Prefer this over raw HTTP fetching when structured extraction (tables, metadata) or outline-only views are needed. Also ideal when you have raw HTML already and want to avoid re-fetching.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T15:01:51.310Z","isFirstParty":false,"canonicalSlug":"github-audit-agentdiet-dev-web-url-markdown-distiller-with-bm25-9be89dcc"}