{"uid":"cap_59tt_U_Y8HGLLcdKDjPoV","slug":"prompt-guard-agentdiet-dev-webpage-distiller-with-bm25-budget-control-2bb4ef23","name":"Webpage 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://prompt-guard.agentdiet.dev/v1/webpage-distiller)","url":"https://prompt-guard.agentdiet.dev/v1/webpage-distiller?utm_source=zero.xyz","method":"POST","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_QsoqKs0uucbLtIGmaNkO5","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"prompt-guard.agentdiet.dev","brandSlug":"prompt-guard-agentdiet-dev-mpp","brandBaseUrl":"https://prompt-guard.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and distills a URL or raw HTML into Markdown, structured JSON, skeleton outline, or a BM25-ranked token-budgeted excerpt","exampleAgentPrompt":"Distill the content at https://stripe.com/docs/payments into clean markdown and keep it under 800 tokens, focusing on the topic 'payment intents'.","exampleUseCases":[{"title":"Token-budgeted research assistant","prompt":"Fetch https://en.wikipedia.org/wiki/Transformer_(machine_learning_model) and give me only the parts relevant to 'attention mechanism' — keep it under 500 tokens so I don't blow my context window."},{"title":"Structured product data extraction","prompt":"Pull the page at https://www.apple.com/iphone/ and distill it into structured JSON tables with pricing, variants, and product metadata."},{"title":"Lightweight page skeleton for navigation","prompt":"Give me a skeleton outline of https://docs.openai.com/api-reference so I can understand the top-level structure without reading the whole thing."}],"resultDescription":"Returns a 'data' object containing the distilled content in the requested mode (Markdown text, structured JSON tables/metadata, skeleton outline, or BM25-ranked excerpt), plus an 'roi_proof' object showing raw vs distilled token counts, compression ratio, tokens saved, and estimated LLM cost saved in USD. Also includes optional cache hit/miss status and billing details.","failureModes":["URL is unreachable or returns non-200 — endpoint may return an error status","Malformed or empty HTML input with no extractable content","Token budget too small (below minimum of 20) — rejected by schema validation","BM25 query provided but mode is not 'budget' — query may be ignored","Rate limiting or payment failure via x402 — 402 response if payment not settled","Paywalled or JavaScript-rendered pages may return incomplete distillation"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to ingest webpage content while staying within strict token budgets, or when you need BM25-ranked extraction to surface only query-relevant content from a large page. Prefer it over generic scrapers when you need compression ROI metrics to justify context cost, or when you need structured JSON or skeleton output modes rather than raw HTML. Ideal for LLM pipelines where context length and cost are primary constraints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T06:32:38.004Z","isFirstParty":false,"canonicalSlug":"prompt-guard-agentdiet-dev-webpage-distiller-with-bm25-budget-control-2bb4ef23"}