{"uid":"cap_qCWvzekpqbze-GjJv6oJi","slug":"sec-intel-agentdiet-dev-web-content-distiller-with-bm25-budget-control-8743cab9","name":"Web Content 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://sec-intel.agentdiet.dev/v1/docs-to-markdown)","url":"https://sec-intel.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_uUMwME0gnudELmsEW5e_C","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"sec-intel.agentdiet.dev","brandSlug":"sec-intel-agentdiet-dev-mpp","brandBaseUrl":"https://sec-intel.agentdiet.dev","brandDocsUrl":null,"whatItDoes":"Fetches and converts a URL or raw HTML into compressed Markdown, structured JSON, skeleton outlines, or BM25-focused budget excerpts with token savings tracking","exampleAgentPrompt":"Fetch the Stripe documentation page at https://stripe.com/docs/payments and distill it into markdown with a 2000-token budget focused on the query 'payment intents API'.","exampleUseCases":[{"title":"Compress docs page for LLM context","prompt":"Take the OpenAI API reference page at https://platform.openai.com/docs/api-reference and distill it down to markdown, keeping it under 1500 tokens and focusing on 'function calling'."},{"title":"Extract structured data from e-commerce page","prompt":"Pull the product listing page at https://example-shop.com/products and distill it in structured mode so I get a clean JSON table of the products, prices, and availability."},{"title":"Skeleton outline of a long article","prompt":"Grab the article at https://techcrunch.com/2024/05/01/ai-agents-explainer and give me just the skeleton outline so I can see the section headings without all the body text."}],"resultDescription":"Returns a JSON object containing: distilled content in the requested format (Markdown, structured JSON, skeleton, or BM25 excerpt) under the 'data' key; an 'roi_proof' object showing raw vs distilled token counts, tokens saved, compression ratio percentage, ROI multiplier, and estimated LLM cost savings in USD; optional cache hit/miss status with latency; and billing details including fee charged.","failureModes":["URL is unreachable or returns non-200 status — endpoint may return an error status","HTML is malformed or too large to process within constraints","max_tokens ceiling is set too low to return meaningful content","BM25 query in budget mode finds no relevant passages — returns minimal excerpt","Missing required 'url' field returns validation error","Paywalled or JavaScript-rendered pages may yield empty or incomplete HTML"],"whenToPreferThis":"Choose this endpoint when you need to reduce token consumption before feeding web content to an LLM, especially when working with large documentation pages, articles, or HTML blobs. The BM25 budget mode is uniquely valuable when you want only the most query-relevant passages within a strict token ceiling — no other generic scraper offers this combination. Prefer it over raw fetch-and-parse approaches when LLM cost savings and compression metrics matter to your workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T06:31:01.737Z","isFirstParty":false,"canonicalSlug":"sec-intel-agentdiet-dev-web-content-distiller-with-bm25-budget-control-8743cab9"}