{"uid":"cap_G5VstnjoyUirzK1AjmouZ","slug":"prompt-guard-agentdiet-dev-web-page-html-distillation-with-bm25-6e33fc8e","name":"Web Page & HTML Distillation 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/docs-to-markdown)","url":"https://prompt-guard.agentdiet.dev/v1/docs-to-markdown?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_Prvq2CGbazZO_xkNye1dd","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 a URL or accepts raw HTML and distills it into Markdown, structured JSON, a skeleton outline, or a BM25-ranked token-budgeted excerpt optimized for LLM consumption.","exampleAgentPrompt":"Fetch the Stripe docs page at https://stripe.com/docs/api/charges and distill it into markdown, keeping it under 800 tokens and focused on the query 'charge creation parameters' — use budget mode.","exampleUseCases":[{"title":"LLM-ready documentation page extraction","prompt":"Grab the content from https://docs.openai.com/api-reference and convert it to clean markdown so I can feed it into my LLM without all the HTML noise."},{"title":"Token-budgeted focused content retrieval","prompt":"Pull the page at https://stripe.com/docs/webhooks and extract only the parts relevant to 'signature verification' — keep it under 600 tokens using budget mode."},{"title":"Raw HTML cleanup for agent pipeline","prompt":"I have some raw HTML from a scraped product page — can you distill it into structured JSON tables so I can extract the pricing and specs cleanly?"}],"resultDescription":"Returns a JSON object with a 'data' field containing the distilled content (Markdown string, structured JSON tables/metadata, skeleton outline, or BM25-ranked excerpt depending on mode), plus an 'roi_proof' object showing raw_tokens, distilled_tokens, tokens_saved, compression_ratio_pct, and llm_cost_saved_usd. Also includes optional cache hit/miss status and billing details.","failureModes":["URL is unreachable or returns non-200 HTTP — endpoint may return an error status","HTML payload too large to process within token constraints","BM25 query yields no relevant passages, returning minimal or empty excerpt","Invalid mode enum value causes a 422 validation error","max_tokens set too low (below 20) triggers minimum constraint error","Payment not provided or insufficient — HTTP 402 returned requiring x402 USDC payment"],"whenToPreferThis":"Choose this endpoint when you need to feed live web content or raw HTML to an LLM and want to minimize token usage and cost. It is especially valuable when working with large documentation pages, e-commerce catalogs, or arbitrary URLs where boilerplate removal and BM25-focused budgeting are needed. Prefer it over generic scraping tools when token economy and structured output (Markdown, JSON tables, skeleton) matter, or when you need provable ROI metrics on compression.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T06:34:40.204Z","isFirstParty":false,"canonicalSlug":"prompt-guard-agentdiet-dev-web-page-html-distillation-with-bm25-6e33fc8e"}